Google マップ ウェブサービスのクライアント ライブラリ

Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソースとしてリリースされています。これらのライブラリは GitHub からダウンロードや更新ができます。インストール手順とサンプルコードも GitHub で確認可能です。

クライアント ライブラリを使用するメリット

Google マップサービス向け Java クライアント、Python クライアント、Go クライアント、Node.js クライアントを使用すると、サーバー上で Google マップ ウェブサービスを使用できます。これらのライブラリには、次の API の機能がラップされています。

これらの API から機能が提供される以外に、クライアント ライブラリによって一般的なタスクが簡素化されます。

  • 自動レート制限: デフォルトでは、各ウェブサービスの想定されるレート制限でリクエストを送信します。new GeoApiContext().setQueryRateLimit(qpm) を使用して、1 分あたりのクエリ数（QPM）のカスタム上限を指定できます。
  • 失敗時の再試行: API から 500 レベルのエラーが返された場合、指数バックオフを使用してリクエストを自動的に再試行し、断続的な障害を処理します。
  • 簡単な認証: API キー、または Google Maps Platform プレミアム プランのお客様の場合はクライアント ID とシークレットを使用して認証できます。
  • Plain Old Java Object（POJO）: Java ライブラリの各 API レスポンスに対して型付き Java オブジェクトを返します。一方、Python ライブラリは API からレスポンス構造を直接返します。
  • 非同期または同期呼び出し: すべてのリクエストで同期呼び出しスタイルと非同期呼び出しスタイルの両方をサポートします。

利用規約

Google マップ ウェブサービス向けクライアント ライブラリは、Apache 2.0 ライセンスの下に使用が許諾されています。

クライアント ライブラリは、Google マップ ウェブサービスのラッパーです。Google マップ ウェブサービスには、Google Maps Platform の利用規約が適用されます。

API キーとクライアント ID

各 Google マップ ウェブサービスには、API キーまたはクライアント ID が必要です。API キーとクライアント ID の取得方法や使い分けについては、使用している API の認証ガイドをご覧ください。