運転方向を考慮して道路の一致を向上する
多くのユースケースでは、GPSセンサーの位置座標を高精度で道路に一致させる必要があります。たとえば、コネクテッド ドライビングや保険テレマティクスなどの用途で使用する場合は、移動している位置情報を可能な限り最適な道路区間に一致させることが重要です。特に道路が交差したり重なったりする場合は、高精度の道路マッチングが困難になることがあります。車はどこを走行しているのか、高速道路上か、道路かその上か、下か、など、Reverse Geocoderの/revgeocodeエンドポイントでは、車両の方向情報を使用して最も適合する道路を見つけることができます。たとえば、位置ポイントで南(西ではなく)に移動している車両に関する情報は、Geocoderが東西方向の都市道路ではなく、近くの南北方向の高速道路と位置を一致させるのに役立ちます。
このチュートリアルでは、/revgeocode エンドポイントと /multi-revgeocode エンドポイントでこの機能を使用する方法を説明します。
手順
このクエリを例に見てみましょう。
GET https://revgeocode.search.hereapi.com/v1/
revgeocode
?at=51.251772,-1.078596
&bearing=180
&lang=en-US
&apiKey={YOUR_API_KEY}次のパラメーターを使用します。
- at - 座標で表される検索コンテキストの中心を指定します。
- bearing - bearing パラメーターはアセットの方向を度数で表します。真北から始まり、右回りで数字が大きくなっていきます。値の範囲は 0 度 (北) から 359 度 (北に戻る直前) です。参考までに、東は 90 度、南は 180 度、西は 270 度に対応します。bearing パラメーターには、[0;359] の範囲内の整数値のみ使用できます。他の値を指定すると、400 エラー レスポンスが返されます。
- lang - BCP 47 に準拠した言語コードのリストから、結果のレンダリングに使用する言語を選択します。
- apiKey - APIキー。
注
このリクエストはAPIキー認証を使用します。HEREプラットフォームの認証オプションの詳細については、「Identity & Access Management Guide」(IDとアクセス管理ガイド)を参照してください。
入力された位置は「M3」ストリート(ピンクでマーク)の近くですが、方位は「Hackwood Road」(黄色でマーク)に該当しています。
レスポンスでは、「方位」との一致度が低い、より近くにある道路「M3」ではなく、「方位」との一致度が高い道路結果「Hackwood Road」が返されます。
{
"items": [
{
"title": "Hackwood Road, Basingstoke, RG21 3, United Kingdom",
"id": "here:af:streetsection:d0xsM9w-SB2XNKwpw9qjTC",
"resultType": "street",
"address": {
"label": "Hackwood Road, Basingstoke, RG21 3, United Kingdom",
"countryCode": "GBR",
"countryName": "United Kingdom",
"state": "England",
"countyCode": "HAM",
"county": "Hampshire",
"city": "Basingstoke",
"district": "Basingstoke",
"street": "Hackwood Road",
"postalCode": "RG21 3"
},
"position": {
"lat": 51.25177,
"lng": -1.07867
},
"distance": 5,
"mapView": {
"west": -1.08421,
"south": 51.2516,
"east": -1.07852,
"north": 51.26198
}
}
]
}/multi-revgeocodeエンドポイントでこの機能を使用するクライアントアプリケーションの場合：
POST https://multi-revgeocode.search.hereapi.com/v1/
multi-revgeocode
?lang=en-US
&apiKey={YOUR_API_KEY}HTTP本文：
id=1&at=51.251772,-1.078596&bearing=180
id=2&at=40.7305599,-73.995785&bearing=40
id=3&in=circle:51.5059910,-0.1269900;r=102&bearing=60「方位」の一致度がより高い道路が優先されます。
{
"results": [
{
"id": "1",
"items": [
{
"title": "Hackwood Road, Basingstoke, RG21 3, United Kingdom",
"id": "here:af:streetsection:d0xsM9w-SB2XNKwpw9qjTC",
"resultType": "street",
"address": {
"label": "Hackwood Road, Basingstoke, RG21 3, United Kingdom",
"countryCode": "GBR",
"countryName": "United Kingdom",
"state": "England",
"countyCode": "HAM",
"county": "Hampshire",
"city": "Basingstoke",
"district": "Basingstoke",
"street": "Hackwood Road",
"postalCode": "RG21 3"
},
"position": {
"lat": 51.25177,
"lng": -1.07867
},
"distance": 5,
"mapView": {
"west": -1.08421,
"south": 51.2516,
"east": -1.07852,
"north": 51.26198
}
}
]
},
{
"id": "2",
"items": [
{
"title": "Washington Sq E, New York, NY 10003, United States",
"id": "here:af:streetsection:POIumdt4bXHk.fFye7SGBA",
"resultType": "street",
"address": {
"label": "Washington Sq E, New York, NY 10003, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "NY",
"state": "New York",
"county": "New York",
"city": "New York",
"district": "Greenwich Village",
"street": "Washington Sq E",
"postalCode": "10003"
},
"position": {
"lat": 40.73052,
"lng": -73.99571
},
"distance": 7,
"mapView": {
"west": -73.99657,
"south": 40.72955,
"east": -73.99554,
"north": 40.7307
}
}
]
},
{
"id": "3",
"items": [
{
"title": "Great Scotland Yard, London, SW1A 2, United Kingdom",
"id": "here:af:streetsection:ExYuvQUUcHPED-uSOVKZLB",
"resultType": "street",
"address": {
"label": "Great Scotland Yard, London, SW1A 2, United Kingdom",
"countryCode": "GBR",
"countryName": "United Kingdom",
"state": "England",
"countyCode": "LDN",
"county": "London",
"city": "London",
"district": "Westminster",
"street": "Great Scotland Yard",
"postalCode": "SW1A 2"
},
"position": {
"lat": 51.50599,
"lng": -0.12698
},
"distance": 1,
"mapView": {
"west": -0.12698,
"south": 51.50599,
"east": -0.12497,
"north": 51.50697
}
}
]
}
]
}typesパラメーター：types=streetのみ許可され、デフォルトで使用されます。そのため、このパラメーターは任意です。street以外のtypes値を使用すると、400エラーレスポンスが返されます。- 複数の道路の距離がほぼ同じ場合は、「方位」の一致度が高い道路が優先されます。
bearing値に一致する道路の結果がない場合、結果は近くの道路にフォールバックされます。
追加情報
/revgeocodeおよび/multi-revgeocodeエンドポイントパラメーターの詳細については、「APIリファレンス」を参照してください。
4 日前の更新