Geocoder オートコンプリート API 開発者ガイド

はじめに

注 : このサービスは現在開発中ではありません。今後、このサービスの重要な修正のみを提供します。代わりに、新しいジオコーディング and Search API v7 サービスを使用できます。

このドキュメントでは、 Geocoder AutoComplete API について説明します。また、次の点

主な概念を説明する
例を示す
リソースおよびクエリパラメータを文書化する
応答構造およびデータ型を文書化する

このドキュメントに適用される利用規約については、「HERE Documentation License 」を参照してください。

Geocoder AutoComplete API とは何ですか ?

HERE Geocoder Autocomplete API は、 Web アプリケーションに統合できる REST API です。この機能を使用すると、キー入力を減らしてアドレス検索の結果を改善できます。空間フィルタおよびリージョンフィルタを使用すると、指定した国内または現在の場所の近くにある結果など、エンドユーザーとの関連性の高い提案を返すことができます。

Geocoder オートコンプリート API は、住所と ID をすべて取得します。その後、 Geocoder API を使用して、 ID に基づいて住所をジオコード化し、住所の地理座標を取得できます。

Geocoder AutoComplete API を使用する理由

次の表に、 Geocoder AutoComplete API の高レベルな使用例を示します。

表 1. HEREGeocoderオートコンプリート API の主な機能
フィーチャー	説明
キーストロークの数を減らします	エンドユーザーが最初の文字の後に入力を開始します。通常は、候補のリストが表示されます。エンドユーザーは、この一覧表で探している住所を確認し、その住所を選択してその場所を取得します。
エンドユーザーで住所のスペルをサポートします	エンドユーザーは、入力内容に関連するフィードバックを提案の形で即座に受け取ります。このフィードバックを使用して、入力内容をすばやく完了または修正できます。
アドレスのコンテキストについてエンドユーザーを支援します	エンドユーザーは、コンテキストに基づいてアドレス要求を完了する際に支援を受けます。たとえば、「 520 Hayes 」を「 520 Hayes St 」に入力できます。 520 は、アドレスコンテキストを提案します。しかし、ヘイズだけでもヘイズバレー地区を意味する可能性があります。 Praca Falcao は詳細な情報を提供する完全な住所を提案しており、「サンパウロ州の Gentil Falcao Pra General 」に記入できます。