住居番号のフォールバックを使用する

このチュートリアルでは、APIが住居番号のフォールバックを管理する方法を説明します。

手順

探している住居番号がまだマップデータにない場合があります。たとえば、その住居がまだ建築中である場合が考えられます。この場合、HERE Geocoding and Searchの/geocodeは、同じ道路にある最も近い既知の住居番号を返します。

たとえば、Ringelsteinweg 11, 14165 Berlinという住所はマップデータでは使用できません(実際に存在もしていません)。この道路で一番近い家の住居番号は 7 です。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=Ringelsteinweg+11%2C+14165+Berlin
    &apiKey={YOUR_API_KEY}

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

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

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

/geocodeでは住居番号11は発見できず、代わりに住居番号7が返されます。

{
  "items": [
    {
      "title": "Ringelsteinweg 7, 14165 Berlin, Deutschland",
      "id": "here:af:streetsection:qI3rHJl.RsGumDzYSgMCkB:CgcIBCCBnaRQEAEaATcoZA",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Ringelsteinweg 7, 14165 Berlin, Deutschland",
        "countryCode": "DEU",
        "countryName": "Deutschland",
        "stateCode": "BE",
        "state": "Berlin",
        "countyCode": "B",
        "county": "Berlin",
        "city": "Berlin",
        "district": "Zehlendorf",
        "street": "Ringelsteinweg",
        "postalCode": "14165",
        "houseNumber": "7"
      },
      "position": {
        "lat": 52.41003,
        "lng": 13.26192
      },
      "access": [
        {
          "lat": 52.41007,
          "lng": 13.26191
        }
      ],
      "mapView": {
        "west": 13.26045,
        "south": 52.40913,
        "east": 13.26339,
        "north": 52.41093
      },
      "houseNumberFallback": true,
      "scoring": {
        "queryScore": 0.99,
        "fieldScore": {
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 0.96,
          "postalCode": 1
        }
      }
    }
  ]
}

レスポンスには追加の上位レベルの要素 (フラグ "houseNumberFallback": true) が含まれます。これは、リクエストされた住居番号が最も近い既知の住居番号に一致するように修正されたことを示します。

住居番号フィールドのスコアは 1 ではなくなり、0.96 になります。減らされた 4 ポイントはリクエストされた住居番号と返された住居番号の間の数値距離を表し、合計クエリスコアも減少します。

追加情報

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