地理座標を使用して周辺の複数の住所を検索する
Reverse Geocode リソースを使用すると、地理座標を使用したクエリに基づいて、最も近い住所を検索できます。
任意で 1 より大きい値 (1 から 100) のパラメーター limit を設定することで、複数の結果を取得できます。
適切なパラメーターを検索に使用して、https://revgeocode.search.hereapi.com/v1/revgeocode に HTTP GET リクエストを送信します。
手順
ユーザーはスイスのナンダにある位置で地図ポイントを選択し、ポイントの座標を指定し、結果件数の制限を設定して、 次のリクエストをエンドポイントに送信します。
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プラットフォームの認証オプションの詳細については、「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 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 の結果を確認します。住所の詳細が表示されます。
住所が追加で返されています。
地図ポイントから項目の最も近い座標までの距離 (メートル単位) が返されています。
最も近い座標は、その位置またはアクセス座標と異なる場合があります。
4 日前の更新