
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 |
基地局のデータ: 場所の市外局番や携帯電話の国コードなど。 | ||
Wi-Fi アクセス ポイントのデータ: MAC アドレスや電波強度など。 |
Geolocation API の使用方法
1 | セットアップする | 最初に Google Cloud プロジェクトをセットアップするに進み、以下の設定手順を完了します。 |
2 | 位置情報リクエストを試す | API キーを取得したら、cURL または Postman を使用して Geolocation API のテストを開始できます。詳しくは、位置情報のリクエストとレスポンスのガイドのサンプル リクエストをご覧ください。 |
3 | さまざまな無線基地局からセル ID を取得する | 古い基地局へのアクセスについては、cellID の計算 と newRadioCellID の計算を参照してください。 |
4 | レスポンスの基本を理解する | 位置情報データのレスポンスを調べて、アプリで高度データを使用するための準備をします。詳しくは、位置情報のレスポンスをご覧ください。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを使用して、任意の言語でこの API を呼び出します。
- Google マップサービス用の Java クライアント
- Google マップサービス用の Python クライアント
- Google マップ サービス向け Go クライアント
- Google マップサービス用の Node.js クライアント
Google マップ サービス用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順とサンプルコードも掲載されています。
次のステップ
- サンプルのリクエストとレスポンスを使ってみる: 位置情報のリクエストとレスポンスをご覧ください。
- ベスト プラクティスを実践する: ウェブサービスのベスト プラクティスをご覧ください。
- 課金について: 使用量と課金をご覧ください。