Geocode

/geocode エンドポイントを使用すると、クエリが不完全な場合または部分的に間違っている場合でも、既知の住所、場所、地域、行政区画の地理座標を検索できます。また、完全な住所の文字列と住所の詳細を返します。

5 Rue Daunou, 75000 Paris, France という住所の自由形式のテキストクエリは、次のリクエストのように作成できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=5+Rue+Daunou%2C+75000+Paris%2C+France
    &apiKey={YOUR_API_KEY}

ユーザーのミスにより、クエリの郵便番号は間違っています。

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

{
  "items": [
    {
      "title": "5 Rue Daunou, 75002 Paris, France",
      "id": "here:af:streetsection:bI4Le6cyA.1mlQyLunYpjC:CggIBCCi-9SPARABGgE1KGQ",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "5 Rue Daunou, 75002 Paris, France",
        "countryCode": "FRA",
        "countryName": "France",
        "stateCode": "IDF",
        "state": "Île-de-France",
        "county": "Paris",
        "city": "Paris",
        "district": "2e Arrondissement",
        "street": "Rue Daunou",
        "postalCode": "75002",
        "houseNumber": "5"
      },
      "position": {
        "lat": 48.86926,
        "lng": 2.3321
      },
      "access": [
        {
          "lat": 48.86931,
          "lng": 2.33215
        }
      ],
      "mapView": {
        "west": 2.33073,
        "south": 48.86836,
        "east": 2.33347,
        "north": 48.87016
      },
      "scoring": {
        "queryScore": 0.97,
        "fieldScore": {
          "country": 1,
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 1,
          "postalCode": 0.82
        }
      }
    }
  ]
}

レスポンスには住所の地理座標と、正しい郵便番号を含む完全な住所文字列が含まれています。

各結果には次の上位要素が含まれます。

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

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