よくある質問
よくいただく質問への短い回答です。お探しの質問がない場合はお問い合わせください。
はじめに
試すのにAPIキーやアカウントは必要ですか?
いいえ。どのアドレスも、キーもアカウントもなしで、すべてのエンドポイントとすべての互換ホストで1日あたり2,500件のリクエストを利用できます。自分専用のキー、利用履歴、プリペイドクレジット、Unlimitedパッケージが必要になったら新規登録してください(名前、メールアドレス、パスワード)。同じネットワークからのキーなしのリクエストとキー付きのリクエストは1日の割り当てを共有するため、アカウントを作っても無料の2,500件が2倍になるわけではありません。
新規登録には何が必要ですか?
名前、メールアドレス、パスワードです。それ以外は不要で、会社情報もカードも要りません。すぐにキーを追加で作成でき、クレジットやパッケージはいつでも好きなときに追加できます。
クレジットの仕組みを教えてください。
残高を前もってチャージします。金額は€5から自由に選べ、カードまたは暗号資産で支払えます。キーの1日の無料2,500件を超えたリクエストごとに、そこから€0.0001が差し引かれます。クレジットはすべての従量課金キーで共有され、期限はなく、自動的に請求されることもありません。残高がなくなると、無料枠を超えたリクエストはチャージするまで402で拒否されます。
支払い方法は何ですか?
Polarを通じたカード払い、またはNOWPaymentsを通じた暗号資産(Bitcoin、Ethereum、USDT、USDC、Litecoinなど多数)での支払いです。金額はチェックアウト時に確定し、支払いが確認されると反映されます。料金はすべてユーロ建てです。
Unlimitedパッケージには何が含まれますか?
すべてのエンドポイントとすべての互換ホストでリクエストごとの料金がかからないキーが、月額€50で提供されます。連続する24時間あたり最大3つのIPアドレスから使えます。パッケージごとに専用のキーがあるので、アプリケーションが複数ある場合は複数注文してください。料金をご覧ください。
紹介プログラムはありますか?
はい。ダッシュボードに紹介リンクがあります。そのリンクから登録した人が支払った請求書ごとに、その10%が、クレジットとは別に管理される紹介残高に入ります。いつでもクレジットに移すことができ、€20から暗号資産で出金することもできます。出金は手作業で処理され、トランザクションIDがダッシュボードに表示されます。
クーポンコードはありますか?
ときどきあります。チャージやパッケージの割引(割合または定額)や、ボーナスクレジットです。コードは請求書の作成時に入力するか、未払いの請求書であれば支払い前に入力してください。
アクセスと制限
無料枠はどのように数えられますか?
キーごと、UTCの1日ごとに、すべてのエンドポイントと互換ホストを合算して数えます。IPの一括検索と複数地点の標高の呼び出しは、項目ごとに1件として数えます。拒否されたリクエストとサーバーエラーは決して数えられません。
IP制限とは何ですか?
キーを最初に使ったアドレスは、それぞれ最初のリクエストから24時間スロットを占有します。従量課金キーのスロットは2つ、Unlimitedキーは3つです。スロットの24時間が終わると自動的に解放されるため、2台のサーバーが02:00に、3台目が04:00にキーを使った場合、翌日の02:00に2つのスロットが、04:00に3つ目が再び空きます。すべてのスロットが占有されているときに新しいアドレスからリクエストがあると、HTTP 403とコードkey_ip_limitで拒否されます。レスポンスには次のスロットが解放される時刻が示されます。より多くのマシンで使うには、キーを追加で作成するかパッケージを追加してください。
ブラウザやモバイルアプリからAPIを呼び出せますか?
CORSは有効ですが、クライアントのコードに含めたキーは誰でも見ることができ、数人の訪問者でIP制限に達してしまいます。APIは自分のサーバーから呼び出し、キーはそこに置いてください。JavaScript地図の互換ライブラリも同様です。タイルとライブラリの読み込みにはキーは不要ですが、ジオコーディングの呼び出しは自分のサーバーを経由させてください。
1日の割り当て以外にレート制限はありますか?
現在、固定の制限はありません。暴走したループや攻撃のように見える通信は速度を落とされることがあり、あなたのキーでそのようなことが起きた場合はお知らせします。1秒あたり何百ものリクエストを送らなくて済むように、一括エンドポイントを用意しています。
キーが漏洩した場合はどうなりますか?
ダッシュボードでキーを無効化し、新しいキーを作成してください。IP制限があるため、漏洩したキーはいずれにせよ1日に2台か3台のマシンからしか使えません。また、クレジットはプリペイドなので、誰もあなたがチャージすると決めた残高を超えて請求を膨らませることはできません。
データと精度
precisionフィールドは何を意味しますか?
返された地点が何を表しているかを示します。houseは建物または区画、streetは通りに沿って補間された位置、postcodeは郵便番号区域の中心、adminは市、地区、地域、国の中心です。番地を求めたのにpostcodeが返った場合は、その番地が見つからなかったということです。
番地レベルのデータがあるのはどの国ですか?
カバレッジのページに、249の国と地域それぞれで利用できる最も詳細なレベルが、地域とレベルで絞り込める形で掲載されています。データのリリースごとに更新されます。
どのようなデータソースを使っていますか?
公式の住所データと郵便データ、IP検索用のインターネット登録データとルーティングデータ、標準のタイムゾーンデータベース、全世界の地形モデル、そして当社独自の修正です。各ソースは取り込む前に他のソースと照合され、他のジオコーディングサービスから収集したデータは一切使っていません。
結果を保存したりキャッシュしたりできますか?
はい。結果はあなたのものとして、データベースに保存し、キャッシュし、他のプロバイダーの地図を含むどの地図にも表示できます。規約上の唯一の制限は、生データを独自のジオコーディングサービスとして再販することです。
データはどのくらいの頻度で更新されますか?
住所データは毎月、IPデータは毎週、タイムゾーンのルールはIANAがリリースを公開するたびに、標高データはより良い公開モデルが出たときに更新されます。
英語以外の言語に対応していますか?
langにISO 639-1コードを指定すると、データがある場合は地名がその言語で返り、ない場合は現地の名前になります。住所の書式は、その住所がある国の慣例に従います。
互換性
互換ホストは元のAPIの完全なコピーですか?
パス、パラメータ、レスポンスの形式は各プロバイダーの公開ドキュメントに一致しているため、既存のクライアントコードは変更なしでレスポンスを解析できます。データは当社のものなので値は異なり、プロバイダー固有の機能の一部は含まれていません。相違点は各互換性ページに記載しています。
Google Maps JavaScriptの互換ライブラリはGoogleの地図タイルを表示しますか?
いいえ。gapi.mygeocode.comのローダーはgoogle.maps名前空間を提供し、その背後では当社独自の地図タイル、ジオコーダー、オートコンプリート、標高サービスが動作します。Street View、Directions、Places Detailsは含まれていません。地図の読み込みは割り当てに数えられません。JavaScript互換ライブラリをご覧ください。
My GeocodeはGoogle、Microsoft、HERE、Mapboxと提携していますか?
いいえ。これらの名称はそれぞれの所有者に帰属し、ここでは当社が応答できる形式を示すためだけに使っています。
サポート
稼働率の保証はありますか?
セルフサービスのプランには契約上のSLAはありません。APIは複数のリージョンで運用しており、status.mygeocode.comでリアルタイムの状況を公開しています。書面によるSLAが必要な場合はご相談ください。
サポートを受けるにはどうすればよいですか?
support@mygeocode.comにメールでお問い合わせください。有料アカウントには1営業日以内に返信します。無料キーからのご質問にも、時間の許す限りお答えします。