MapQuest Geocodingの互換ホスト
MapQuestのライセンス版とOpen Data版の両方のジオコーディングエンドポイントが、mapquest.mygeocode.comで応答します。info、options、resultsのエンベロープと、MapQuestクライアントが解析するadminArea1からadminArea6までの命名もそのままです。
ホスト名を1つ変えるだけ
| 元のホスト |
|
|---|---|
| 代わりに使うホスト | mapquest.mygeocode.com |
| キーのパラメーター | key（任意：どのアドレスでもキーなしで1日あたり2,500件のリクエストが使えます。クレジット、パッケージ、利用履歴を使うにはここにMy Geocodeのキーを入れてください） |
curl "https://www.mapquestapi.com/geocoding/v1/address?key=YOUR_MAPQUEST_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"curl "https://mapquest.mygeocode.com/geocoding/v1/address?key=YOUR_MYGEOCODE_KEY&location=233+S+Wacker+Dr,+Chicago,+IL"移行する理由
MapQuestの無料枠は年々縮小しており、開発者向けプランは月額の段階制です。こちらでは1日あたり2,500件が無料で、それ以降はリクエスト単位または定額の料金です。
キーの有無にかかわらず、無料枠は同じです。mapquest.mygeocode.comへのリクエストは、お使いのアドレスまたはキーが当社独自のエンドポイントで得ている1日あたり2,500件の無料リクエストと同じ枠から差し引かれます。それを超える分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedキーで月額€50です。登録に必要なのはメールアドレスだけです。
エンドポイント
| mapquest.mygeocode.comのパス | 機能 | バックエンド |
|---|---|---|
/geocoding/v1/address?location=... | ジオコーディング | ジオコーディング |
/elevation/v1/profile?latLngCollection=lat,lng,lat,lng（shapeFormat=cmp/cmp6、unit=m|f、JSONのPOSTにも対応） | 標高プロファイル | 標高検索 |
/geocoding/v1/reverse?location=lat,lng | 逆ジオコーディング | 逆ジオコーディング |
/geocoding/v1/batch?location=...&location=... | 一括ジオコーディング | ジオコーディング |
レスポンスの例
上記のリクエストはこれを返します。フィールド名、入れ子構造、型はMapQuestに準拠しています。その中身のデータだけが当社のものです。
{
"info": {
"statuscode": 0,
"copyright": { "text": "My Geocode", "imageUrl": "https://www.mygeocode.com/assets/img/logo.svg", "imageAltText": "My Geocode" },
"messages": []
},
"options": { "maxResults": -1, "thumbMaps": false, "ignoreLatLngInput": false },
"results": [
{
"providedLocation": { "location": "233 S Wacker Dr, Chicago, IL" },
"locations": [
{
"street": "233 S Wacker Dr",
"adminArea6": "Loop",
"adminArea6Type": "Neighborhood",
"adminArea5": "Chicago",
"adminArea5Type": "City",
"adminArea4": "Cook County",
"adminArea4Type": "County",
"adminArea3": "IL",
"adminArea3Type": "State",
"adminArea1": "US",
"adminArea1Type": "Country",
"postalCode": "60606",
"geocodeQualityCode": "P1AAA",
"geocodeQuality": "POINT",
"dragPoint": false,
"sideOfStreet": "R",
"linkId": "0",
"unknownInput": "",
"type": "s",
"latLng": { "lat": 41.878876, "lng": -87.635918 },
"displayLatLng": { "lat": 41.878876, "lng": -87.635918 }
}
]
}
]
}詳細と相違点
1日あたり最初の2,500件のリクエストにはキーは不要です。My Geocodeのキーを使う場合は、MapQuestのキーがあった場所、つまりkeyクエリパラメーターに入れてください。X-API-Keyヘッダー、Authorization: Bearer、HTTP Basic認証（キーをユーザー名として使用）もすべてのホストで使えるため、独自の方法で認証するクライアントライブラリも変更なしで動作し続けます。
レスポンス内の著作権表示、ライセンス名、利用規約とプライバシーのリンクは、元のプロバイダーのものではなく当社のものです。それ以外はすべて元の形式を保っています。
- 標高プロファイルでは、
latLngCollectionを座標の組のまま、またはcmpかcmp6で圧縮したパスとして受け付け、メートルまたはフィート単位で、GETでもPOSTでも利用できます。 - 一括ジオコーディングは、
location=パラメーターの繰り返し、またはPOSTしたlocationsリストで動作し、入力ごとに1件のエントリで応答します。 - 1回の一括処理では最大100か所を受け付け、MapQuestと同様に1か所につき1リクエストとして数えます。
- データのない地点は、MapQuestと同様に高さ-32768として報告されます。
お使いのクライアントがここに記載されていないフィールドや動作に依存している場合は、お知らせください。互換性の差異はたいてい小さいため、すぐに修正されます。