住居番号のフォールバックを使用
このチュートリアルでは、 API による住居番号のフォールバックの管理方法について説明します。
プロシージャ
検索している番地がまだマップ データに入っていない可能性があります。 たとえば、その家はまだ建設中です。 このような場合、 HERE Geocoding and Search /geocode
は同じ道路で最も近い既知の番地を返します。
たとえば Ringelsteinweg 11, 14165 Berlin
、マップ データでは住所を使用できません ( 実際には存在しません ) 。 この通りで一番近い番地 7
はです。
GET https://geocode.search.hereapi.com/v1/
geocode
?q=Ringelsteinweg+11%2C+14165+Berlin
&apiKey={YOUR_API_KEY}
次のパラメータが使用されます。
- Q - フリーテキストのクエリを入力します。
- apiKey - お客様の API キー 。
注
この要求は API キー 認証を使用します。 HERE platform の認証オプションの詳細については、『ID およびアクセス管理ガイド』を参照してください。
/geocode
は、住居番号11
を見つける ことができません。代わりに、住居番号 7
を返します。
{
"items": [
{
"title": "Ringelsteinweg 7, 14165 Berlin, Deutschland",
"id": "here:af:streetsection:qI3rHJl.RsGumDzYSgMCkB:CgcIBCCBnaRQEAEaATcoZA",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "Ringelsteinweg 7, 14165 Berlin, Deutschland",
"countryCode": "DEU",
"countryName": "Deutschland",
"stateCode": "BE",
"state": "Berlin",
"countyCode": "B",
"county": "Berlin",
"city": "Berlin",
"district": "Zehlendorf",
"street": "Ringelsteinweg",
"postalCode": "14165",
"houseNumber": "7"
},
"position": {
"lat": 52.41003,
"lng": 13.26192
},
"access": [
{
"lat": 52.41007,
"lng": 13.26191
}
],
"mapView": {
"west": 13.26045,
"south": 52.40913,
"east": 13.26339,
"north": 52.41093
},
"houseNumberFallback": true,
"scoring": {
"queryScore": 0.99,
"fieldScore": {
"city": 1,
"streets": [
1
],
"houseNumber": 0.96,
"postalCode": 1
}
}
}
]
}
レスポンスには、 要求された番地が最も近い既知の番地に一致するように修正されたことを示す、追加の高レベルの element-flag "houseNumberFallback": true
が含まれています。 番地フィールドのスコアが 1 ではなくなりましたが、 0.96 は 4 ポイント減少しました。これは、リクエストされた番地と返送された番地の間の数値の距離を表します。また、合計クエリースコアも削減されます。
/geocode
パラメータの詳細については、次のトピックを参照してください。 API リファレンス。