リクエストの作成

HERE Geocoding and Search へのリクエストには、次の表に示す基本的な要素が含まれています。また、リソース固有のパラメータが含まれている場合もあります。

リクエストを取得

情報

ここでは、geocodeエンドポイントとsearchエンドポイントのほとんどが GET メソッドで呼び出されます。

要素 値 / 例 説明
メソッド GET
スキーム https
基本 URL [service].search.hereapi.com [service] のベース URL 。 エンドポイントには、関連するサービスの名前が付けられます。 たとえば、 Discover サービスはエンドポイント/discover.によって提供されます。
Discover サービスのベース URL は discover.search.hereapi.comです。
バージョン v1
エンドポイント /discover 自由形式のテキストクエリを使用して場所または場所を検索します
/autosuggest 検索クエリを作成するための提案を取得します
/geocode 住所を検索し、対応する地理座標を返します
/autocomplete 入力したキーストロークを有効なアドレスに完了します
/revgeocode 特定の地理座標に最も近い住所を検索します
/browse 名前または カテゴリ ID を使用してPlacesを検索します
/lookup 識別子を使用して、場所または他の場所オブジェクトを検索します
パラメーター [key]=[value]&... エンドポイント固有のパラメータ。
同じパラメータキーを繰り返し使用すると、400が返されます。
詳細については、 API リファレンス を参照してください。

たとえば、次の URI です

https://discover.search.hereapi.com/v1/discover?at=52.5228,13.4124&q=petrol+station&limit=5

次のパラメータを使用して、サービス / エンドポイントの Discover に到達するために使用されます。

  • atは、緯度52.5228と経度13.4124を設定します
  • q " ガソリンスタンド " に設定
  • limit 5 に設定します

リクエストを送信

リクエストヘッダー

重要なコンテキスト情報は、オプションの HTTP 要求ヘッダーを使用して API に渡されます。 サービスは、必要に応じて、確立され標準化されたヘッダーに依存し、追加のプライベートヘッダーでこれらを補完します。 これらの一部は結果に直接影響し、その他のものは検索結果の最適化に役立ちます。

次の表で、 http リクエストのヘッダーについて説明します。

ヘッダー名 説明
Accept レスポンスの Accept ヘッダーの仕様に使用できるメディアタイプを指定します。 サポートされている値は、 application/json 標準の JSON レスポンスになります。 この値もデフォルト値です。
日付 ユーザーの現地時間。例 : 「 Mon, 08 Aug 2011 11:58:17 GMT 」 ( 日付ヘッダーの指定を参照 )
ユーザー - エージェント クライアントユーザーエージェントを識別する文字列 ( 統計目的で使用される User-Agent ヘッダーの指定を参照 ) 。 HERE Geocoding and Search が Web ブラウザからアクセスされた場合、ブラウザはこの情報を自動的に送信します。 他のアプリケーションでは、アプリケーションによって明示的に設定する必要がある場合があります。
Accept-Encoding クライアントがレスポンスの圧縮転送を有効にできます。 サポートされている値は gzip 圧縮だけです。 クライアント アプリケーションの応答性とパフォーマンスに大きな影響が出る可能 性があるため、このオプションを使用することを強くお勧めします (Accept-Encoding ヘッダーの仕様を参照してください ) 。
X-Request-ID HERE Geocoding and Search に送信されたクエリーごとに異なる ID をクライアントが指定し、その {ID をレスポンスヘッダーに戻します。 これは、顧客自身のデータ マイニングとリクエストに対する応答の相関関係に関するログ分析や、潜在的な問題について HERE と通信する場合に役立ちます。

応答のカスタマイズ

HERE Geocoding and Search では、クエリ パラメーターを使用して応答をカスタマイズできます。 詳細については、専用の章を参照してください。

」に一致する結果は 件です

    」に一致する結果はありません