Обзор Geolocation API

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

Зачем использовать Geolocation API

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

Что можно делать с помощью Geolocation API

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

Как работает Geolocation API

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

Как использовать Geolocation API

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

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

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

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

Дальнейшие действия