ジオコード place
このチュートリアルでは、既知の場所の地理座標を検索する方法を示します。
プロシージャ
/geocode
エンドポイントでは、既知の場所の地理座標の検索もサポートされています。 これにより、たとえば、自宅の住所と同じように、事業所名を含むジオ コーディングの事業所住所を使用できます。
Starbucks
のジオ座標を返す自由形式のテキストクエリは 240 Washington St., Boston
、次の要素で構成されています。
GET https://geocode.search.hereapi.com/v1/
geocode
?q=Starbucks%2C+240+Washington+St.%2C+Boston
&apiKey={YOUR_API_KEY}
次のパラメータが使用されます。
- Q - フリーテキストのクエリを入力します。
- apiKey - お客様の API キー 。
注
この要求は API キー 認証を使用します。 HERE platform の認証オプションの詳細については、『ID およびアクセス管理ガイド』を参照してください。
問い合わせ内容はあいまいではありません。ボストンには、この名前の通りが 2 つあり、どちらも番地が 240 です。 1 つはボストンのダウンタウン、もう 1 つはボストン近郊に位置しています。 しかし Starbucks
、ボストンのダウンタウンにあるこの住所の近くに位置しています。
上記のリクエストに対する応答は、 1 つの結果で構成され、次のようになります。
{
"items": [
{
"title": "Starbucks",
"id": "here:pds:place:840drt2z-d9bbdad5d12d410fa597ff9a57f0eef4:CggIBCDns4LfAhABGgMyNDA",
"resultType": "place",
"address": {
"label": "Starbucks, 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
},
"categories": [
{
"id": "100-1100-0010",
"name": "Coffee Shop",
"primary": true
}
],
"foodTypes": [
{
"id": "800-058",
"name": "Snacks & Beverages",
"primary": true
}
],
"scoring": {
"queryScore": 1,
"fieldScore": {
"city": 1,
"streets": [
1
],
"houseNumber": 1,
"placeName": 1
}
}
}
]
}
配置結果には、次の高レベルのエレメントが含まれます。
-
resultType
- place
-
title
–場所の名前 -
address
- 検索結果の詳細な住所 ( 住所の完全な郵便番号を含む ) -
position
- 結果の代表的な地理的位置 (WGS 84) 。 これは、結果をマップに表示するために使用 -
access
- 結果へのアクセスの地理的位置 ( 例 : 入口 ) -
mapView
- 表示用に最適化された場所のバウンディング ボックス -
id
- 結果オブジェクトの識別子。 その値を使用 して、/lookup
エンドポイントを介してまったく同じオブジェクトを取得 -
categories
- place
結果のカテゴリ ID のリスト -
foodTypes
- 食品の準備 / 提供のplace
結果を得るためのFoodタイプ ID のリスト -
scoring
- /geocode
エンドポイントがスコアリング情報を返します。スコアリング情報は、元のクエリとの一致度を結果ごとに示します。 エンド ユーザーアプリケーションでは、ユースケースの「コスト」の誤りに応じて、このエラーを受け入れたり拒否したりするために使用できます。
/geocode
エンドポイントでは、完全な番地、空間参照、または少なくとも一部の住所 ( 番地、地域名、郵便番号 ) など、リクエストによって妥当な場所のコンテキストが提供された場合にのみ、 Place の結果が許可されます。 ローカル性コンテキストなしで名前を配置するだけでは十分ではありません。 たとえば、クエリ McDonald, Germany
を特定の場所に解決することはできません。 例外-国の重要な場所。 などのクエリ Eiffel Tower
は /geocode
、そのエンドポイントが Place の結果を返すのに十分な固有のものです。
/geocode
パラメータの詳細については、次のトピックを参照してください。 API リファレンス。