PositionStackの互換ホスト
PositionStackのジオコーディングと逆ジオコーディングのエンドポイントが、positionstack.mygeocode.comで同じdata配列とフラットなフィールド名で応答します。こちらでは無料を含むすべてのプランでHTTPSが使えます。
ホスト名を1つ変えるだけ
| 元のホスト |
|
|---|---|
| 代わりに使うホスト | positionstack.mygeocode.com |
| キーのパラメーター | access_key（任意：どのアドレスでもキーなしで1日あたり2,500件のリクエストが使えます。クレジット、パッケージ、利用履歴を使うにはここにMy Geocodeのキーを入れてください） |
curl "http://api.positionstack.com/v1/forward?access_key=YOUR_POSITIONSTACK_KEY&query=350+5th+Avenue+New+York"curl "https://positionstack.mygeocode.com/v1/forward?access_key=YOUR_MYGEOCODE_KEY&query=350+5th+Avenue+New+York"移行する理由
PositionStackの無料プランはHTTPのみで、月単位の上限があります。こちらではすべてがHTTPSで、どのキーの無料枠も毎日リセットされます。
キーの有無にかかわらず、無料枠は同じです。positionstack.mygeocode.comへのリクエストは、お使いのアドレスまたはキーが当社独自のエンドポイントで得ている1日あたり2,500件の無料リクエストと同じ枠から差し引かれます。それを超える分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedキーで月額€50です。登録に必要なのはメールアドレスだけです。
エンドポイント
レスポンスの例
上記のリクエストはこれを返します。フィールド名、入れ子構造、型はPositionStackに準拠しています。その中身のデータだけが当社のものです。
{
"data": [
{
"latitude": 40.748428,
"longitude": -73.985654,
"type": "address",
"name": "350 5th Avenue",
"number": "350",
"postal_code": "10118",
"street": "5th Avenue",
"confidence": 1,
"region": "New York",
"region_code": "NY",
"county": "New York County",
"locality": "New York",
"administrative_area": null,
"neighbourhood": "Midtown",
"country": "United States",
"country_code": "USA",
"continent": "North America",
"label": "350 5th Avenue, New York, NY, USA"
}
]
}詳細と相違点
1日あたり最初の2,500件のリクエストにはキーは不要です。My Geocodeのキーを使う場合は、positionstackのキーがあった場所、つまりaccess_keyクエリパラメーターに入れてください。X-API-Keyヘッダー、Authorization: Bearer、HTTP Basic認証（キーをユーザー名として使用）もすべてのホストで使えるため、独自の方法で認証するクライアントライブラリも変更なしで動作し続けます。
- ジオコーディングと逆ジオコーディングのどちらも、
data配列の形式で応答します。 - 元のサービスにないため、一括処理のエンドポイントはありません。大量の処理には、
api.mygeocode.comのPOST /v1/forwardまたは/v1/reverseをお使いください（1回の呼び出しで最大100件、それぞれ1リクエスト）。
お使いのクライアントがここに記載されていないフィールドや動作に依存している場合は、お知らせください。互換性の差異はたいてい小さいため、すぐに修正されます。