ZapierやMakeの自動化を新しいジオコーディングホストへ移行する
ジオコーディングのステップを含むノーコードの自動化には、独自のコードとは異なる移行方法が必要です。その切り替えの進め方を紹介します。
ipinfo.ioからの移行
ipinfo.ioには独特なレスポンスのスタイルがあります。緯度と経度を2つの別々の数値ではなく、カンマ区切りの1つの文字列にまとめた loc フィールドと、自律システム番号と組織名を「AS15169 Google LLC」のように1つの文字列にまとめた org フィールドです。認証はトークンで行い、それ以外のレスポンスはコンパクトでほぼフラットに保たれており、これら2つの結合フィールドと並んで、city、region、country、postal などのフィールドがあります。
この結合文字列の書式は特に注意しておく価値があります。loc をカンマで分割して解析したり、org を最初のスペースで分割して解析したりするコードは実際の処理を担っており、移行後も正しく動作し続けなければならないからです。これはまさに、分割ロジックが想定しないものを本番のリクエストが返すまで見落としがちな、小さな解析の詳細です。
My Geocodeのipinfo互換ホストは、結合された loc 文字列と、AS番号が先頭に付いた org 文字列を含め、これと同じコンパクトな構造を再現しており、異なるのは著作権表示、利用規約、プライバシーに関するテキストだけです。リファレンスは/compatibility/ipinfo/にあります。loc と org の分割を前提に作られた解析ロジックは、書かれたとおりにそのまま動作し続けるはずです。
IP検索は、形式だけでなく実際の結果を直接説明できるエンドポイントの1つです。あるアドレスに対する検索は、都市、地域、国、結合された座標の文字列、結合された組織の文字列を、古いキャッシュからではなくライブで返します。My GeocodeのIPジオロケーションデータは、古くなるのではなく更新されるキャッシュレイヤーによって最新の状態に保たれているからです。
移行にあたって計画しておくべき具体的な点:
- トークンベースの認証は、当社がサポートする4つの方式(
X-API-Keyヘッダー、Authorization: Bearerヘッダー、HTTPベーシック認証、クエリパラメータ)に対応します - オプションのエクストラ(IPの脅威シグナル、より詳しいネットワーク詳細)は、
mg_extras=1またはX-MG-Extrasヘッダーでリクエストすると、コードがすでに読み取っているフィールドを壊すことなく、標準のコンパクトな形式と並んで追加されます - 割り当ての状況は、
X-Quota-UsedやX-Credits-Remainingを含むレスポンスヘッダーを通じて、すべての呼び出しで確認できます。現在の連携で使用量を手動で追跡している場合に役立ちます
料金:キーなしで1日2,500件のリクエストが無料、キーごとにネットワーク単位でカウントされる1日2,500件の無料リクエストがさらにあり、その後は1リクエストあたり€0.0001のプリペイドクレジットか、月額€50のUnlimitedキーです。この互換ホストを含め、すべてのエンドポイントの料金は同じです。ログ記録、アナリティクス、アクセス判断のためにipinfo特有のコンパクトな形式を前提に作られたアプリケーションにとって、この移行の目標は、形式そのものは一切変えずに、それを提供する側だけを変えることです。