
Geolocation API は、モバイル クライアントが検出できる、基地局と Wi-Fi アクセス ポイントとの HTTPS リクエストを受け入れるサービスです。緯度と経度の座標と、有効な入力ごとに結果の精度を示す半径を返します。
Geolocation API を使用する理由
ネイティブの位置情報機能を備えていないモバイル デバイスを探すには、Geolocation API を使用します。
Geolocation API でできること
Geolocation API を使用すると、基地局や Wi-Fi ノードからの地理空間データを使用して、ネイティブの位置情報や GPS を備えていないデバイスの位置を取得できます。
Geolocation API の仕組み
Geolocation API は、モバイル デバイスのデータ フィールド、基地局のデータ、Wi-Fi アクセス ポイントの配列データを使用して、緯度と経度の座標と正確な半径を返します。これは、JSON 構造化リクエスト本文とともに、エンドポイントへの HTTPS POST リクエストを受け入れます。次の例は、リクエスト 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 |
基地局のデータ: 場所の市外局番やモバイルの国コードなど。 | ||
WiFi アクセス ポイントのデータ(MAC アドレスや信号強度など)。 |
Geolocation API の使用方法
1 | セットアップする | Google Cloud プロジェクトの設定から始めて、以下の設定手順を完了します。 |
2 | 位置情報のリクエストを試す | API キーを取得したら、cURL または Postman を使用して Geolocation API のテストを開始できます。詳しくは、位置情報のリクエストとレスポンスのガイドのサンプル リクエストをご覧ください。 |
3 | さまざまな無線基地局から CellID を取得する | 古いタワーと新しい基地局にアクセスするには、それぞれ cellID の計算 と newRadioCellID の計算をご覧ください。 |
4 | 回答の基本を理解する | 位置情報データのレスポンスを調べて、アプリで高度データを使用する準備をします。詳しくは、位置情報レスポンスをご覧ください。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを介して、任意の言語でこの API を呼び出します。
- Google マップ サービス向け Java クライアント
- Google マップサービス用 Python クライアント
- Google マップ サービス向け Go Client
- Google マップ サービス向け Node.js クライアント
Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリで、Apache 2.0 ライセンスに基づいてオープンソース化されています。GitHub からダウンロードしてください。GitHub では、インストール手順とサンプルコードも確認できます。
次のステップ
- リクエストとレスポンスのサンプルを使用する: 位置情報のリクエストとレスポンスに関する説明をご覧ください。
- ベスト プラクティスの実践: ウェブサービスのベスト プラクティスをご覧ください。
- 課金について: 使用量と請求額をご覧ください。