Обзор API геолокации

API геолокации — это служба, которая принимает HTTPS-запрос с помощью вышки сотовой связи и точек доступа Wi-Fi, которые может обнаружить мобильный клиент. Он возвращает координаты широты/долготы и радиус, указывающий точность результата для каждого допустимого ввода.

Зачем использовать API геолокации

Используйте API геолокации для поиска мобильных устройств, которые не предоставляют встроенные функции геолокации.

Что вы можете делать с API геолокации

С помощью API геолокации вы можете использовать геопространственные данные от вышек сотовой связи и узлов Wi-Fi, чтобы определить местоположение устройства, у которого нет собственной геолокации или GPS.

Как работает API геолокации

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-адрес и мощность сигнала.

Как использовать API геолокации

1 Настроить Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке.
2 Попробуйте запрос геолокации Получив ключ API, вы можете приступить к тестированию API геолокации с помощью cURL или Postman. Дополнительные сведения см. в разделе Образцы запросов в Руководстве по запросам и ответам на геолокацию .
3 Получите идентификатор ячейки с разных радиовышек См . Вычисление идентификатора ячейки и Вычисление нового идентификатора радиосоты , чтобы получить доступ к более старой и новой вышкам соответственно.
4 Понимание основ ответа Изучите ответы на данные о геолокации, чтобы подготовиться к использованию данных о высоте для вашего приложения. См. подробности в ответах по геолокации .

Доступные клиентские библиотеки

Вызовите этот API на выбранном вами языке через одну из следующих клиентских библиотек:

Клиент Java, клиент Python, клиент Go и клиент Node.js для сервисов Google Maps — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом в соответствии с лицензией Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и примеры кода.

Что дальше