位置リクエストを作成します

HERE Network Positioning API への一般的なロケーション要求には、次の表に示す基本的な要素が含まれています。また、この要求にはリソース固有のパラメータまたはデータが含まれている場合があります。

基本的なリクエスト要素

基本 URL

https://positioning.hereapi.com/v2

https://az.positioning.hereapi.com/v2

API キー または認証トークンを使用する場合の実稼働環境。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。

パス

/locate

ポジショニングのリクエスト。

HTTPS POST のみ。リクエストの本文にデータを送信します。

API キー

&apiKey={YOUR_API_KEY}

{YOUR_API_KEY} 自分だけのものに置き換え apiKeyてください。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。

目的の出力データ

&desired=altitude

データが使用可能な場合に、サービスが応答に含める追加データフィールドのコンマ区切りのリスト。 要求されたデータが利用できない場合、応答には既定のデータフィールドのみが含まれます。

使用可能な値は次のとおりです。

• altitude - レスポンスに高度フィールドを含めるリクエスト

必要な出力データです

&required=altitude

サービス が応答に含める必要がある追加データフィールドのコンマ区切りのリスト。 要求されたデータが利用できない場合、要求は失敗します。

使用可能な値は次のとおりです。

• altitude - レスポンスに高度フィールドを含めるリクエスト

フォールバックモード

&fallback=any|area|singleWifi

セルおよび WLAN の配置に使用できるフォールバックオプション。 値areaと any はセルベースの位置合わせに適用され、値 singleWifi は WLAN ベースの位置合わせに適用されます。 これらは両方とも同じリクエストで結合できます。 既定では、セルベースの配置では、基地局レベルの位置の推定値のみが返されます。 LAC 、 RNC 、 TAC 、 NID 、または RZ の各地域に基づいて WGS-84 準拠の地理座標の位置推定を許可する場合、 fallback=area 「」設定を使用します。 fallback=any この設定を使用すると、サービスは利用可能なすべてのセルフォールバック方式を使用します。したがって、応答内の位置の推定値は、 MNC 、 SID 、または MCC レベルになります。

プライバシ上の理由から、単一の WLAN AP に基づいた正確な位置決めはできません。 fallback=singleWifi この設定を使用すると、単一の WLAN AP に基づいて、精度の低い位置を指定できます。 この場合、位置の推定の中心位置が偏差され、報告された精度の半径が大きくなります。

信頼レベル

&confidence=68

水平精度に対する信頼度の割合 ( パーセント ) 、および応答場所での高度の精度 ( 要求された場合 ) 。 指定しない場合、デフォルトは 68 です ( これは、実際の位置が位置の精度 / 不確実性の半径内にある確率が 68% に相当します。数値が大きいほど信頼度が高くなります ) 。

有効な範囲はです [50..98]。

認証トークン

HTTP ヘッダー :

Authorization: Bearer {YOUR_TOKEN}

{YOUR_TOKEN} を認証トークンに置き換えます。 使用可能な認証オプションについて は、『 Identity & Access Management 開発者ガイド』を参照してください。

コンテンツタイプ

HTTP ヘッダー :

Content-Type: application/json

必須のヘッダーです。 リクエストと応答の両方で使用されます。

コンテンツのエンコーディング

HTTP ヘッダー :

Content-Encoding: gzip

任意のヘッダー。 gzip でエンコードされた要求本文の内容を示します。

例

次に、 API キー 認証を使用する検索要求の例を示します。 リクエストのコンテンツタイプを HTTP ヘッダーに含めるようにしてください。

POST /v2/locate?apiKey={YOUR_API_KEY} HTTP/1.1
Host: positioning.hereapi.com
Content-Type: application/json

POST /v2/locate?apiKey={YOUR_API_KEY} HTTP/1.1
Host: az.positioning.hereapi.com
Content-Type: application/json

POST ボディ は次のとおりです

{
  "wlan": [
    { "mac": "A0:EC:F9:1E:32:C1" },
    { "mac": "A0:EC:F9:15:72:5E" },
    { "mac": "A0:EC:F9:15:72:5C" },
    { "mac": "A0:EC:F9:15:72:53" },
    { "mac": "A0:EC:F9:20:9D:AC" }
  ]
}

位置情報リクエストの例については、次の章を参照してください。

• セルと WLAN で位置を検索します
• GSM で位置を検索します
• LTE で位置を検索
• WCDMA で位置を検索します
• WLAN で位置を検索します

関連トピック :

• 位置特定の応答に成功しました
• 応答の検索エラー
• ID およびアクセス管理開発者ガイド。