API一覧
https://api.mygeocode.com/v1/の下に8つのエンドポイントがあります。いずれもGETリクエストでクエリパラメーターを受け取り、JSONを返します。割り当て、エラーコード、料金はすべて共通です。
ジオコーディングAPI
GET /v1/forwardエンドポイント住所、地名、大まかな説明を送ると、座標、整形された住所、その各構成要素が返されます。
詳細と例逆ジオコーディングAPI
GET /v1/reverseエンドポイント緯度と経度を送ると、市、地域、郵便番号、国に分けられた最寄りの住所が返されます。
詳細と例住所オートコンプリートAPI
GET /v1/autocompleteエンドポイント入力中に住所の候補を表示します。すべての候補に座標が付いているため、2回目の呼び出しが必要になることはほとんどありません。
詳細と例IPv4検索API
GET /v1/ipv4エンドポイント任意のIPv4アドレス、または省略した場合は呼び出し元について、国、地域、市、座標、タイムゾーン、ネットワークの所有者を返します。
詳細と例IPv6検索API
GET /v1/ipv6エンドポイントIPv6アドレスについて同じ詳細情報に加え、そのアドレスが属するアナウンス済みのプレフィックスを返します。
詳細と例タイムゾーン検索API
GET /v1/timezoneエンドポイント任意の座標について、現在または指定したタイムスタンプでのIANAタイムゾーン名、UTCオフセット、夏時間の状態、現地時刻を返します。
詳細と例標高検索API
GET /v1/elevationエンドポイント1地点、または1回の呼び出しで最大100地点の海抜高度をメートル単位で返します。
詳細と例郵便番号検索API
GET /v1/postcodeエンドポイント郵便番号を地名、地域、座標に変換します。ほとんどの国のZIPコード、郵便番号、それに相当するものに対応しています。
詳細と例共通点
同じエンベロープ
すべてのレスポンスには、okまたはerrorのトップレベルのstatusがあります。エラーには機械で読み取れるcodeと、ログに記録できる説明文が含まれます。座標は常に10進数の度で、latとlonに入ります。
どこでも同じルール
どのアドレスからでも、キーなしで1日あたり2,500件の無料リクエストを利用できます。各キーにはそれぞれ1日あたり2,500件の無料リクエストがあり(同じネットワークからのキーなしのリクエストと共有)、それ以降はプリペイドクレジットまたはUnlimitedパッケージを利用します。従量課金のキーは直近24時間あたり2つのIPアドレス、Unlimitedキーは3つのIPアドレスから利用できます。認証をご覧ください。
同じ料金
逆ジオコーディングの料金はIP検索と同じです。各キーで1日あたり最初の2,500件は無料、それ以降はプリペイドクレジットから1件あたり€0.0001、またはUnlimitedキーなら月額€50です。料金をご覧ください。
1リクエストとして数えられるもの
ほとんどの場合、1回の呼び出しが1リクエストです。例外はバッチ呼び出しで、バッチ内の各項目がそれぞれ1件として数えられます。
| エンドポイント | カウント |
|---|---|
| ジオコーディング、逆ジオコーディング、郵便番号検索 | 返される結果の数にかかわらず、1回の呼び出しにつき1リクエスト |
| 住所オートコンプリート | 1回の呼び出しにつき1リクエスト。クライアント側でキー入力をデバウンスしてください。SDKではこれを自動で行います |
| IPv4とIPv6の検索 | 1回の呼び出しにつき1リクエスト、またはバッチではアドレスごとに1リクエスト |
| タイムゾーン検索 | 1回の呼び出しにつき1リクエスト |
| 標高検索 | 1地点につき1リクエスト。20地点を含む呼び出しは20件として数えられます |
| 互換ホスト(Google、Bing、HEREなど) | 裏側で使われているエンドポイントと同じルール |
| JavaScriptの互換ライブラリ: 地図の読み込みとタイル | 0。カウントされるのは、ジオコーダー、オートコンプリート、標高の呼び出しのみです |
まだ提供していないもの
ルート検索、距離行列、等時間圏はサービスに含まれておらず、今年の予定にもありません。カテゴリー別のスポット検索は検討中です。乗り換えにこれらのいずれかが必要な場合は、お知らせください。次に何を開発するかを決める参考になります。