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

このチュートリアルでは、テキストクエリを使用して地理座標を返す方法を説明します。

手順

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

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

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

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

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

上のリクエストに対するレスポンスは次のようになります。

{
  "items": [
    {
      "title": "240 Washington St, Boston, MA 02108-4603, United States",
      "id": "here:af:streetsection:YCY1nQWrJ5eBrHv075VVOD:CggIBCDns4LfAhABGgMyNDAoZA",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "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
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 1
        }
      }
    },
    {
      "title": "240 Washington St, Boston, MA 02135-3508, United States",
      "id": "here:af:streetsection:6SnFDsUujYAamxhLX-Vr1D:CgcIBCDRnLAhEAEaAzI0MChk",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "240 Washington St, Boston, MA 02135-3508, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "MA",
        "state": "Massachusetts",
        "county": "Suffolk",
        "city": "Boston",
        "district": "Brighton Center",
        "street": "Washington St",
        "postalCode": "02135-3508",
        "houseNumber": "240"
      },
      "position": {
        "lat": 42.34754,
        "lng": -71.14943
      },
      "access": [
        {
          "lat": 42.34765,
          "lng": -71.14925
        }
      ],
      "mapView": {
        "west": -71.15065,
        "south": 42.34664,
        "east": -71.14821,
        "north": 42.34844
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 1
        }
      }
    }
  ]
}

このクエリはあいまいです。ボストンにはこの名前の通りが 2 つあり、両方に 240 という住居番号があります。したがって、レスポンスには、郵便番号と地区名の異なる 2 つの位置の結果が含まれます。

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

resultType - houseNumber
houseNumberType - 住所データのタイプ。resultType が houseNumber の場合に返される
- PA - ポイント住所。位置情報は個々のポイントオブジェクトと一致する
- interpolated - 位置情報はアドレスレンジを基に補間されています
title - 結果の代表的な表記の文字列。住所の場合は、完全な住所文字列
address - 結果の詳細な住所。
position - 結果の代表的な地理的位置 (WGS 84)。これは、地図上で結果を検索または表示するために使用される
access - 結果にアクセスするための地理的位置 (入り口など)
mapView - 表示用に最適化された位置情報のバウンディングボックス
id - 結果オブジェクトの識別子。この値を使用して /lookup エンドポイントからまったく同じオブジェクトを取得できます。
scoring - /geocode エンドポイントはスコアリング情報を返します。これは各結果が元のクエリとどの程度一致しているかを示します。これは、顧客アプリケーションによって使用され、ユースケースの間違いがどの程度「高価」であるかに応じて、結果を受け入れるか拒否するかを選択できます。

追加情報

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