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

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

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

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

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

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

Что дальше?