コンテンツへスキップ
POST AI agent ready /v1/address/autocomplete

住所オートコンプリート API - 無料の住所提案

部分的な住所クエリを送信すると、番地、都市、州、国、および GPS 座標を含む最大 10 件の構造化された住所の候補が返されます。 住所フィールドを入力しながら検索できるように設計されています。 ローカライズされた結果の言語設定をサポートします。

Parameters

stringrequired

Partial address to autocomplete.

number

Max suggestions to return (1-10).

string

ISO 639-1 language code for results.

Code examples

curl -X POST https://api.botoi.com/v1/address/autocomplete \
  -H "Content-Type: application/json" \
  -d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'

When to use this API

入力時に検索できる住所フィールドを構築する

このエンドポイントを、デバウンスされたリクエストを含む入力フィールドに接続します。 ユーザーが入力すると、一致するアドレスのドロップダウンが表示されます。 いずれかを選択すると、番地、都市、州、および郵便番号のフィールドが自動的に入力されます。

モバイルチェックアウトでのフォームエラーを減らす

モバイル ユーザーはデスクトップ ユーザーよりもタイプミスを多くします。 オートコンプリートの提案により、アドレスを完全に入力する代わりに正しいアドレスをタップできるため、フォームの入力時間とエラー率が削減されます。

地図アプリケーションでの電源位置検索

オートコンプリートを使用すると、ユーザーが名前または住所で場所を検索できるようになります。 各候補には座標が含まれているため、別のジオコーディング呼び出しを行わなくても、選択した結果を地図の中心に配置できます。

Frequently asked questions

どれくらいの提案をリクエストできますか?
制限パラメータを 1 ～ 10 に設定します。デフォルトは 5 です。API は、見つかった一致結果の最大数を返しますが、制限よりも少ない場合があります。
どの言語がサポートされていますか?
任意の ISO 639-1 言語コードを渡します (例: ドイツ語の場合は「de」、日本語の場合は「ja」)。 翻訳が利用可能な場合、結果は要求された言語で返されます。 それ以外の場合は、ローカル言語に戻ります。
クエリの最小長はありますか?
クエリには少なくとも 1 つの非空白文字が必要です。 クエリが短いほど、より幅広い結果が返されます。 最適な提案を得るには、少なくとも 3 ～ 4 文字を送信してください。
これは会社名や番地にも適用できますか?
どちらにも効果があります。 ジオコーダーは、番地、近隣地域、都市、および名前付きの場所を照合します。 マッピング データベースの範囲に応じて、ビジネス名が一致する場合と一致しない場合があります。
応答時間はどれくらいですか?
通常の応答時間は、ジオコーディング サービスの負荷に応じて 100 ～ 300 ミリ秒です。 スムーズな先行入力エクスペリエンスを実現するには、ユーザーが入力を停止してから 150 ～ 200 ミリ秒後にリクエストをデバウンスして実行します。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs