郵便番号による住所検索 (SGP 、 IRL)

このチュートリアルでは、郵便番号を使用してシンガポール (SGP) およびアイルランド (IRL) の住所を検索する方法を示します。

プロシージャ

アイルランドの郵便番号システム、 Eircode は、あらゆる家およびビジネス住所に一意の郵便番号を割り当てます。 シンガポールでは、郵便番号も住所と同じくらい正確です。 どちらの国でも、郵便番号を使用して、番地、市区町村、近隣地域、さらには番地などを入力せずに、特定の住所や場所を検索できます。 /geocode エンドポイントがこのユースケース をサポートしています。 郵便番号のみを含む、 freeform または認定済みのクエリの完全な住所を検索できます。 この機能は、これらの 2 つの国でのみ利用できます。

郵便番号は、次の精度で入力してください。

• シンガポール： 6 桁の郵便番号
• アイルランド : 7 文字の "eircode"

たとえば、住所「 4 Derrynane Gardens, Dublin, County Dublin, D04 WR52, Ireland 」を検索するには、郵便番号のみを条件付きクエリとして指定します。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        postalCode=D04+WR52
    &apiKey={YOUR_API_KEY}

または freeform クエリ :

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=D04+WR52
    &apiKey={YOUR_API_KEY}

次のパラメータが使用されます。

• qq - 適切なクエリの入力。適切なクエリは、フリーテキストクエリと似ていますが、構造化されています。 複数のサブパラメータをセミコロンで区切って指定できます。このサブパラメータを使用すると、クエリーのさまざまな側面を指定できます。
• apiKey - お客様の API キー 。

いずれの場合も、応答は同じです。 一致した Field-Postal コードは 1 つだけです。 ただし、結果タイプは完全なアドレスです。

{
  "items": [
    {
      "title": "4 Derrynane Gardens, Dublin, County Dublin, D04 WR52, Ireland",
      "id": "here:af:streetsection:xXbhv-RtAOYHP17itm9nPC:CgcIBCCr4K5mEAEaATQ",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "4 Derrynane Gardens, Dublin, County Dublin, D04 WR52, Ireland",
        "countryCode": "IRL",
        "countryName": "Ireland",
        "countyCode": "D",
        "county": "County Dublin",
        "city": "Dublin",
        "district": "Dublin 4",
        "street": "Derrynane Gardens",
        "postalCode": "D04 WR52",
        "houseNumber": "4"
      },
      "position": {
        "lat": 53.33782,
        "lng": -6.22906
      },
      "access": [
        {
          "lat": 53.33786,
          "lng": -6.22839
        }
      ],
      "mapView": {
        "west": -6.23057,
        "south": 53.33692,
        "east": -6.22755,
        "north": 53.33872
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "postalCode": 1
        }
      }
    }
  ]
}

シンガポールの郵便番号は 6 桁で構成され、他の多くの国の郵便番号とよく似ています。 あいまいさを避けて郵便番号のみのクエリの結果を取得するに at は、パラメーター、シンガポールの国名、または大文字の国コードを使用して空間参照を追加で提供することをお勧めします。 または、国別フィルタを「 SGP 」に設定します。

たとえば、住所「 53 Stamford Rd, Singapore 178887, Singapore 」を検索するには、郵便番号を修飾フィールドとして指定し、シンガポールの結果をパラメータで制限 in=countryCode:SGPします。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        postalCode=178887
    &in=countryCode%3ASGP
    &apiKey={YOUR_API_KEY}

または、国名または国コードを [ 認定国 ] フィールドとして指定することもできます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?qq=
        postalCode=178887;
        country=Singapore
    &apiKey={YOUR_API_KEY}

または国名、国コード、郵便番号を freeform クエリに結合できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=178887+SGP
    &apiKey={YOUR_API_KEY}

上記のいずれかのクエリーに対する応答は、完全なアドレスです。

{
  "items": [
    {
      "title": "53 Stamford Rd, Singapore 178887, Singapore",
      "id": "here:af:streetsection:us5c0JNnSvmYKAY94exFYB:CgcIBCD7_IpyEAEaAjUz",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "53 Stamford Rd, Singapore 178887, Singapore",
        "countryCode": "SGP",
        "countryName": "Singapore",
        "county": "Singapore",
        "city": "Singapore",
        "district": "Central Business District",
        "street": "Stamford Rd",
        "postalCode": "178887",
        "houseNumber": "53"
      },
      "position": {
        "lat": 1.29427,
        "lng": 103.85078
      },
      "access": [
        {
          "lat": 1.29437,
          "lng": 103.85084
        }
      ],
      "mapView": {
        "west": 103.84988,
        "south": 1.29337,
        "east": 103.85168,
        "north": 1.29517
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "country": 1,
          "postalCode": 1
        }
      }
    }
  ]
}

クライアントアプリケーションは、住所と郵便番号の情報を 1 つのクエリに結合できます。 /geocode エンドポイントは、提供されているすべてのアドレスコンポーネントに一致するため、より信頼性の高い結果を見つけることができます。

追加情報

/geocode パラメータの詳細については、次のトピックを参照してください。 API リファレンス。