コンテンツへスキップ
POST AI agent ready /v1/geo/geocode

ジオコーディング API - 住所を緯度/経度座標に変換する

住所文字列 (番地、都市名、ランドマーク、または郵便番号) を送信し、対応する緯度、経度、表示名、および場所の種類を受け取ります。 Powered by the OpenStreetMap Nominatim service. Supports worldwide addresses in any language.

Parameters

stringrequired

The address or place name to geocode.

Code examples

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

When to use this API

ユーザーが入力した住所をアプリ内のマップ ピンに変換する

ユーザーがフォームに住所を入力すると、それがジオコーディングされ、地図上にマーカーが配置されます。 これにより、多くのユースケースで、有料の Google Maps Geocoding API が必要なくなります。

CRM またはデータベースのレコードを座標で強化します

顧客住所をバッチジオコーディングして緯度/経度フィールドを追加します。 この座標は、近隣検索、配達ゾーンの計算、または地理レポートに使用します。

Frequently asked questions

このエンドポイントを強化するジオコーディング プロバイダーは何ですか?
OpenStreetMap の公称。 結果は OpenStreetMap のデータ品質を反映しており、ほとんどの国で優れていますが、地方や発展途上地域では詳細が劣る場合があります。
このエンドポイントは英語以外のアドレスをサポートしていますか?
はい。 Nominatim は、ほとんどの言語とスクリプトのアドレスをサポートします。 日本語、アラビア語、キリル文字、または OpenStreetMap でサポートされている任意の言語で住所を送信できます。
住所があいまいな場合、または見つからない場合はどうなりますか?
一致する結果がない場合、API は 404 NOT_FOUND エラーを返します。 あいまいなアドレスの場合、API は上位に一致するアドレスを返します。 正確性を高めるために、できるだけ具体的に (都市、州、国を含めて) ください。
ジオコーディング リクエストにレート制限はありますか?
匿名アクセスでは、1 分あたり 5 つのリクエストが許可されます。 API キーを使用すると、レート制限はプランによって決まります。 Nominatim 自体には 1 リクエスト/秒ポリシーがあり、このエンドポイントはこれを尊重します。
このエンドポイントを使用して IP アドレスをジオコーディングできますか?
いいえ。このエンドポイントは番地を座標に変換します。 IP 地理位置情報の場合は、/v1/ip/lookup エンドポイントを使用します。

Get your API key

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