Geocode
/geocode
エンドポイントは、既知の住所、場所、地域、または管理エリアの地理座標を検索するために使用されます。クエリが不完全または部分的に正しくない場合も同様です。 また、住所の完全な文字列と住所の詳細も返します。
たとえば、住所の自由形式のテキストクエリ 5 Rue Daunou, 75000 Paris, France
は、次のリクエストで作成されます。
GET https://geocode.search.hereapi.com/v1/
geocode
?q=5+Rue+Daunou%2C+75000+Paris%2C+France
&apiKey={YOUR_API_KEY}
ユーザーの誤りにより、クエリの郵便番号が正しくありません。
上記のリクエストに対するレスポンスは、次のようになります。
{
"items": [
{
"title": "5 Rue Daunou, 75002 Paris, France",
"id": "here:af:streetsection:bI4Le6cyA.1mlQyLunYpjC:CggIBCCi-9SPARABGgE1KGQ",
"resultType": "houseNumber",
"houseNumberType": "PA",
"address": {
"label": "5 Rue Daunou, 75002 Paris, France",
"countryCode": "FRA",
"countryName": "France",
"stateCode": "IDF",
"state": "Île-de-France",
"county": "Paris",
"city": "Paris",
"district": "2e Arrondissement",
"street": "Rue Daunou",
"postalCode": "75002",
"houseNumber": "5"
},
"position": {
"lat": 48.86926,
"lng": 2.3321
},
"access": [
{
"lat": 48.86931,
"lng": 2.33215
}
],
"mapView": {
"west": 2.33073,
"south": 48.86836,
"east": 2.33347,
"north": 48.87016
},
"scoring": {
"queryScore": 0.97,
"fieldScore": {
"country": 1,
"city": 1,
"streets": [
1
],
"houseNumber": 1,
"postalCode": 0.82
}
}
}
]
}
レスポンスには、住所の地理的座標と正しい郵便番号の完全な住所文字列が含まれています。
各結果に次の高いレベルの要素が提供されます。
-
resultType
- HERE Geocoding and Search /geocode
は、 houseNumber
、place
locality
、 street
、
、administrativeArea
、addressBlock
、intersection
、postalCodePoint
のような複数のタイプのアイテムを返すことができます 。 -
houseNumberType
- 住所データのタイプ ( 住所の結果についてのみ返されます ): -
PA
- ポイントアドレス。位置は個々のポイントオブジェクトと一致します -
interpolated
- 住所範囲から位置情報が補間されました
-
title
–結果の代表的な文字列。 住所の場合は、住所の完全な文字列になります -
address
- 結果の詳細なAddress -
position
- 結果の代表的な地理的位置 (WGS 84) 。 これは、結果をマップに表示するために使用 -
access
- 結果へのアクセスの地理的位置 ( 例 : 入口 ) -
mapView
- 表示用に最適化された場所のバウンディング ボックス -
scoring
- /geocode
エンドポイントがスコアリング情報を返します。スコアリング情報は、元のクエリとの一致度を結果ごとに示します。 顧客のアプリケーションでは、ユースケースの「コスト」の誤りに応じて結果を承認または拒否するために使用できます -
id
- 結果オブジェクトの識別子。 その値を使用 して、/lookup
エンドポイントを介してまったく同じオブジェクトを取得
/geocode
パラメータの詳細については、『 API リファレンス』を参照してください。