空間フィルターで絞り込んで近くの住所を検索

Reverse Geocodeリソースを使用すると、Geocodeを使用したクエリに基づいて、最も近い住所を検索できます。 空間コンテキスト (at=lat, lon) を指定する代わりに、円形の空間フィルタ (in=circle:lat, lon, rad) を使用することもできます。

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

プロシージャ

ユーザーがスイスのNendazにある場所でマップポイントを選択し、ポイントの座標を特定して結果のサイズと半径方向の制限を設定し、次のリクエストをエンドポイントに送信します。

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 は、最寄りの住所「 Route de la T é l é cabine 67 、 1997 Nendaz Valais 、 Suisse 」を返します。また、半径方向の制限の範囲内で、近隣のいくつかの結果のみが返されます。

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

{
  "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の結果を確認します。 住所の詳細が表示されます。 所定の空間的制約により、追加で返されたアドレスが減少していることに注意してください。 地図のポイントから返されたアイテムの最も近い座標までの距離 ( メートル単位 ) に注意してください。 最も近い座標は、空間フィルタの外側にある位置またはアクセス座標とは異なる場合があります。