今月のリリース:ジオコーディング、IP、タイムゾーンなど
APIの最近の取り組みのまとめです:新しい互換ホスト、より高速なタイムゾーンと標高の検索、ダッシュボードの機能、割り当ての見やすさの向上。
HERE Geocoding and Searchとの互換ホストが利用可能に
HERE Geocoding and Searchは、物流、自動車、位置情報関連の多くのソフトウェアの裏で使われており、多くの場合システム全体ではなく数ある構成要素のひとつとして組み込まれています。プロバイダーがそこまで深く組み込まれていると、代替を検討するには、開発コストと不確かなメリットを天秤にかけるのが普通です。私たちのHERE互換ホストは、その天秤から開発コストを完全に取り除くために作られています。
このホストはHEREのリクエストパラメータとレスポンス本文を正確に再現しており、違いは著作権、規約、プライバシーに関する文言だけです。これは元のプロバイダーではなく私たちのものです。すでにHERE形式のリクエストを組み立て、HERE形式のレスポンスを読み取っているクライアントコードには手を加える必要がありません。必要なのは別のホスト名とMy Geocodeのキーだけです。
そのキーは、このホストを含め、私たちが運営するすべてのホストで同じ柔軟な方法で使えます。X-API-Keyヘッダー、Authorization: Bearerヘッダー、キーをユーザー名とするHTTP Basic認証、またはクエリパラメータです。4つともすべてのエンドポイントとすべての互換ホストで例外なく認識されるので、既存のクライアントがすでに送っている方法をそのまま使ってください。
互換の表面の下にある料金体系は私たちのもので、プラットフォームのどこでも同じです。どのアドレスにも、キーなしで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、X-Key-IPs-Used、X-Key-IPs-Limit、X-Quota-Resetです。これにより、レスポンス本文自体を変えることなく、元のAPIには組み込まれていない水準の利用状況の透明性が得られます。
プロジェクトで互換の形が返す以上のものが必要な場合は、リクエストにmg_extras=1を付けるかX-MG-Extrasヘッダーを送ると、地表の標高などのオプションのフィールドがその上に加わります。これは完全にオプトインです。使わなければ、レスポンスはHEREの形式と正確に一致します。
この互換ホストのドキュメントは/compatibility/here/にあり、17のホストすべてで切り替えがどう機能するかの全体像は/docs/compatibility/にあります。合うかどうかは、たいていテスト呼び出し1回で確かめられます。