Geo Community listing

HERE Network Positioning API v2

Positioning API accepts requests with radio network measurements and replies with corresponding location estimate. For more details and examples, see Developer's Guide.

https://positioning.hereapi.com/v23 endpointsapiKey authno ratings yet100.0% uptime

Bring your own key. This API needs your own HERE Network Positioning API v2 key - get one from the provider, add it once below, and the proxy injects it on every call. Your OmniStream plan covers the unified SDK, key storage, and proxy - the provider's own rate limits still apply to your key.

This is a community listing. If you own this API, you can request ownership.

Install the SDK

npm install omnistream-sdk

import { OmniClient } from "omnistream-sdk";

const omni = new OmniClient({ token: process.env.OMNI_KEY! });

// One key reaches every API on the marketplace.
const data = await omni.call("here/getHealth");

One install, one key - the same client calls every API on the marketplace.

Try it

Try itone Omni key, every API

Your Omni key

GET/health

3 endpoints

GET/health

Service health

POST/locate

Location query

confidenceContent-EncodingfallbackdesiredX-Request-IDrequired

GET/version

API version

Typed client (copy, no install)

here.ts

/**
 * HERENetworkPositioningAPIv2 - generated by OmniStream from HERE Network Positioning API v2's OpenAPI spec.
 * One typed method per endpoint. A single Omni key reaches the API.
 */
const DEFAULT_BASE = "https://grid.skinvaults.online/v1/proxy/here";

export class HERENetworkPositioningAPIv2Error extends Error {
  status: number;
  code?: string;
  constructor(status: number, code: string | undefined, message?: string) {
    super(message || `HERENetworkPositioningAPIv2 error ${status}`);
    this.name = "HERENetworkPositioningAPIv2Error";
    this.status = status;
    this.code = code;
  }
}

export interface HERENetworkPositioningAPIv2Options {
  baseUrl?: string;
  fetch?: typeof fetch;
  timeoutMs?: number;
}

export class HERENetworkPositioningAPIv2 {
  /** @param token Your OmniStream key (one key for every API). */
  constructor(private token: string, private opts: HERENetworkPositioningAPIv2Options = {}) {
    if (!token) throw new Error("HERENetworkPositioningAPIv2: token is required");
  }
  rateLimit: { remainingMinute?: number; remainingDay?: number } | null = null;

  private async _request(method: string, path: string, { params, body }: { params?: Record<string, unknown>; body?: unknown } = {}): Promise<any> {
    const f = this.opts.fetch ?? globalThis.fetch;
    const url = new URL((this.opts.baseUrl ?? DEFAULT_BASE).replace(/\/+$/, "") + path);
    if (params) for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, String(v));
    const headers: Record<string, string> = { "x-omni-key": this.token };
    if (body !== undefined) headers["content-type"] = "application/json";
    const res = await f(url, { method, headers, body: body !== undefined ? JSON.stringify(body) : undefined });
    this.rateLimit = {
      remainingMinute: Number(res.headers.get("x-ratelimit-remaining-minute")) || undefined,
      remainingDay: Number(res.headers.get("x-ratelimit-remaining-day")) || undefined,
    };
    const data = await res.json().catch(() => ({}));
    if (!res.ok) throw new HERENetworkPositioningAPIv2Error(res.status, data?.error?.code, data?.error?.message);
    return data.data ?? data;
  }

  /** Service health */
  getHealth(): Promise<any> {
    return this._request("GET", "/health", {});
  }

  /** Location query */
  postLocate(body: unknown, params: { "confidence"?: number; "Content-Encoding"?: string; "fallback"?: unknown[]; "desired"?: unknown[]; "X-Request-ID"?: string; "required"?: unknown[] }): Promise<any> {
    return this._request("POST", "/locate", { body, params });
  }

  /** API version */
  getApiVersion(): Promise<any> {
    return this._request("GET", "/version", {});
  }
}

export default HERENetworkPositioningAPIv2;

Reviews

No reviews yet. Be the first to rate this API.

Frequently asked questions

Do I need an API key to use HERE Network Positioning API v2?

Yes. HERE Network Positioning API v2 uses apiKey authentication, so you bring your own key from the provider. You store it once on OmniStream and the proxy injects it into every call, so your code only ever sends your Omni key.

What can you do with the HERE Network Positioning API v2 API?

Positioning API accepts requests with radio network measurements and replies with corresponding location estimate. For more details and examples, see Developer's Guide. It exposes 3 endpoints over GET, POST, including GET /health, POST /locate, GET /version.

How do I call HERE Network Positioning API v2 from Python, TypeScript, Rust or Go?

Install the OmniStream SDK for your language and call HERE Network Positioning API v2 through it. The client is generated from this API's OpenAPI spec, so parameters and responses are fully typed, and the same client also calls every other API in the marketplace.

Is HERE Network Positioning API v2 free to use on OmniStream?

You can start on the free plan. OmniStream charges for the unified SDK, key storage and proxy rather than for HERE Network Positioning API v2 itself, and HERE Network Positioning API v2's own rate limits still apply to your provider key.