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

リバース ジオコーディング API - 緯度/経度を住所に変換

緯度と経度のペアを送信し、対応する住所、都市、国、および表示名を受け取ります。 OpenStreetMap Nominatim サービスを利用しています。 デバイス、写真の EXIF データ、または地図のクリックからの GPS 座標を読み取り可能な位置に変換するのに役立ちます。

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

ユーザーが地図上にピンをドロップしたときに、読み取り可能な住所を表示します

ユーザーが地図上の場所をタップすると、座標がこのエンドポイントに送信され、ツールチップまたはサイドバーに住所が表示されます。 ユーザーがアドレスを手動で入力する手間を省きます。

EXIF GPS データからの場所名で写真にタグを付ける

写真の EXIF メタデータから緯度/経度を抽出し、逆ジオコーディングします。 フォトギャラリーに生の座標の代わりに「カリフォルニア州マウンテンビューで撮影」を表示します。

住所を使用して車両追跡データを強化する

車両追跡装置からの GPS 座標を住所に変換して、配車ログ、配達確認、ルート レポートを作成します。

Frequently asked questions

応答にはどのようなデータが含まれますか?
応答には、完全な display_name (番地)、短い住所フィールド、都市、国、および元の緯度/経度が含まれます。 詳細レベルは、その場所の OpenStreetMap の範囲によって異なります。
座標が海洋またはマップされていない領域にある場合はどうなりますか?
Nominatim が指定された座標のアドレスを見つけられない場合、API は 404 NOT_FOUND エラーを返します。 外洋、人里離れた荒野、南極大陸には住所データがない可能性があります。
結果はどの程度正確ですか?
精度は、そのエリアの OpenStreetMap データ密度に依存します。 都市では通常、建物レベルの精度が得られます。 田舎では、結果は最寄りの道路または村に解決される場合があります。
1 つのリクエストで複数の座標を逆ジオコーディングできますか?
いいえ。各リクエストは単一の座標ペアを処理します。 バッチ処理の場合は、並列リクエストを作成します。 匿名アクセスの場合は、1 リクエスト/秒という Nominatim レート制限を尊重します。
このエンドポイントは無料ですか?
はい。 匿名アクセスでは、1 分あたり 5 つのリクエストが許可されます。 API キーは、プラン階層に基づいてレート制限を引き上げます。 リクエストごとに料金はかかりません。

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