他のジオコーディングAPIの互換ホスト
ジオコーディングのプロバイダーを切り替えるには、通常レスポンスを解析するコードを書き直す必要があります。私たちは、そうしなくて済むようにしたいと考えています。以下の各ホストは、1つのプロバイダーのAPIのパスとパラメーターを受け付け、そのプロバイダーのJSON形式で、当社のデータを使って応答します。ホスト名を変更し、古いキーがあった場所にMy Geocodeのキーを入れれば、あとはリリースするだけです。無料のキーは、お名前とメールアドレスがあれば1分で取得できます。
以下からお使いのプロバイダーを探してください
各ページには、元のホスト、置き換え先のホスト、対応しているすべてのパスが記載されています。
設定のホストを変更する
たとえば
maps.googleapis.comはgapi.mygeocode.comになります。パスとパラメーターはそのままです。キーを差し替える
古いキーが使っていたのと同じパラメーターにMy Geocodeのキーを入れてください。無料のキーでは1日あたり2,500件のリクエストが使えます。
RESTホスト
Googleマップ・プラットフォーム（Google Maps Platform）
maps.googleapis.com → gapi.mygeocode.comGeocoding、Places Autocomplete、Time Zone、Elevationの各ウェブサービスが、gapi.mygeocode.comの同じパスで、Googleが返すのと同じJSON構造で応答します。
エンドポイントとレスポンス形式Bing Maps RESTサービス
dev.virtualearth.net → bing.mygeocode.comMicrosoftはBing Maps for Enterpriseの提供を終了します。
エンドポイントとレスポンス形式HEREジオコーディング・検索（HERE Geocoding and Search）
geocode.search.hereapi.com, revgeocode.search.hereapi.com, autosuggest.search.hereapi.com, autocomplete.search.hereapi.com → here.mygeocode.comHEREは検索APIを複数のホストに分けています。
エンドポイントとレスポンス形式Mapbox Geocoding
api.mapbox.com → mapbox.mygeocode.com旧版のv5 Geocoding APIと現行のv6エンドポイントの両方が、mapbox.mygeocode.comで応答します。
エンドポイントとレスポンス形式Geocode.Farm
api.geocode.farm, www.geocode.farm → farm.mygeocode.comGeocode.Farmのジオコーディングと逆ジオコーディングのエンドポイントが、v3とv4の両方のURL形式で、farm.mygeocode.comで応答します。
エンドポイントとレスポンス形式OpenStreetMap Nominatim
nominatim.openstreetmap.org → osm.mygeocode.com公開Nominatimインスタンスは、リクエストを1秒あたり最大1件とし、大量の利用をしないよう求めています。
エンドポイントとレスポンス形式OpenCage
api.opencagedata.com → opencage.mygeocode.comOpenCageはジオコーディングと逆ジオコーディングに1つのエンドポイントを使い、充実したannotationsブロックを返します。
エンドポイントとレスポンス形式LocationIQ
us1.locationiq.com, eu1.locationiq.com → locationiq.mygeocode.comLocationIQのsearch、reverse、autocomplete、timezoneの各エンドポイントが、locationiq.mygeocode.comで応答します。
エンドポイントとレスポンス形式Geoapify
api.geoapify.com → geoapify.mygeocode.comGeoapifyのジオコーディングエンドポイントは、フラットなpropertiesオブジェクトを持つGeoJSONのFeatureCollectionを返します。
エンドポイントとレスポンス形式TomTom Search
api.tomtom.com → tomtom.mygeocode.comTomTomのGeocode、Reverse Geocode、Fuzzy Searchの各エンドポイントが、tomtom.mygeocode.comで同じsummaryとresultsの構造で応答します。ほとんどの連携で表示されるfreeformAddressフィールドも含まれます。
エンドポイントとレスポンス形式MapQuest Geocoding
www.mapquestapi.com, open.mapquestapi.com → mapquest.mygeocode.comMapQuestのライセンス版とOpen Data版の両方のジオコーディングエンドポイントが、mapquest.mygeocode.comで応答します。info、options、resultsのエンベロープと、MapQuestクライアントが解析するadminArea1からadminArea6までの命名もそのままです。
エンドポイントとレスポンス形式Geocodio
api.geocod.io → geocodio.mygeocode.comGeocodioは米国とカナダに特化しています。
エンドポイントとレスポンス形式PositionStack
api.positionstack.com → positionstack.mygeocode.comPositionStackのジオコーディングと逆ジオコーディングのエンドポイントが、positionstack.mygeocode.comで同じdata配列とフラットなフィールド名で応答します。
エンドポイントとレスポンス形式ip-api.com
ip-api.com, pro.ip-api.com → ipapi.mygeocode.comip-apiのJSONエンドポイントは、最も広く模倣されているIP検索の形式の1つです。
エンドポイントとレスポンス形式ipinfo.io
ipinfo.io → ipinfo.mygeocode.comloc文字列と、AS番号を先頭に付けたorg文字列を持つipinfoのコンパクトなJSONを、ipinfo.mygeocode.comで再現しています。
エンドポイントとレスポンス形式ipstack
api.ipstack.com → ipstack.mygeocode.comipstackの標準検索とcheckのエンドポイントが、ipstack.mygeocode.comで同じトップレベルのフィールドとlocationオブジェクトで応答します。すべてのプランでHTTPSに対応しています。
エンドポイントとレスポンス形式Open-Elevation
api.open-elevation.com → openelevation.mygeocode.comOpen-Elevationの公開サーバーはボランティアによるプロジェクトで、稼働時間の保証はありません。
エンドポイントとレスポンス形式JavaScriptライブラリ
同じ方法は地図ライブラリやジオコーダーライブラリでも使えます。Google Maps JavaScript APIをgapi.mygeocode.comから読み込めば、google.maps.Map、Geocoder、places.Autocompleteが当社のタイルとデータでそのまま動作し、地図の読み込みには料金がかかりません。Bing Maps V8コントロール、HERE Maps for JavaScript、MapQuest.js用のローダーに加え、mapbox-gl-geocoderを使うMapLibreとMapbox GL、そしてLeafletのジオコーダープラグイン向けの設定も用意しています。
同じ点と異なる点
同じ点
- プロバイダーが文書化しているパス、クエリパラメーター、HTTPメソッド。
- レスポンスの構造：フィールド名、入れ子、配列、型、座標の順序。
- ステータスの語彙。たとえばGoogleの
OKやZERO_RESULTS、BingのstatusCodeなど。 - エラーの形式。既存のエラー処理がそのまま機能します。
- 料金。互換ホストへのリクエストは当社独自のエンドポイントへのリクエストと同じ料金で、同じキーの割り当てを消費します。
異なる点
- データ。座標、整形済み住所、確信度の値は当社のものなので、元のプロバイダーと1桁単位で一致するわけではありません。
- 識別子。プレイスIDは当社独自のもので安定していますが、元のプロバイダーに渡すことはできません。
- ルート検索、プレイスの詳細、写真など、ジオコーディング、IP、タイムゾーン、標高以外の機能は含まれません。各ページに不足している機能を記載しています。
- キー。当社独自のエンドポイントと同様に、従量課金のキーは直近24時間あたり2つのIPアドレスから、Unlimitedキーは3つのIPアドレスから利用できます。より大規模な環境では、キーやパッケージを追加してください。
お使いのプロバイダーが見つかりませんか？
プロバイダーの形式が文書化されていれば、互換ホストの追加は数日の作業です。ここにないサービスをお使いの場合は、どのサービスかをお知らせください。1日あたりのおおよそのリクエスト数もあわせてお知らせください。