電話番号を使用して場所を検索する

このチュートリアルでは、電話番号を使用して場所を検索する方法を説明します。

手順

ベルリンのレストラン「Hako Ramen」を検索するには、その電話番号を Discover で使用します。電話番号にはさまざまな形式があります。

国際形式：+493089405000、00493089405000
ローカル形式：(030) 89405000、03089405000

ベルリン周辺地から「(030) 89405000」でこの場所を検索すると、次のリクエストが送信されます。

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=52.60088,13.5924
    &q=(030)%2089405000
    &apiKey={YOUR_API_KEY}

次のパラメーターを使用します。

at - 座標で表される検索コンテキストの中心を指定します。
q - 名前を入力します。
apiKey - APIキー。

📘
注
このリクエストはAPIキー認証を使用します。HEREプラットフォームの認証オプションの詳細については、「Identity & Access Management Guide」(IDとアクセス管理ガイド)を参照してください。

結果には関連する位置オブジェクトに関する詳細情報が表示されます。

{
  "items": [
    {
      "title": "Hako Ramen",
      "id": "here:pds:place:276u33d8-f880e93a803146e2a1c9a63539026f05",
      "resultType": "place",
      "foodTypes": [{ "id": "203-000", "name": "Japanese", "primary": true }],
      "contacts": [
        { "phone": [{ "value": "+493089405000" }], "www": [{ "value": "https://www.hakoramenberlin.de" }] }
      ],
      "address": {
        "label": "Hako Ramen, Bergmannstraße 11, 10961 Berlin, Deutschland",
        ...
      },
      ...
    }
  ]
}

追加情報

/discoverエンドポイントパラメーターの詳細については、「APIリファレンス」を参照してください。