Geocodioの互換ホスト
Geocodioは米国とカナダに特化しています。geocodio.mygeocode.comはgeocodeとreverseのエンドポイントに同じ形式で応答し、世界中の住所を受け付けます。
ホスト名を1つ変えるだけ
| 元のホスト |
|
|---|---|
| 代わりに使うホスト | geocodio.mygeocode.com |
| キーのパラメーター | api_key（任意：どのアドレスでもキーなしで1日あたり2,500件のリクエストが使えます。クレジット、パッケージ、利用履歴を使うにはここにMy Geocodeのキーを入れてください） |
変更前
curl "https://api.geocod.io/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_GEOCODIO_KEY"変更後
curl "https://geocodio.mygeocode.com/v1.7/geocode?q=1109+N+Highland+St,+Arlington+VA&api_key=YOUR_MYGEOCODE_KEY"エンドポイント
レスポンスの例
上記のリクエストはこれを返します。フィールド名、入れ子構造、型はGeocodioに準拠しています。その中身のデータだけが当社のものです。
geocodio.mygeocode.comからのレスポンス
{
"input": {
"address_components": {
"number": "1109",
"predirectional": "N",
"street": "Highland",
"suffix": "St",
"formatted_street": "N Highland St",
"city": "Arlington",
"state": "VA",
"country": "US"
},
"formatted_address": "1109 N Highland St, Arlington, VA"
},
"results": [
{
"address_components": {
"number": "1109",
"predirectional": "N",
"street": "Highland",
"suffix": "St",
"formatted_street": "N Highland St",
"city": "Arlington",
"county": "Arlington County",
"state": "VA",
"zip": "22201",
"country": "US"
},
"formatted_address": "1109 N Highland St, Arlington, VA 22201",
"location": { "lat": 38.886665, "lng": -77.094733 },
"accuracy": 1,
"accuracy_type": "rooftop",
"source": "My Geocode"
}
]
}詳細と相違点
1日あたり最初の2,500件のリクエストにはキーは不要です。My Geocodeのキーを使う場合は、Geocodioのキーがあった場所、つまりapi_keyクエリパラメーターに入れてください。X-API-Keyヘッダー、Authorization: Bearer、HTTP Basic認証（キーをユーザー名として使用）もすべてのホストで使えるため、独自の方法で認証するクライアントライブラリも変更なしで動作し続けます。
- 一括リクエストが使えます：JSONのリストまたはオブジェクトをPOSTしてください。回答は
resultsで、入力ごとに1件のエントリがあり、それぞれに元のquery（オブジェクトをPOSTした場合はそのオブジェクトのキー）と個別のresponseが含まれます。 - 逆ジオコーディングの一括処理も同じ形式で、入力には
lat,lon形式の文字列を使います。 - 1回の一括処理ではGeocodioと同様に最大10,000件のエントリを受け付け、Geocodioの数え方と同じく各エントリが1件の検索として数えられます。その日の残りの割り当てを超える一括処理は、一部だけ処理されるのではなく、Geocodioのエラーで全体が拒否されます。
お使いのクライアントがここに記載されていないフィールドや動作に依存している場合は、お知らせください。互換性の差異はたいてい小さいため、すぐに修正されます。