LocationIQの互換ホスト
LocationIQのsearch、reverse、autocomplete、timezoneの各エンドポイントが、locationiq.mygeocode.comで応答します。display_name、address、boundingboxを持つNominatim形式のJSON配列が、形を変えずに返ります。
ホスト名を1つ変えるだけ
| 元のホスト |
|
|---|---|
| 代わりに使うホスト | locationiq.mygeocode.com |
| キーのパラメーター | key（任意：どのアドレスでもキーなしで1日あたり2,500件のリクエストが使えます。クレジット、パッケージ、利用履歴を使うにはここにMy Geocodeのキーを入れてください） |
変更前
curl "https://us1.locationiq.com/v1/search?key=YOUR_LOCATIONIQ_KEY&q=Sydney+Opera+House&format=json"変更後
curl "https://locationiq.mygeocode.com/v1/search?key=YOUR_MYGEOCODE_KEY&q=Sydney+Opera+House&format=json"エンドポイント
| locationiq.mygeocode.comのパス | 機能 | バックエンド |
|---|---|---|
/v1/search?q=...&format=json | ジオコーディング | ジオコーディング |
/v1/reverse?lat=...&lon=...&format=json | 逆ジオコーディング | 逆ジオコーディング |
/v1/autocomplete?q=... | オートコンプリート | 住所オートコンプリート |
/v1/timezone?lat=...&lon=... | タイムゾーン | タイムゾーン検索 |
レスポンスの例
上記のリクエストはこれを返します。フィールド名、入れ子構造、型はLocationIQに準拠しています。その中身のデータだけが当社のものです。
locationiq.mygeocode.comからのレスポンス
[
{
"place_id": "mg.au.poi.3b7e91c0",
"licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
"osm_type": "way",
"osm_id": 4245932,
"boundingbox": ["-33.8576", "-33.8560", "151.2141", "151.2166"],
"lat": "-33.8567844",
"lon": "151.2152967",
"display_name": "Sydney Opera House, Bennelong Point, Sydney, New South Wales, 2000, Australia",
"class": "tourism",
"type": "attraction",
"importance": 0.8543,
"icon": "https://www.mygeocode.com/assets/img/icons/tourism.png",
"address": {
"name": "Sydney Opera House",
"road": "Bennelong Point",
"suburb": "Sydney",
"city": "Sydney",
"state": "New South Wales",
"postcode": "2000",
"country": "Australia",
"country_code": "au"
}
}
]詳細と相違点
1日あたり最初の2,500件のリクエストにはキーは不要です。My Geocodeのキーを使う場合は、LocationIQのキーがあった場所、つまりkeyクエリパラメーターに入れてください。X-API-Keyヘッダー、Authorization: Bearer、HTTP Basic認証（キーをユーザー名として使用）もすべてのホストで使えるため、独自の方法で認証するクライアントライブラリも変更なしで動作し続けます。
- タイムゾーンのエンドポイントは稼働中で、名前、オフセット、夏時間フラグ、両方の名称を返します。
- 元のサービスにないため、一括処理のエンドポイントはありません。大量の処理には、
api.mygeocode.comのPOST /v1/forwardまたは/v1/reverseをお使いください（1回の呼び出しで最大100件、それぞれ1リクエスト）。
お使いのクライアントがここに記載されていないフィールドや動作に依存している場合は、お知らせください。互換性の差異はたいてい小さいため、すぐに修正されます。