逆ジオコーディングAPI

緯度と経度を送ると、通り、市、地域、郵便番号、国に分けられた最寄りの住所と、その住所が送信した地点からどれだけ離れているかが返ります。市や国だけが必要な場合は、levelでより粗い結果を指定できます。

GEThttps://api.mygeocode.com/v1/reverse?lat=...&lon=...

例

リクエスト

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"

この地点はエッフェル塔の基部から数メートルの場所です。レスポンスは最寄りの住所で、distance_mがそれが12メートル離れていることを示します。たとえば公園内の地点で最寄りの住所が400メートル離れていれば、それも分かるので、代わりに地区名を表示すると判断できます。

level=cityを追加すると住所を飛ばして地域名を直接取得でき、level=countryなら国を高速に判定できます。

レスポンス

{
  "status": "ok",
  "lat": 48.8584,
  "lon": 2.2945,
  "result": {
    "formatted": "5 Avenue Anatole France, 75007 Paris, France",
    "lat": 48.85837,
    "lon": 2.29448,
    "distance_m": 12,
    "type": "address",
    "precision": "house",
    "components": {
      "house_number": "5",
      "road": "Avenue Anatole France",
      "suburb": "7th Arrondissement",
      "city": "Paris",
      "state": "Ile-de-France",
      "postcode": "75007",
      "country": "France",
      "country_code": "fr"
    }
  }
}

返される内容

フィールド	意味
`result.formatted`	その国の形式で表した最寄りの住所です。
`result.lat`, `result.lon`	送信した地点ではなく、住所そのものの位置です。
`result.distance_m`	送信した地点と住所の間の距離（メートル）です。大きな値は、実際には住所のある場所にいないことを意味します。
`result.precision`	その国でその地点の近くに何が存在するかに応じて、`house`、`street`、`postcode`、`admin`のいずれかです。
`result.components`	ジオコーディングと同じキーを持つ住所の構成要素です。
`result`が`null`の場合	その地点から5km以内に何もありません。外洋や南極大陸などです。ステータスは`ok`のままです。

利用シーン

GPS地点へのラベル付け

デバイスの位置を、ログ、領収書、写真のキャプション用に「Avenue Anatole France 5付近」のような表記に変換します。distance_mを使って「所在地」と「付近」を切り替えます。

地域に合わせた既定値

level=countryを使って、訪問者の位置から国、通貨、言語をあらかじめ入力します。座標がない場合はIP検索と組み合わせてください。

配送と現場作業

ドライバーが実際に停車した場所を住所に変換し、注文で指定された行き先と比較します。

料金と制限

1回の呼び出しは1リクエストです。どのキーにも1日あたり2,500件の無料リクエストがあり、それを超えるとプリペイドクレジットから1件あたり€0.0001、Unlimitedキー（月額€50）なら追加料金はかかりません。料金。互換ホストはGoogle、Nominatim、Mapbox、その他の形式で逆ジオコーディングのリクエストに応答します。