マルチリバースジオコーディング
/multi-revgeocode エンドポイントは Reverse Geocoding リクエストのスループット パフォーマンスの向上を目的としています。
このエンドポイントでは、1 回のマルチリバース ジオコーディング リクエストで最大 100 か所の住所区画を取得できます。
たとえば、ユーザーがフランクフルトで複数の住所/placesを取得しようとして、リクエストに複数の地理座標を含めて /multi-revgeocode エンドポイントに送信するとします。
POST https://multi-revgeocode.search.hereapi.com/v1/
multi-revgeocode
?lang=en-US
&apiKey={YOUR_API_KEY}POST リクエスト ボディ：
プレーン テキストとして位置情報コンテキストと文字列識別子を ID パラメーターに含めます。
識別子
id：識別子は POST リクエスト ボディの各項目で必須となっています。 値はリクエストごとに一意とし、64 文字の文字数制限があります。使用できるのは英数字、アンダースコア、ダッシュのみです。
位置情報コンテキスト (次のいずれかの方法で提供されるもの)
- 単一の地理的位置：
at- 座標で表される検索コンテキストの中心を指定します - 円：
in- 地理的エリア内を検索します
この 2 つの位置情報コンテキストは相互に排他的です。
位置情報コンテキストは POST リクエスト ボディでのみ使用できます。
上のサポートされているパラメーター以外のパラメーターは、POST リクエスト ボディでは使用できません。
各マルチリバース ジオコード リクエストがリバース ジオコーディングできる位置の最大数は 100 か所です。
POST リクエスト ボディの例：
id=1&at=50.11059,8.68407
id=2&at=50.11091,8.68328
id=3&in=circle:50.0911262,8.700627;r=2000この例では、API は各入力座標に対して最も近い住所/placeを返します。
{
"results": [
{
"id": "1",
"items": [
{
"title": "Bendergasse 6, 60311 Frankfurt, Germany",
"id": "here:af:streetsection:a-a.uU.9-.CFWcuyP5IA6A:CggIBCCqt4nnAhABGgE2",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "Bendergasse 6, 60311 Frankfurt, Germany",
"countryCode": "DEU",
"countryName": "Germany",
"stateCode": "HE",
"state": "Hesse",
"countyCode": "F",
"county": "Frankfurt",
"city": "Frankfurt",
"district": "Altstadt",
"street": "Bendergasse",
"postalCode": "60311",
"houseNumber": "6"
},
"position": {
"lat": 50.11052,
"lng": 8.68398
},
"access": [
{
"lat": 50.11042,
"lng": 8.68402
}
],
"distance": 10,
"mapView": {
"west": 8.68278,
"south": 50.1102,
"east": 8.68483,
"north": 50.11054
}
}
]
},
{
"id": "2",
"items": [
{
"title": "Hinter dem Lämmchen 6, 60311 Frankfurt, Germany",
"id": "here:af:streetsection:zYplws4aR53N0u05iAHEtD:CggIBCDPxInnAhABGgE2",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "Hinter dem Lämmchen 6, 60311 Frankfurt, Germany",
"countryCode": "DEU",
"countryName": "Germany",
"stateCode": "HE",
"state": "Hesse",
"countyCode": "F",
"county": "Frankfurt",
"city": "Frankfurt",
"district": "Altstadt",
"street": "Hinter dem Lämmchen",
"postalCode": "60311",
"houseNumber": "6"
},
"position": {
"lat": 50.11096,
"lng": 8.68333
},
"access": [
{
"lat": 50.11092,
"lng": 8.68335
}
],
"distance": 5,
"mapView": {
"west": 8.68311,
"south": 50.11087,
"east": 8.68377,
"north": 50.111
}
}
]
},
{
"id": "3",
"items": [
{
"title": "Schnappbornweg 85, 60599 Frankfurt, Germany",
"id": "here:af:streetsection:hMoVrRaebf3FidQKfKyL4A:EAIaAjg1",
"resultType": "houseNumber",
"houseNumberType": "interpolated",
"address": {
"label": "Schnappbornweg 85, 60599 Frankfurt, Germany",
"countryCode": "DEU",
"countryName": "Germany",
"stateCode": "HE",
"state": "Hesse",
"countyCode": "F",
"county": "Frankfurt",
"city": "Frankfurt",
"district": "Sachsenhausen",
"street": "Schnappbornweg",
"postalCode": "60599",
"houseNumber": "85"
},
"position": {
"lat": 50.0909,
"lng": 8.70081
},
"access": [
{
"lat": 50.09078,
"lng": 8.7009
}
],
"distance": 29,
"mapView": {
"west": 8.69652,
"south": 50.08983,
"east": 8.70564,
"north": 50.09366
}
}
]
}
]
}レスポンスには次のものが含まれます。
- 対応するリクエスト項目で指定されている識別子
- 完全な住所の詳細と位置
各結果には次の上位要素が含まれます。
id- 識別子は各結果を対応する入力に関連付けます。resultType- HERE Geocoding and Search/multi-revgeocodeエンドポイントは複数のタイプの項目を返すことができます：houseNumber、place、locality、streetなどhouseNumberType- 住所データのタイプ(住所結果の場合にのみ返されます)PA- ポイント住所。位置情報は個々のポイント オブジェクトと一致しますinterpolated- 位置はアドレス レンジ ライン オブジェクト上の補間されたポイントです
title- 結果の代表的な表記の文字列。住所の場合は完全な住所文字列ですaddress- 結果の詳細な住所。position- 結果の代表的な地理的位置 (WGS 84)。結果を地図に表示するために使用されますaccess- 結果にアクセスするための地理的位置 (入口など)mapView- 表示用に最適化された位置情報のバウンディング ボックスdistance-/multi-revgeocodeエンドポイントは特定の空間コンテキスト (「at=lat,lon」) までの距離をメートル単位で返しますid- 結果オブジェクトの識別子。この値を使用して、/lookupエンドポイントから同じオブジェクトを取得できます
エラーが発生した場合、HTTPレスポンスコードとエラーメッセージが返されます。サブリクエストからのエラーにも「id」が返されます。
/multi-revgeocodeエンドポイントパラメーターの詳細については、「APIリファレンス」を参照してください。
注：
/multi-revgeocodeエンドポイントは、セルフサービスのお客様は使用できません。詳細については、HERE営業担当者にお問い合わせください。
4 日前の更新