Lookup

HERE によって認識されているすべての場所または場所オブジェクトには、場所識別子または「 ID 」があります。 HERE ID で場所を検索するため に、 API にEndpoint　/lookupが含まれています。

すべての HERE Geocoding and Search 結果は 、Endpoint　/lookupを使用して ID を介して個別に取得できます。 ただし、次の 2 つの例外があります。 chainQueryとcategoryQueryのタイプの結果は、Endpoint　autosuggestによって返されます。

たとえば、 "Flughafen Frankfurt-Hahn" の HERE ID は次のとおりです。

here:pds:place:276u0vhj-b0bace6448ae4b0fbc1d5e323998a7d2 。

このような場所の詳細を取得するには、リクエストを送信します。

GET https://lookup.search.hereapi.com/v1/
    lookup
    ?id=here:pds:place:276u0vhj-b0bace6448ae4b0fbc1d5e323998a7d2
    &apiKey={YOUR_API_KEY}

デフォルトの言語とは異なる言語でレスポンス要素を返す必要がある場合 は、langパラメータを予想される BCP 47 言語コードに設定する必要があります。

上記のリクエストに対するレスポンスには、上位の選択肢の複数のアイテムが含まれ、最も一致する可能性が低いものが含まれています。 各結果に次の高レベルの要素が提供されます。

• resultType - /discoverは、他の HERE Geocoding and Search と同様に place、address　などの複数のタイプの結果を返すことができます
• title –場所の名前など、結果の代表的な文字列。
• address - 結果の詳細なAddress
• position - 結果の代表的な地理位置 (WGS 84) 。結果をマップに表示するために使用します
• access - 結果へのアクセスの地理的位置 ( 例 : 入口 )
• id - 結果オブジェクトの識別子。 その値を使用 して、/lookup　エンドポイントを介してまったく同じオブジェクトを取得

• categories - place 結果のカテゴリ ID のリスト。

  プライマリカテゴリのフラグ primary がtrueに設定 されています。

• foodTypes - 食品の準備 / 提供のplace結果を得るためのFoodタイプ ID のリスト

  一次食品タイプのフラグ primary がに設定 trueされています。

• chains - チェーンに属するplace結果のチェーン ID のリスト
• contacts - place 結果の連絡先の詳細 ( 電話番号、 Web など ) のリスト
• openingHours - place 結果の営業時間のリスト

{
  "title": "Flughafen Frankfurt-Hahn",
  "id": "here:pds:place:276u0vhj-b0bace6448ae4b0fbc1d5e323998a7d2",
  "resultType": "place",
  "address": {
    "label": "Flughafen Frankfurt-Hahn, 55483 Lautzenhausen, Deutschland",
    "countryCode": "DEU",
    "countryName": "Deutschland",
    "stateCode": "RP",
    "state": "Rheinland-Pfalz",
    "countyCode": "SIM",
    "county": "Rhein-Hunsrück-Kreis",
    "city": "Lautzenhausen",
    "postalCode": "55483"
  },
  "position": { "lat": 49.94802, "lng": 7.27153 },
  "access": [{ "lat": 49.94571, "lng": 7.26985 }],
  "categories": [{ "id": "400-4000-4581", "name": "Flughafen", "primary": true }],
  "references": [{ "supplier": { "id": "core" }, "id": "50481441" }],
  "contacts": [
    {
      "phone": [{ "value": "+496543509200" }],
      "www": [{ "value": "http://www.hahn-airport.de" }],
      "email": [{ "value": "info@hahn-airport.de" }]
    }
  ]
}