Geolocation API の概要

Geolocation API は、モバイル クライアントが検出できる基地局と Wi-Fi アクセス ポイントを含む HTTPS リクエストを受け付けるサービスです。有効な入力ごとに、緯度と経度の座標と、結果の精度を示す半径を返します。

Geolocation API を使用する理由

Geolocation API を使用して、ネイティブの地理位置情報機能を提供していないモバイル デバイスの位置を特定します。

Geolocation API でできること

Geolocation API を使用すると、携帯電話の基地局や Wi-Fi ノードの地理空間データを使用して、ネイティブの地理位置情報や GPS を搭載していないデバイスの位置情報を取得できます。

Geolocation API の仕組み

Geolocation API は、携帯電話のデバイスのデータ フィールド、基地局のデータ、Wi-Fi アクセス ポイントの配列データを使用して、緯度/経度の座標と精度範囲を返します。エンドポイントへの HTTPS POST リクエストと、JSON 構造化リクエスト本文を受け入れます。次の例は、リクエスト URL とリクエスト本文の例を示しています。

curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d \
'{ "homeMobileCountryCode":310,
   "homeMobileNetworkCode":410,
   "radioType":"gsm",
   "carrier":"Vodafone",
   "considerIp":true
}'
 API は、以下に示すように、一般的なセルラー データ フィールドのデータを返すことができます。

リソース

次の表に、位置情報エンドポイント呼び出しのリクエスト本文のフィールドと、そのようなクエリから提供されるデータの種類を示します。

データ リソース 返されたデータ 戻り値の形式
携帯電話デバイスのデータ フィールド（携帯通信会社、デバイス、ネットワーク情報など）。 緯度と経度の座標、精度半径 JSON
携帯電話の基地局のデータ（位置エリア コードやモバイル国コードなど）。
Wi-Fi アクセス ポイントのデータ（MAC アドレス、信号強度など）。

Geolocation API の使用方法

1 セットアップする Google Cloud プロジェクトを設定するから始めて、その後の設定手順を完了します。
2 位置情報リクエストを試す API キーを取得したら、cURL または Postman を使用して Geolocation API のテストを開始できます。詳しくは、位置情報リクエストとレスポンス ガイドのリクエストの例をご覧ください。
3 異なる無線塔から cellID を取得する 古いタワーと新しいタワーにそれぞれアクセスするには、cellID の計算 と newRadioCellID の計算を参照してください。
4 レスポンスの基本を理解する 位置情報データのレスポンスを調べて、アプリで標高データを使用する準備をします。詳しくは、位置情報レスポンスをご覧ください。

利用可能なクライアント ライブラリ

次のいずれかのクライアント ライブラリを使用して、選択した言語でこの API を呼び出します。

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

次のステップ