地理座標を基に近くの複数の住所を検索

Reverse Geocodeリソースを使用すると、Geocodeを使用したクエリに基づいて、最も近い住所を検索できます。 1 より大きい値の limit パラメータを設定することで、複数の結果を取得することができます ([1..100] より大きい値 ) 。

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

プロシージャ

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

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=46.1802980%2C7.2913685
    &limit=20
    &apiKey={YOUR_API_KEY}

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

  • at - 座標で表された検索コンテキストの中心を指定
  • Limit ：返される結果の最大数
  • apiKey - お客様の API キー 。

注

この要求は API キー 認証を使用します。 HERE platform の認証オプションの詳細については、『ID およびアクセス管理ガイド』を参照してください。

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 40, 1997 Nendaz Valais, Suisse",
      "id": "here:af:streetsection:9z62iGVQH0LlHrihOC9UMD:CgcIBCDOq9J-EAEaAjQw",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Route de la Télécabine 40, 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": "40"
      },
      "position": {
        "lat": 46.18035,
        "lng": 7.29104
      },
      "access": [
        {
          "lat": 46.18023,
          "lng": 7.29109
        }
      ],
      "distance": 26,
      "mapView": {
        "west": 7.29039,
        "south": 46.17957,
        "east": 7.29552,
        "north": 46.18338
      }
    },
    {
      "title": "Edelweiss",
      "id": "here:pds:place:756u0jnt-7fac56ee086c4c4d97451e273f4bd5a6",
      "resultType": "place",
      "address": {
        "label": "Edelweiss, 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.18035,
        "lng": 7.29104
      },
      "access": [
        {
          "lat": 46.18023,
          "lng": 7.29109
        }
      ],
      "distance": 26,
      "categories": [
        {
          "id": "500-5000-0000",
          "primary": true
        },
        {
          "id": "100-1000-0000"
        },
        {
          "id": "200-2000-0011"
        },
        {
          "id": "500-5000-0053"
        }
      ],
      "foodTypes": [
        {
          "id": "301-000",
          "primary": true
        },
        {
          "id": "307-000"
        },
        {
          "id": "310-000"
        },
        {
          "id": "800-074"
        }
      ]
    },
    {
      "title": "Sentier Panoramique de Tracouet",
      "id": "here:pds:place:756u0jnt-863de29b7d664dd5b74bde192dd06e60",
      "resultType": "place",
      "address": {
        "label": "Sentier Panoramique de Tracouet, 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.17995,
        "lng": 7.29107
      },
      "access": [
        {
          "lat": 46.17995,
          "lng": 7.29107
        }
      ],
      "distance": 45,
      "categories": [
        {
          "id": "550-5510-0359",
          "primary": true
        },
        {
          "id": "300-3000-0000"
        },
        {
          "id": "550-5510-0000"
        }
      ]
    },
    ... 14 more results ...,
    {
      "title": "Apartment Ambassador II Haute Nendaz",
      "id": "here:pds:place:756u0jnt-435b2aaa21214569a7a1fff5f6cb4593",
      "resultType": "place",
      "address": {
        "label": "Apartment Ambassador II Haute Nendaz, 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.17957,
        "lng": 7.29092
      },
      "access": [
        {
          "lat": 46.17957,
          "lng": 7.29092
        }
      ],
      "distance": 88,
      "categories": [
        {
          "id": "500-5000-0000",
          "primary": true
        }
      ]
    }
  ]
}

JSONの結果を確認します。 住所の詳細が表示されます。 追加で返されたアドレスに注意してください。 地図のポイントから返されたアイテムの最も近い座標までの距離 ( メートル単位 ) に注意してください。 最も近い座標は、その位置またはアクセス座標と異なる場合があります。

「」に一致する結果は 件です

    「」に一致する結果はありません