Обзор 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» и «Вычисление newRadioCellID» , чтобы получить доступ к старым и новым вышкам соответственно.
4 Понимать основы ответа Изучите ответы данных геолокации, чтобы подготовиться к использованию данных о высоте для вашего приложения. Подробности см. в разделе «Ответы по геолокации» .

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

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

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

Что дальше