Geocode.Farmの互換ホスト
Geocode.Farmのジオコーディングと逆ジオコーディングのエンドポイントが、v3とv4の両方のURL形式で、farm.mygeocode.comで応答します。STATUS、ACCOUNT、RESULTS、STATISTICSの各セクションを持つ入れ子のgeocoding_resultsオブジェクトを再現しているため、既存のパーサーはそのまま動作します。
ホスト名を1つ変えるだけ
| 元のホスト |
|
|---|---|
| 代わりに使うホスト | farm.mygeocode.com |
| キーのパラメーター | key（任意：どのアドレスでもキーなしで1日あたり2,500件のリクエストが使えます。クレジット、パッケージ、利用履歴を使うにはここにMy Geocodeのキーを入れてください） |
curl "https://www.geocode.farm/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_FARM_KEY"curl "https://farm.mygeocode.com/v3/json/forward/?addr=530+W+Main+St+Anoka+MN+55303&key=YOUR_MYGEOCODE_KEY"移行する理由
無料枠を目当てにGeocode.Farmを使い始めた方なら、こちらではキーごとに1日あたり2,500件の無料リクエストがあり、より多くの国で番地レベルの結果が得られます。カバレッジページをご覧ください。
キーの有無にかかわらず、無料枠は同じです。farm.mygeocode.comへのリクエストは、お使いのアドレスまたはキーが当社独自のエンドポイントで得ている1日あたり2,500件の無料リクエストと同じ枠から差し引かれます。それを超える分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedキーで月額€50です。登録に必要なのはメールアドレスだけです。
エンドポイント
レスポンスの例
上記のリクエストはこれを返します。フィールド名、入れ子構造、型はGeocode.Farmに準拠しています。その中身のデータだけが当社のものです。
{
"geocoding_results": {
"LEGAL_COPYRIGHT": {
"copyright_notice": "Copyright My Geocode. All rights reserved.",
"copyright_logo": "https://www.mygeocode.com/assets/img/logo.svg",
"terms_of_service": "https://www.mygeocode.com/terms/",
"privacy_policy": "https://www.mygeocode.com/privacy/"
},
"STATUS": {
"access": "KEY_VALID, ACCESS_GRANTED",
"status": "SUCCESS",
"address_provided": "530 W Main St Anoka MN 55303",
"result_count": 1
},
"ACCOUNT": {
"ip_address": "203.0.113.24",
"distribution_license": "NONE, UNLICENSED",
"usage_limit": "2500",
"used_today": "17",
"used_total": "9120",
"first_used": "2026-03-02"
},
"RESULTS": [
{
"result_number": 1,
"formatted_address": "530 W Main St, Anoka, MN 55303, USA",
"accuracy": "EXACT_MATCH",
"ADDRESS": {
"street_number": "530",
"street_name": "W Main St",
"locality": "Anoka",
"admin_2": "Anoka County",
"admin_1": "MN",
"postal_code": "55303",
"country": "United States"
},
"LOCATION_DETAILS": {
"elevation": "268.4",
"timezone_long": "America/Chicago",
"timezone_short": "CDT"
},
"COORDINATES": { "latitude": "45.203146", "longitude": "-93.396711" },
"BOUNDARIES": {
"northeast_latitude": "45.203296",
"northeast_longitude": "-93.396461",
"southwest_latitude": "45.202996",
"southwest_longitude": "-93.396961"
}
}
],
"STATISTICS": { "https_ssl": "ENABLED, SECURE" }
}
}詳細と相違点
1日あたり最初の2,500件のリクエストにはキーは不要です。My Geocodeのキーを使う場合は、GeoCode Farmのキーがあった場所、つまりkeyクエリパラメーターに入れてください。X-API-Keyヘッダー、Authorization: Bearer、HTTP Basic認証（キーをユーザー名として使用）もすべてのホストで使えるため、独自の方法で認証するクライアントライブラリも変更なしで動作し続けます。
レスポンス内の著作権表示、ライセンス名、利用規約とプライバシーのリンクは、元のプロバイダーのものではなく当社のものです。それ以外はすべて元の形式を保っています。
LEGAL_COPYRIGHTブロックには、当社の表示、利用規約とプライバシーのリンクが含まれます。ACCOUNTブロックは、その日の実際の割り当てと使用量を報告します。- 元のサービスにないため、一括処理のエンドポイントはありません。大量の処理には、
api.mygeocode.comのPOST /v1/forwardまたは/v1/reverseをお使いください（1回の呼び出しで最大100件、それぞれ1リクエスト）。
お使いのクライアントがここに記載されていないフィールドや動作に依存している場合は、お知らせください。互換性の差異はたいてい小さいため、すぐに修正されます。