中立的なサーバーデータを取得します

マーケットプレイスプロバイダとライセンス契約を締結し、ニュートラルサーバーデータにサブスクライブすると、ニュートラルサーバーコンテナデータにアクセスできます。 中立的なサーバーコンテナは、マーケットプレイスプロバイダによって提供され、マーケットプレイスのコンシューマが HERE platform 経由で一覧表形式で利用できるデータ ( リソース ) のセットです。

続行するには、 HERE platform アカウントが必要です。 アカウントを持っていない場合 は、組織の HERE platform 管理者に連絡し、「グループの追加と管理」で説明されているように、 HERE platform への招待をリクエストしてください。

アプリ資格情報を入手します

アプリケーションで HERE platform データにアクセスするには、アプリを登録し、 ID と資格情報を生成します。

アプリケーションを登録してアプリ資格情報を生成する方法の詳細について は、「アプリを管理する」を参照してください。

アプリケーションが登録されたら、組織の HERE platform グループを管理するユーザーにアプリ ID を提供します。 そのユーザーは、必要なカタログへのアクセスを許可するアプリ ID を HERE Platform Group に追加する必要があります。 詳細について は、「グループの追加と管理」を参照してください。

アプリおよび関連付けられている資格情報は、ユーザー権限またはグループメンバーシップを継承しません。 データにアクセスするには、ユーザーまたはアプリがコンシューマー管理グループのメンバーである必要があります。 管理者に連絡してアプリをグループに追加し、 HERE platform リソースへのアクセス権を付与してください。

また、アクセス権を取得して承諾リクエストのステータスを確認するには、承認トークンが必要です。

トークンリクエストの管理を支援するために、 HERE では Authorization 、 Authentication 、および Accounting SDK が提供されています。 この SDK には、トークンのリクエストに使用できるサンプルアプリケーションが含まれています。 承認、認証、アカウンティングの SDK に は、 GitHub アカウントからアクセスできます。 サンプルアプリケーションのコンパイルと実行については、 GitHub レポジトリの README を参照してください。

コンテナリソースを取得します

中立サーバーの API リクエストには、マーケットプレイスのサブスクリプションページでマーケットプレイスのコンシューマーが利用できる次のパラメータが含まれています。

  • (1) プロバイダ HERE リソースネーム - マーケットプレイスプロバイダの HERE リソース番号( HERE リソースネーム )。 たとえば、 hrn:here:neutral::olp-here-ns-realm:provider_idです。
  • (2) Container ID - マーケットプレイスプロバイダのコンテナの識別子。
  • (3) 承諾リクエスト ID - 承諾リクエストの作成後に取得した URL の末尾の識別子。 たとえば、 AG847633です。
プロバイダ HERE リソースネーム 、コンテナ ID 、および承諾リクエスト ID が記載された承諾リクエストページ
図 1. プロバイダ HERE リソースネーム 、コンテナ ID 、および承諾リクエスト ID が記載された承諾リクエストページ

コンテナリソースを取得するには、プロバイダ HERE リソースネーム 、車両 ID 、コンテナ ID 、および承諾リクエスト ID を使用して、次のリクエストを作成します。

GET /providers/{providerHrn}/vehicles/{vehicleId}/containers/{containerId}
{providerHrn}: Marketplace Provider HRN
{vehicleId}: Vehicle identification number of a car
{containerId}: Container ID
  • 車両 ID -車両 ID ナンバー (VIN) たとえば、 JH1TB2H25CC000000です。

リクエストには、次のヘッダーを付ける必要があります。

Authorization: valid HERE token of Marketplace consumer
Consent Request ID:

成功した応答の例 :

Status code 200

本文 :

{
    "distancesincestart": {
        "value": "276",
        "timestamp": 1592561349847
    },
    "odometer": {
        "value": "3005",
        "timestamp": 1592561349847
    },
    "distancesincereset": {
        "value": "1234",
        "timestamp": 1592561349847
    }
}

認証トークンが正しくない場合は、次のように応答が返されます。

Status code 403

本文 :

{
    "error":"Forbidden",
    "error_description": "These credentials do not authorize access"
}
{ 
    "title": "Request processing exception",
    "code": "E501114",
    "cause": "Data provider 'daimler' response: Resource not found",
    "action": "Modify request according to data provider requirements"
}

承諾リクエスト ID が入力されていない場合は、次の返信が届きます。

{
    "title": "Consent token not found",
    "status": 404,
    "code": "E501126",
    "cause": "Token is not provided for consent request id 'null'",
    "action": "Clarify with Consent Management team if requested vehicle id has consent",
    "correlationId": "1e5748d6-a788-4c61-bb88-78418da6e8aa"
}

特定のリソースコールの各実行は、購入済みのコールに対応します。 12 時間以内にリソースに利用できるデータがない場合、応答は空になります。 エンドポイントが HTTP ステータスコード 204 を返します。リクエストの支払いは不要です。

特定の VIN の承諾リクエストのステータスを確認する方法、および / または保留中、承認済み、取り消された承諾リクエストの数などの共通の承諾リクエストのステータスを確認 する方法の詳細については、「承諾リクエストのステータスを確認」を参照してください。

」に一致する結果は 件です

    」に一致する結果はありません