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

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

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

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

Что можно сделать с помощью API геолокации

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

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

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
Данные о вышках сотовой связи , такие как код зоны местоположения и коды стран мобильной связи.
Данные точек доступа WiFi , такие как MAC-адрес и уровень сигнала.

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

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

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

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

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

Что дальше?