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

場所をジオコーディングする

このチュートリアルでは、既知の場所の地理座標を検索する方法を説明します。

手順

/geocode エンドポイントは既知の場所の地理座標の検索もサポートしています。これにより、たとえば、企業名を含む企業の住所を、居住地の住所と同じようにジオコーディングできます。

240 Washington St., Boston にある Starbucks の地理座標を返す自由形式のテキスト クエリは、次のように作成されます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=Starbucks%2C+240+Washington+St.%2C+Boston
    &apiKey={YOUR_API_KEY}

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

  • q - 名前を入力します。
  • apiKey - APIキー。
📘

注

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

このクエリはあいまいではありません。ボストンにはこの名前の道路が2つあり、両方ともに240という住居番号があります。1 つはボストンのダウンタウンにあり、もう 1 つはボストンの近隣地域にあります。ただし、Starbucks があるのはボストンのダウンタウンにあるこの住所の近くのみです。

上記のリクエストに対するレスポンスは 1 つの結果から構成され、次のように表示されます。

{
  "items": [
    {
      "title": "Starbucks",
      "id": "here:pds:place:840drt2z-d9bbdad5d12d410fa597ff9a57f0eef4:CggIBCDns4LfAhABGgMyNDA",
      "resultType": "place",
      "address": {
        "label": "Starbucks, 240 Washington St, Boston, MA 02108-4603, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "MA",
        "state": "Massachusetts",
        "county": "Suffolk",
        "city": "Boston",
        "district": "Downtown Boston",
        "street": "Washington St",
        "postalCode": "02108-4603",
        "houseNumber": "240"
      },
      "position": {
        "lat": 42.35814,
        "lng": -71.05765
      },
      "access": [
        {
          "lat": 42.35815,
          "lng": -71.05788
        }
      ],
      "mapView": {
        "west": -71.05887,
        "south": 42.35724,
        "east": -71.05643,
        "north": 42.35904
      },
      "categories": [
        {
          "id": "100-1100-0010",
          "name": "Coffee Shop",
          "primary": true
        }
      ],
      "foodTypes": [
        {
          "id": "800-058",
          "name": "Snacks & Beverages",
          "primary": true
        }
      ],
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 1,
          "placeName": 1
        }
      }
    }
  ]
}

場所の結果には、次の上位レベルの要素が含まれます。

  • resultType - place
  • title - 場所の名前
  • address - 場所の完全な住所を含む、結果の詳細な住所
  • position - 結果の代表的な地理的位置 (WGS 84)。結果を地図に表示するために使用されます
  • access - 結果にアクセスするための地理的位置 (入口など)
  • mapView - 表示用に最適化された位置情報のバウンディング ボックス
  • id - 結果オブジェクトの識別子。この値を使用して /lookup エンドポイントからまったく同じオブジェクトを取得できます。
  • categories - place 結果のカテゴリー ID のリスト
  • foodTypes - 調理または料理の提供を行う place 結果のフード タイプ ID のリスト
  • scoring - /geocode エンドポイントはスコアリング情報を返します。これは各結果が元のクエリとどの程度一致しているかを示します。これは、エンド ユーザー アプリケーションによって使用され、ユースケースの間違いがどの程度「高価」であるかに応じて、結果を受け入れるか拒否するかを選択できます。

なお、/geocode エンドポイントは完全な住所、空間参照、または道路の名前、地域名、郵便番号の一部分など、リクエストが適切な位置コンテキストを提供する場合にのみ、場所の結果を許可します。地域のコンテキストがない場所の名前だけでは、具体的ではありません。たとえば、McDonald, Germany のクエリを特定の位置に解決することはできません。

例外 - 国の重要な場所。Eiffel Tower などのクエリは、/geocode エンドポイントが場所の結果を返すのに十分な具体性があります。

追加情報

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

4 日前の更新