郵便番号検索API

郵便番号を、それが属する場所（町や市、地域、国、座標）に変換します。米国のZIPコード、英国のポストコード、カナダの郵便番号、インドのPINコード、日本の郵便番号、そして160か国のそれらに相当するものに対応しています。住所フォームで単独でも役立ち、郵便番号しか分からないときにレコードの位置を素早く安価に特定する手段にもなります。

GEThttps://api.mygeocode.com/v1/postcode?code=...&country=...

デモで試す完全なリファレンス

例

リクエスト

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=10001&country=us"

# UK postcodes resolve to a street or a handful of buildings
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/postcode?code=SW1A+1AA&country=gb"

分かっている場合は必ずcountryを送ってください。郵便番号は国をまたいで一意ではありません：10001はニューヨークにも、ほかのいくつかの国にもあります。国を指定しないと、その番号が存在するすべての国の結果が、人口の多い順に返ります。

書式には寛容です。スペース、ハイフン、大文字・小文字は正規化されるため、sw1a1aaとSW1A 1AAは同じものとして扱われます。

レスポンス

{
  "status": "ok",
  "postcode": "10001",
  "country_code": "US",
  "results": [
    {
      "postcode": "10001",
      "place": "New York",
      "region": "New York",
      "region_code": "NY",
      "country": "United States",
      "country_code": "US",
      "lat": 40.7484,
      "lon": -73.9967
    }
  ]
}

返される内容

フィールド	意味
`results`	その番号がカバーする場所ごとに1件のエントリです。ほとんどの番号は1つの場所に対応しますが、農村部の番号には複数の村をカバーし、複数のエントリを返すものもあります。
`place`	郵便当局が使用している町、市、または地域の名前です。
`region`, `region_code`	州、県、または郡と、存在する場合はそのISO 3166-2コードです。
`lat`, `lon`	郵便当局が公開している場合はその番号の代表地点、それ以外の場合は当社が保有するその番号の住所の中心点です。

利用シーン

住所フォーム

最初に郵便番号を尋ね、市と地域を自動入力します。ユーザーの入力が減り、間違いも少なくなります。

配送エリアと料金設定

郵便番号の座標から、どの拠点が顧客を担当するか、どの配送料金帯が適用されるかを決めます。

調査データの地図化

郵便番号しか記録していないデータセットも郵便番号の精度で地図化でき、プライバシーの観点からもそれで十分な場合がよくあります。

料金と制限

1回の呼び出しは、その番号がカバーする場所の数にかかわらず1リクエストです。どのキーにも1日あたり2,500件の無料リクエストがあり、それを超えるとプリペイドクレジットから1件あたり€0.0001、Unlimitedキー（月額€50）なら追加料金はかかりません。料金。番地まで含む完全な住所には、代わりにジオコーディングをお使いください。