名前を使用して場所を検索する

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

手順

マンハッタンの位置(40.7307999,-73.9973085)から「自由の女神像」を検索するには、次のリクエストを送信します。

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=40.7307999,-73.9973085
    &limit=2
    &q=Statue+of+liberty
    &apiKey={YOUR_API_KEY}

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

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

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

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

{
  "items": [
    {
      "title": "Statue of Liberty-New York Access",
      "id": "here:pds:place:840dr5re-9f0b7cf123e84620a52771300e610edd",
      "resultType": "place",
      "address": {
        "label": "Statue of Liberty-New York Access, 1 Battery Park, New York, NY 10004, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "NY",
        "state": "New York",
        "county": "New York",
        "city": "New York",
        "district": "Financial District",
        "street": "Battery Park",
        "postalCode": "10004",
        "houseNumber": "1"
      },
      "position": { "lat": 40.70267, "lng": -74.01424 },
      "access": [{ "lat": 40.70269, "lng": -74.01422 }],
      "distance": 3438,
      "categories": [
        { "id": "300-3000-0025", "name": "Historical Monument", "primary": true },
        { "id": "300-3000-0023", "name": "Tourist Attraction" },
        { "id": "300-3100-0000", "name": "Museum" }
      ],
      "references": [
        { "supplier": { "id": "core" }, "id": "1217208922" },
        { "supplier": { "id": "core" }, "id": "17260966" },
        { "supplier": { "id": "core" }, "id": "17262185" }
      ],
      "contacts": [
        {
          "phone": [{ "value": "+12123633200" }],
          "www": [{ "value": "http://www.statueoflibertytickets.com" }]
        }
      ]
    },
    {
      "title": "Statue of Liberty",
      "id": "here:pds:place:840dr5r7-9df1349708914ceba912909970598cf7",
      "resultType": "place",
      "address": {
        "label": "Statue of Liberty, New York, NY 10004, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "NY",
        "state": "New York",
        "county": "New York",
        "city": "New York",
        "district": "Liberty Island",
        "postalCode": "10004"
      },
      "position": { "lat": 40.68925, "lng": -74.04445 },
      "access": [{ "lat": 40.68971, "lng": -74.04357 }],
      "distance": 6094,
      "categories": [
        { "id": "300-3000-0025", "name": "Historical Monument", "primary": true },
        { "id": "300-3000-0000", "name": "Landmark-Attraction" },
        { "id": "300-3000-0023", "name": "Tourist Attraction" },
        { "id": "300-3100-0000", "name": "Museum" }
      ],
      "references": [
        { "supplier": { "id": "core" }, "id": "1098463183" },
        { "supplier": { "id": "core" }, "id": "1098463184" },
        { "supplier": { "id": "core" }, "id": "1217206957" },
        { "supplier": { "id": "core" }, "id": "17262184" },
        { "supplier": { "id": "core" }, "id": "899132706" },
        { "supplier": { "id": "tripadvisor" }, "id": "103887" },
        { "supplier": { "id": "yelp" }, "id": "gnZXpLFzKzdBeQfFz1h-2g" },
        { "supplier": { "id": "yelp" }, "id": "wB45aXh2cQlRWoKQzhWgeA" }
      ],
      "contacts": [
        {
          "phone": [{ "value": "+12123633200" }],
          "www": [
            { "value": "http://www.nps.gov/stli" },
            { "value": "https://www.nps.gov" }
          ]
        }
      ]
    }
  ]
}

エンドユーザーは自由の女神像そのものに興味がある場合もあれば、ニューヨークからのアクセスに興味がある場合もあるため、この両方の項目が返されます。

追加情報

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