ジオコード アドレス
このチュートリアルでは、テキストクエリを使用して地理的座標を返す方法について説明します。
プロシージャ
住所の地理的座標 240 Washington St., Boston
を返す自由形式のテキストクエリは、次のように作成されます。
GET https://geocode.search.hereapi.com/v1/
geocode
?q=240+Washington+St.%2C+Boston
&apiKey={YOUR_API_KEY}
次のパラメータが使用されます。
- Q - フリーテキストのクエリを入力します。
- apiKey - お客様の API キー 。
注
この要求は API キー 認証を使用します。 HERE platform の認証オプションの詳細については、『ID およびアクセス管理ガイド』を参照してください。
上記のリクエストに対するレスポンスは、次のようになります。
{
"items": [
{
"title": "240 Washington St, Boston, MA 02108-4603, United States",
"id": "here:af:streetsection:YCY1nQWrJ5eBrHv075VVOD:CggIBCDns4LfAhABGgMyNDAoZA",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "240 Washington St, Boston, MA 02108-4603, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "MA",
"state": "Massachusetts",
"county": "Suffolk",
"city": "Boston",
"district": "Downtown Boston",
"street": "Washington St",
"postalCode": "02108-4603",
"houseNumber": "240"
},
"position": {
"lat": 42.35814,
"lng": -71.05765
},
"access": [
{
"lat": 42.35815,
"lng": -71.05788
}
],
"mapView": {
"west": -71.05887,
"south": 42.35724,
"east": -71.05643,
"north": 42.35904
},
"scoring": {
"queryScore": 1,
"fieldScore": {
"city": 1,
"streets": [
1
],
"houseNumber": 1
}
}
},
{
"title": "240 Washington St, Boston, MA 02135-3508, United States",
"id": "here:af:streetsection:6SnFDsUujYAamxhLX-Vr1D:CgcIBCDRnLAhEAEaAzI0MChk",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "240 Washington St, Boston, MA 02135-3508, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "MA",
"state": "Massachusetts",
"county": "Suffolk",
"city": "Boston",
"district": "Brighton Center",
"street": "Washington St",
"postalCode": "02135-3508",
"houseNumber": "240"
},
"position": {
"lat": 42.34754,
"lng": -71.14943
},
"access": [
{
"lat": 42.34765,
"lng": -71.14925
}
],
"mapView": {
"west": -71.15065,
"south": 42.34664,
"east": -71.14821,
"north": 42.34844
},
"scoring": {
"queryScore": 1,
"fieldScore": {
"city": 1,
"streets": [
1
],
"houseNumber": 1
}
}
}
]
}
問い合わせ内容があいまいです。ボストンには、この名前の通りが 2 つあり、どちらも番地が 240 です。 そのため、住所、郵便番号、地区名の異なる 2 つの結果が応答に含まれます。
アドレスの結果には、次の上位レベルの要素が含まれます。
-
resultType
- houseNumber
-
houseNumberType
- アドレスデータのタイプ。 resultType
ある場合に返されます houseNumber
-
PA
- ポイントアドレス。位置は個々のポイントオブジェクトと一致します -
interpolated
- 住所範囲から位置情報が補間されました
-
title
–結果の代表的な文字列。 住所の場合は、住所の完全な文字列になります -
address
- 結果の詳細なAddress -
position
- 結果の代表的な地理的位置 (WGS 84) 。 これは、地図上で結果を検索または表示するために使用します -
access
- 結果へのアクセスの地理的位置 ( 例 : 入口 ) -
mapView
- 表示用に最適化された場所のバウンディング ボックス -
id
- 結果オブジェクトの識別子。 その値を使用 して、/lookup
エンドポイントを介してまったく同じオブジェクトを取得 -
scoring
- /geocode
エンドポイントがスコアリング情報を返します。スコアリング情報は、元のクエリとの一致度を結果ごとに示します。 顧客のアプリケーションでは、ユースケースの「コスト」の誤りに応じて結果を承認または拒否するために使用できます。
/geocode
パラメータの詳細については、次のトピックを参照してください。 API リファレンス。