ガイドAPIリファレンス変更履歴
ガイド
  1. HERE Geocoding and Search API v7開発者ガイド
  2. HERE Geocoding and Search API v7エンドポイント

Lookup

HEREが認識しているすべての場所または位置オブジェクトは場所識別子(ID)を持っています。

HERE IDで場所を検索できるように、APIには/lookupエンドポイントが含まれています。

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

たとえば、「フランクフルトハーン空港」の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 - 結果の詳細な住所。

  • position - 結果の代表的な地理的位置 (WGS 84)。これを使用して地図上に結果を表示します

  • access - 結果にアクセスするための地理的位置 (入口など)

  • id - 結果オブジェクトの識別子。この値を使用して /lookup エンドポイントからまったく同じオブジェクトを取得できます。特に「here:af:streetsection:xxx」のような ID 形式では、住所オブジェクト ID が変更されても、ユーザーは以前に返された ID を /lookup エンドポイントで使用して、同じオブジェクトを取得できます。ただし、レスポンスにはそのオブジェクトのアップデート済みの ID が含まれます。

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

    プライマリ カテゴリーでは primary フラグが true に設定されます。

  • foodTypes - 調理または料理の提供を行う place 結果のフード タイプ ID のリスト

    プライマリ フード タイプでは primary フラグが true に設定されます。

  • chains - チェーンに属する place 結果のチェーン ID のリスト

  • contacts - place 結果の問い合わせ情報 (電話、Web など) のリスト

  • openingHours - place 結果の営業時間のリスト

  • closedPermanently - 場所の閉店ステータス

    • yes：POI (施設情報) が完全に閉店または閉鎖されている場合、名前/categoryを使用した検索の結果には表示されません。ただし、少なくとも 90 日間は /lookup エンドポイントから引き続き取得できます。
    • maybe：POI (施設情報) に関するデータの信頼性が低下した場合、名前/categoryを使用した検索はできなくなります。ただし、少なくとも 90 日間は /lookup エンドポイントから引き続き取得できます。

    • 注：参照期間の 90 日は今後変更される可能性があります。

    • 注：この機能はまずアルファ版としてリリースされました。「成熟度」を参照してください。十分なフィードバックを得ることができたら、機能を次の成熟度に昇格させる予定です。

{
  "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": "[email protected]" }]
    }
  ]
}

4 日前の更新