周辺の住所を空間フィルターで絞り込んで検索する

Reverse Geocode リソースを使用すると、地理座標を使用したクエリに基づいて、最も近い住所を検索できます。

これは空間コンテキスト (at=lat,lon) を指定する代わりに、円形空間フィルター (in=circle:lat,lon;rad) を使用するオプションです。

適切なパラメーターを検索に使用して、https://revgeocode.search.hereapi.com/v1/revgeocode に HTTP GET リクエストを送信します。

手順

ユーザーはスイスのナンダにある位置で地図ポイントを選択し、ポイントの座標を指定し、結果の件数と半径方向の制限を設定して、次のリクエストをエンドポイントに送信します。

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?in=circle%3A46.180298%2C7.2913685%3Br%3D25
    &limit=20
    &apiKey={YOUR_API_KEY}

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

In - 地理的エリア内を検索します。結果が指定したエリア内にある場合、結果が返されます。
limit - 返される結果の最大数。
apiKey - APIキー。

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

APIは最も近い住所「Route de la Télécabine 67, 1997 Nendaz Valais, Swiss」と、追加で半径方向の制限内にある数件の近隣の結果のみを返します。

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

{
  "items": [
    {
      "title": "Route de la Télécabine 67, 1997 Nendaz Valais, Suisse",
      "id": "here:af:streetsection:9z62iGVQH0LlHrihOC9UMD:CgcIBCDLq9J-EAEaAjY3",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Route de la Télécabine 67, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997",
        "houseNumber": "67"
      },
      "position": {
        "lat": 46.18017,
        "lng": 7.29134
      },
      "access": [
        {
          "lat": 46.18028,
          "lng": 7.29128
        }
      ],
      "distance": 15,
      "mapView": {
        "west": 7.29039,
        "south": 46.17957,
        "east": 7.29552,
        "north": 46.18338
      }
    },
    {
      "title": "Nv Remontées Mécaniques SA",
      "id": "here:pds:place:756u0jnt-1c66d7a60c1645c2a827244ca1cf9bfe",
      "resultType": "place",
      "address": {
        "label": "Nv Remontées Mécaniques SA, Route de la Télécabine, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997"
      },
      "position": {
        "lat": 46.18017,
        "lng": 7.29134
      },
      "access": [
        {
          "lat": 46.18028,
          "lng": 7.29128
        }
      ],
      "distance": 15,
      "categories": [
        {
          "id": "800-8600-0197",
          "primary": true
        }
      ]
    },
    {
      "title": "Route de la Télécabine, 1997 Nendaz Valais, Suisse",
      "id": "here:af:streetsection:9z62iGVQH0LlHrihOC9UMD",
      "resultType": "street",
      "address": {
        "label": "Route de la Télécabine, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997"
      },
      "position": {
        "lat": 46.18125,
        "lng": 7.29297
      },
      "distance": 1,
      "mapView": {
        "west": 7.29039,
        "south": 46.17957,
        "east": 7.29552,
        "north": 46.18338
      }
    }
  ]
}

JSON の結果を確認します。住所の詳細が表示されます。

指定された空間的制限により、追加で返される住所が減少します。

地図ポイントから項目の最も近い座標までの距離 (メートル単位) が返されています。

最も近い座標は、空間フィルターの外側にある位置またはアクセス座標とは異なる場合があります。