ZapierやMakeの自動化を新しいジオコーディングホストへ移行する
ジオコーディングのステップを含むノーコードの自動化には、独自のコードとは異なる移行方法が必要です。その切り替えの進め方を紹介します。
ip-api.comからの移行
ip-api.comは、本当にシンプルなレスポンス形式で支持を集めてきました。1回の検索につき1つのフラットなJSONオブジェクトで、country、regionName、city、lat、lon、isp、そして検索したIPアドレスを保持する query などのフィールドを持ち、ネストと呼べるものはありません。そのフラットさのおかげで、複雑なスキーマを覚えることなくプロジェクトに基本的なIPジオロケーションを追加したい人にとって、よくある最初の選択肢になりました。
IPジオロケーションは、形式だけが説明されているジオコーディングやオートコンプリートとは異なり、エンドツーエンドで実際に動作する結果を示せる検索の1つです。IPv4またはIPv6アドレスに対するリクエストは、静的なデータセットやゆっくりとしか更新されないデータセットではなく、当社独自のキャッシュパイプラインによって最新の状態に保たれているデータから、国、地域、都市、座標、ネットワーク情報を返します。
My Geocodeのip-api互換ホストは、country、regionName、city、lat、lon、isp、query を含むフラットなフィールド構造をそのまま再現しており、内容の違いは著作権表示、利用規約、プライバシーに関するテキストだけです。リファレンスの詳細は/compatibility/ip-api/にあります。ネストされたオブジェクトを展開せずに response.city や response.isp を直接読み取るコードは、ホストとキーを変更すればそのまま動作し続けるはずです。
この移行で具体的に変わること:
- 認証は、認証なしや緩い制限付きの公開検索ではなく、キーを使う方式に変わります。キーは
X-API-Keyヘッダー、Authorization: Bearer、HTTPベーシック認証、クエリパラメータのいずれかで送信します - 割り当ては、ときどき発生するスロットリングから推測する必要がなくなり、
X-Quota-Limit、X-Quota-Used、X-Quota-Resetなどのヘッダーを通じて、すべてのレスポンスで直接確認できるようになります - オプションの追加フィールド(IPの脅威情報とより詳しいネットワーク情報)は、
mg_extras=1またはX-MG-Extrasヘッダーを追加すれば、コードがすでに解析しているフラットな形式を変えずに利用できます
キーなしで1日2,500件のリクエストが無料で、さらに各キーにはネットワーク単位でカウントされる1日2,500件の無料リクエストがあります。ネットワークはIPv4なら/24単位、IPv6なら/48単位で、そのネットワークからのキーなしの利用とキー付きの利用で共有されます。その無料枠を超えた分は、1リクエストあたり€0.0001のプリペイドクレジットか、月額€50のUnlimitedキーです。この互換ホストを含め、すべてのエンドポイントの料金は同じです。
IPに基づく国別リダイレクト、不正のシグナルチェック、基本的なアナリティクスのデータ付加を行うアプリケーションにとって、これは通常、エンドツーエンドでテストしやすい部類の移行です。結果が具体的で、同じテスト用アドレスのセットに対して現在の連携が返すものと直接比較できるからです。