今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
LocationIQとの互換ホストが利用可能に
LocationIQは、小さく始まって成長した多くのスタックに組み込まれてきました。多くの場合、初期に導入しやすかったことがその理由です。私たちの互換ホストが対象としているのは、まさにそうした連携です。今は問題なく動いていて、恒久的なものにするつもりはなかったものの、書き直す価値がなかったためにそのまま残っている連携です。
このホストはLocationIQのリクエストパラメータとレスポンス本文を正確に再現しています。例外は著作権、規約、プライバシーに関する文言で、これはMy Geocode独自のものです。LocationIQのエンドポイント向けの形のリクエストは変更せずに私たちのホストに送ることができ、返されるレスポンスは既存のコードが想定しているのと同じように解析できます。
この正確さは、プロバイダーごとに注いだ労力の偶然の結果ではありません。すべての互換ホストは、My Geocodeの他の部分を動かしているのと同じ請求、割り当て、アカウントのシステムの上に載っています。そのため新しいホストを作る作業は、別のバックエンドを立ち上げることではなく、主に対応付けの作業、つまり特定のプロバイダーのクライアントがすでに送っているものにフィールド名とパラメータの形を合わせることです。だからこそ、料金、認証、割り当ての追跡は、時間とともに互いにずれていくことなく、17のホストすべてでまったく同じように動作するのです。
認証は、プラットフォームのすべてのホストで使われているのと同じパターンに従います。キーをX-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータとして送り、現在のLocationIQとの連携がすでに行っている方法に合わせてください。4つともここで例外なく受け付けられるので、切り替えのためにHTTPクライアントに手を加える必要はほとんどありません。
料金は、どのホストやエンドポイントが呼び出しを処理するかによって変わることはありません。どのアドレスにも、キーなしで1日あたり2,500件の無料リクエストがあります。これはネットワーク単位で数えられるため、割り当ては背後にあるすべての端末ではなく、共有の回線に対して合理的に対応します。キーごとに、さらに1日あたり2,500件の無料リクエストが追加され、同じネットワークのキーなしの割り当てとは別に追跡されます。それを超えた分は、プリペイドクレジットで1リクエストあたり€0.0001、またはUnlimitedパッケージで月額€50ですべてをカバーできます。
どの互換ホストが処理したかに関係なく、すべてのレスポンスには私たちの割り当てヘッダー一式が付きます。X-Quota-Limit、X-Quota-Used、X-Quota-Free-Remaining、X-Quota-Network-Used、X-Credits-Remainingは、ネイティブエンドポイントとまったく同じようにこのホストのレスポンスにも付くので、これらのヘッダーを前提に作られたものはすべて変更なしで動き続けます。
プロジェクトで互換レスポンス以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、オプションの追加フィールドがその上に加わります。これは完全にオプトインです。ジオコーディングの呼び出しでは、返された座標の地表の標高を含めることができ、これは/v1/elevationに直接答えているのと同じデータソースから取得されます。使わなければ、レスポンスの形式はLocationIQの形と正確に一致し、既存の解析ロジックに予想外のことは起きません。
切り替えを行い、実際のトラフィックでも問題なく動くことを確認したアカウントは、チーム内でまだ元のプロバイダーに料金を払っている人に勧めることがよくあります。ダッシュボードの/dashboard/referralsにある紹介プログラムは、まさにそうした口コミのために作られています。
このホストのドキュメントは/compatibility/locationiq/にあり、プロバイダーの切り替えに関する一般的な手引きは/docs/compatibility/にあります。既存の連携にすんなり収まることを確かめるには、たいてい新しいキーでのテスト呼び出し1回で十分です。