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 とリクエスト本文の例を示しています。

    https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

    {
      "homeMobileCountryCode": 310,
      "homeMobileNetworkCode": 410,
      "radioType": "gsm",
      "carrier": "Vodafone",
      "considerIp": true,
      "cellTowers": [
        // See the Cell Tower Objects section below.
      ],
      "wifiAccessPoints": [
        // See the WiFi Access Point Objects section below.
      ]
    }
  
この 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 にはインストール手順とサンプルコードも掲載されています。

次のステップ