郵便番号と住居番号で住所を検索する

このチュートリアルでは、住居番号と郵便番号を使用して住所を検索する方法を説明します。

手順

高精度の郵便番号がある国で、郵便番号がエリアを表さず、同じ道路のいくつかの住所にのみ関連付けられている場合は、住居番号と郵便番号を入力するだけで住所を検索できます。これは、輸送や宅配においては一般的です。

/geocodeエンドポイントでは、修飾クエリとfreeformのクエリがこのユースケースをサポートします。

この機能は、カナダ、アイルランド、イスラエル、マン島、オランダ、ポルトガル、シンガポール、台湾、英国、米国 (ZIP+4) で利用できます。アイルランドとシンガポールでは郵便番号が一意の住居番号を表すほど精度が高いため、/geocodeエンドポイントは郵便番号による住所検索もサポートしています。

たとえば、「425 W Randolph St, Chicago, IL 60606-1506, United States」の住所は、住居番号と郵便番号のみを指定しても検索できます。

houseNumber=425
postalCode=60606-1506

クエリは次のように作成できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        houseNumber=425;
        postalCode=60606-1506
    &apiKey={YOUR_API_KEY}

または freeform クエリとして行います。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=425+60606-1506
    &apiKey={YOUR_API_KEY}

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

q - 名前を入力します。
**qq **- 修飾クエリを入力します。修飾クエリはフリーテキストクエリに似ていますが、構造化されています。セミコロンで区切って複数のサブパラメーターを指定できるため、クエリのさまざまな側面を指定できます。
apiKey - APIキー。

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

上記のリクエストに対するレスポンスに一致するフィールドは住居番号と郵便番号の2つのフィールドのみですが、結果タイプは完全な住所です。

{
  "items": [
    {
      "title": "425 W Randolph St, Chicago, IL 60606-1506, United States",
      "id": "here:af:streetsection:hdZ6xBRUraY46IQZCqZidD:CgcIBCDMlOElEAEaAzQyNShk",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "425 W Randolph St, Chicago, IL 60606-1506, United States",
        "countryCode": "USA",
        "countryName": "United States",
        "stateCode": "IL",
        "state": "Illinois",
        "county": "Cook",
        "city": "Chicago",
        "district": "West Loop",
        "street": "W Randolph St",
        "postalCode": "60606-1506",
        "houseNumber": "425"
      },
      "position": {
        "lat": 41.88432,
        "lng": -87.63877
      },
      "access": [
        {
          "lat": 41.88449,
          "lng": -87.63877
        }
      ],
      "mapView": {
        "west": -87.63998,
        "south": 41.88342,
        "east": -87.63756,
        "north": 41.88522
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "houseNumber": 1,
          "postalCode": 1
        }
      }
    }
  ]
}

追加情報

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