郵便番号と番地で住所を検索
このチュートリアルでは、番地と郵便番号を使用して住所を検索する方法を示します。
プロシージャ
郵便番号で地域が記述されていないが、同じ道路の一部の住所にのみ関連付けられている正確な郵便番号を持つ国では、番地と郵便番号のみを入力することで住所を検索できます。 輸送および小包配送のロジスティクスでは、これが一般的です。
/geocode
エンドポイントは、修飾クエリおよび freeform クエリを使用してこのユースケースをサポートします。
この機能は、カナダ、イギリス、オランダ、米国 of America ( ZIP+4 )、イスラエル、アイルランド、およびシンガポールで利用できます。 アイルランドおよびシンガポールでは、郵便番号が一意の番地まで正確に設定されているため、/geocode
エンドポイントでは郵便番号による住所検索もサポートされています。
たとえば、住所「 425 W Randolph St, Chicago, IL 606-1506, 米国」は、番地と郵便番号のみを指定することでも見つけることができます。
- houseNumber = 425
- 郵便番号 = 60606-1506
このクエリは、次の条件で作成できます。
GET https://geocode.search.hereapi.com/v1/
geocode
?qq=
houseNumber=425;
postalCode=60606-1506
&apiKey={YOUR_API_KEY}
または freeform クエリ :
GET https://geocode.search.hereapi.com/v1/
geocode
?q=425+60606-1506
&apiKey={YOUR_API_KEY}
次のパラメータが使用されます。
- Q - フリーテキストのクエリを入力します。
- qq - 適切なクエリの入力。適切なクエリは、フリーテキストクエリと似ていますが、構造化されています。 複数のサブパラメータをセミコロンで区切って指定できます。このサブパラメータを使用すると、クエリーのさまざまな側面を指定できます。
- apiKey - お客様の API キー 。
注
この要求は API キー 認証を使用します。 HERE platform の認証オプションの詳細については、『ID およびアクセス管理ガイド』を参照してください。
上記のリクエストへの応答には、番地と郵便番号の 2 つの一致するフィールドしかありませんが、結果タイプは住所全体です。
{
"items": [
{
"title": "425 W Randolph St, Chicago, IL 60606-1506, United States",
"id": "here:af:streetsection:hdZ6xBRUraY46IQZCqZidD:CgcIBCDMlOElEAEaAzQyNShk",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "425 W Randolph St, Chicago, IL 60606-1506, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "IL",
"state": "Illinois",
"county": "Cook",
"city": "Chicago",
"district": "West Loop",
"street": "W Randolph St",
"postalCode": "60606-1506",
"houseNumber": "425"
},
"position": {
"lat": 41.88432,
"lng": -87.63877
},
"access": [
{
"lat": 41.88449,
"lng": -87.63877
}
],
"mapView": {
"west": -87.63998,
"south": 41.88342,
"east": -87.63756,
"north": 41.88522
},
"scoring": {
"queryScore": 1,
"fieldScore": {
"houseNumber": 1,
"postalCode": 1
}
}
}
]
}
/geocode
パラメータの詳細については、次のトピックを参照してください。 API リファレンス。