移行

Geocode.Farmからの移行

Geocode.Farmはジオコーディングの分野では比較的小規模なサービスで、大規模なエンタープライズプラットフォームではなく、シンプルで飾り気のない選択肢を求めるチームによく選ばれています。そのAPIキーはクエリパラメータとして送信されたリクエストを認証し、JSONレスポンスには位置座標を持つ geometry オブジェクトと、一致の信頼度を示す accuracy フィールドが含まれています。これらは、一部の大手プロバイダーに比べてレスポンスを比較的フラットに保つ構造にまとめられています。

小規模なプロバイダーには、はっきり言葉にしておく価値のある特有の移行の動機があります。チームが小規模なベンダーから離れるのは、何か問題が起きたからではなく、より幅広い互換性の選択肢と、より明確な長期的ロードマップを持つプラットフォームという安心感を求めるからということがあります。特に、小さく始まったプロジェクトが、より多くのトラフィックや、事業にとってより重要なワークフローを扱うようになったときです。

My GeocodeのGeocode.Farm互換ホストは、Geocode.Farmが返すgeometryとaccuracyのフィールド構造を再現しており、レスポンスの中で変わるのは著作権表示、利用規約、プライバシーに関するテキストだけです。フィールドのリファレンスは/compatibility/geocode-farm/にあります。このレスポンス形式を前提に作られたアプリケーションのコードは、ホストとキーを変更するだけで動作し続けるはずです。

この移行で特に確認しておく価値のある点をいくつか挙げます。

  • 連携が、Geocode.Farm特有のレスポンスに合わせて調整されたロジックでレート制限エラーを処理しているかどうか。エラーの形式はプロバイダーによって異なり、このプラットフォームについては/docs/errors/に記載されています
  • キーが現在、設定ではなくアプリケーションのコードに直接埋め込まれていないかどうか。移行先に関係なく、この移行の際に修正しておく価値があります
  • 逆ジオコーディングにもGeocode.Farmを使っているかどうか。そのリクエストのパターンはジオコーディングとは異なるため、別途テストを行う価値があります

認証には X-API-Key ヘッダー、Authorization: Bearer ヘッダー、HTTPベーシック認証、クエリパラメータを使えるため、既存のGeocode.Farmクライアントがどの方式を使っていても対応できます。

料金について言えば、小規模で専門性の高いプロバイダーから幅広いプラットフォームに移っても、ここではコスト構造が複雑になることはありません。キーなしで1日2,500件のリクエストが無料、キーごとにネットワーク単位でカウントされる1日2,500件の無料リクエストがさらにあり、それを超えた分は1リクエストあたり€0.0001のプリペイドクレジットか、月額€50のUnlimitedキーです。この互換ホストを含め、すべてのエンドポイントの料金は同じです。My Geocodeは合計17の互換ホストを提供しているため、小規模なプロバイダーから移行するチームは、別の場所に2つ目のアカウントを開設しなくても、後で他のプロバイダーのレスポンス形式を並べて試せるという選択肢も得られます。