結果を特定の国に絞り込む

このチュートリアルでは、 API が結果を特定の国に絞り込む方法を示します。

プロシージャ

/geocode エンドポイントでは、結果を特定の国に絞り込めます。 これは、すべての住所が特定の国にあることがわかっている場合に、あいまいさや予期しない結果を避けるために役立ちます。

たとえば、クエリの 20 Victoria St, London/geocode 場合、はイギリスとカナダの 2 つの結果を返します。

アプリケーションが米国およびカナダの住所のみで動作する場合は、これらの 2 つの国の結果をパラメータで制限できます in=countryCode:CAN,USA

このクエリは、次の条件で作成できます。

GET https://geocode.search.hereapi.com/v1/
    geocode
    ?q=20+Victoria+St%2C+London
    &in=countryCode%3ACAN%2CUSA
    &apiKey={YOUR_API_KEY}

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

• Q - フリーテキストのクエリを入力します。
• In-地理的領域内で検索します。 結果が指定した領域にある場合は、結果が返されます。
• apiKey - お客様の API キー 。

上記のリクエストに対する応答には、カナダでの単一の結果が含まれており、次のように表示されます。

{
  "items": [
    {
      "title": "20 Victoria St, London, ON N6A, Canada",
      "id": "here:af:streetsection:YOrVG8JgXxLvp3Qomjb.SB:EAIaAjIwKGQ",
      "resultType": "houseNumber",
      "houseNumberType": "interpolated",
      "address": {
        "label": "20 Victoria St, London, ON N6A, Canada",
        "countryCode": "CAN",
        "countryName": "Canada",
        "stateCode": "ON",
        "state": "Ontario",
        "county": "Middlesex",
        "city": "London",
        "district": "North London",
        "street": "Victoria St",
        "postalCode": "N6A",
        "houseNumber": "20"
      },
      "position": {
        "lat": 43.0009,
        "lng": -81.2681
      },
      "access": [
        {
          "lat": 43.00078,
          "lng": -81.26803
        }
      ],
      "mapView": {
        "west": -81.26933,
        "south": 43,
        "east": -81.26687,
        "north": 43.0018
      },
      "scoring": {
        "queryScore": 1,
        "fieldScore": {
          "city": 1,
          "streets": [
            1
          ],
          "houseNumber": 1
        }
      }
    }
  ]
}

追加情報

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