POST AI agent ready /v1/address/validate

アドレス検証 API - 無料のアドレス検証

自由形式の住所文字列を送信すると、構造化コンポーネント (家番号、道路、都市、州、郵便番号、国)、GPS 座標、信頼スコア、および書式設定された住所が返されます。ジオコーディングを使用して、住所が存在し、解析可能であることを確認します。一致するものが見つからない場合は 404 を返します。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/address/validate \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

チェックアウト時に配送先住所を検証する

注文を処理する前に、顧客が入力した配送先住所を確認してください。タイプミス、不完全な住所、存在しない場所を、フルフィルメントチームに届く前に見つけます。配達の失敗と差出人への返送コストを削減します。

システム全体でアドレス形式を標準化する

CRM インポート、CSV アップロード、フォーム送信からのアドレスを一貫した構造化フォーマットに正規化します。分析と物流のために、データベースにクリーンな地理コード化された住所レコードが含まれていることを確認します。

部分的な住所入力からフォームフィールドに事前入力

ユーザーが住所を入力した後、検証の構造化コンポーネントを使用して、市区町村、州、郵便番号フィールドを自動入力します。フォームの放棄やデータ入力エラーを削減します。

Frequently asked questions

住所検証はどの程度正確ですか?

エンドポイントは OpenStreetMap ジオコーディングデータを使用します。北米とヨーロッパの有名なアドレスに強いです。地方または新しく建設された住所では、信頼度スコアが低かったり、結果が返されなかったりする場合があります。

信頼度スコアは何を意味しますか?

信頼スコア (0 ～ 1) は、入力がジオコーディング結果とどの程度一致するかを反映します。 0.7 を超えるスコアは、強力な一致を示します。 0.4 未満のスコアは、住所があいまいであるか、部分的に一致している可能性があることを示しています。

これにより、そのアドレスが実際の郵送先アドレスとして存在することが確認されますか?

いいえ。このエンドポイントは住所をジオコーディングし、構造化データを返します。これは、その場所がマッピングデータベースによって認識されることを確認するものであり、そこにメールを配信できることを確認するものではありません。 USPS 配達検証には、郵便サービス API が必要です。

国際住所を検証できますか?

はい。ジオコーディングサービスは世界中の住所をカバーします。応答内の country_code フィールドは、アドレスが解決された国を示します。

住所が曖昧すぎる場合はどうなりますか?

「メインストリート」のような曖昧な入力は、信頼性の低い結果を返したり、間違った場所と一致したりする可能性があります。より良い結果を得るには、都市、州、または国を含めてください。

Get your API key

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