ニュース

互換ホスト全体でオートコンプリートの候補に対応しました

住所オートコンプリートは、単純なジオコーディングの検索とは種類の異なるリクエストです。1つの完成した住所ではなく、通常は誰かがフォームに入力している最中の、部分的で変化していく入力に応答する必要があります。当社は互換ホストを拡張してこのパターンにも対応し、オートコンプリートを提供しているプロバイダーのオートコンプリートのリクエストの形に合わせました。

これは、同じ種類の部分的な住所のリクエストを直接処理する当社のネイティブの/v1/autocompleteエンドポイント(ドキュメントは/docs/address-autocomplete/)と並んで提供されます。互換ホストの元のプロバイダーがオートコンプリートも提供している場合は、当社の対応するホストでも同じリクエストの形に対応するようになりました。ただし、著作権、利用規約、プライバシーに関する文言は当社のものです。

オートコンプリートのリクエストの認証と料金は、プラットフォームの他のすべてのリクエストの種類とまったく同じルールに従います。キーはX-API-Keyヘッダー、Authorization: Bearerヘッダー、HTTP Basic認証、またはクエリパラメーターで認証でき、利用量は、その割り当てが呼び出し元のネットワークによるものでもキー自体によるものでも、同じ1日の無料の割り当てに対してカウントされます。無料の割り当てを超えた分のオートコンプリートのリクエストは、他のエンドポイントとまったく同様に、1リクエストあたり€0.0001でプリペイドクレジットから差し引かれるか、Unlimitedパッケージでカバーされます。

オートコンプリートのトラフィックは、一般的なジオコーディングの検索とはペースが異なる傾向があり、完成した送信ごとに1回ではなく、誰かがフォームに住所を入力するときにキーを押すたびに発生することがよくあります。そのため、ここでは割り当ての見える化が特に役立ちます。すべてのレスポンスに付く同じ割り当てのヘッダー(X-Quota-LimitX-Quota-UsedX-Quota-Free-Remainingなど)を使えば、連携側は消費量をリアルタイムで監視し、利用量が想定より多い場合にはリクエストのデバウンスを強めるなど、動作を調整できます。

すでに互換ホストをジオコーディングに使い、オートコンプリートは別のプロバイダーや2つ目の連携で個別に処理しているチームにとって、今回の更新は、オートコンプリートも同じホストと同じキーに移せる可能性があることを意味します。2種類のリクエストを2つに分けるのではなく、1つのアカウントにまとめられます。

どの互換ホストがオートコンプリートに対応しているかは、元のプロバイダーが対応しているかどうかによって決まります。それぞれの詳細は各ホストのページに記載されており、/compatibility/の一覧からアクセスできます。新しいキーには無料の割り当てがあるため、互換ホストでオートコンプリートを試すのに費用はかかりません。