
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 }'
Ресурсы
В следующей таблице приведены поля в теле запроса вызова конечной точки геолокации, а также типы данных, предоставляемых такими запросами.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Поля данных сотового устройства , такие как информация об операторе, устройстве и сети. | Координаты широты/долготы и радиус точности | JSON |
Данные о вышках сотовой связи , такие как код зоны местоположения и коды стран мобильной связи. | ||
Данные точек доступа WiFi , такие как MAC-адрес и уровень сигнала. |
Как использовать API геолокации
1 | Настройте | Начните с настройки проекта Google Cloud и следуйте приведенным ниже инструкциям по настройке. |
2 | Попробуйте запрос геолокации | Получив ключ API, вы можете начать тестирование API геолокации с помощью cURL или Postman. Подробнее см. в разделе «Примеры запросов» в руководстве «Запросы и ответы геолокации» . |
3 | Получите идентификатор соты с разных радиовышек | См. разделы Расчет cellID и Расчет newRadioCellID , чтобы получить доступ к старым и новым вышкам соответственно. |
4 | Понять основы реагирования | Изучите ответы на запросы геолокации, чтобы подготовиться к использованию данных о высоте в вашем приложении. Подробнее см. в разделе «Ответы на запросы геолокации» . |
Доступные клиентские библиотеки
Вызовите этот API на языке по вашему выбору через одну из следующих клиентских библиотек:
- Java-клиент для сервисов Google Maps
- Клиент Python для сервисов Google Maps
- Go Client для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиенты Java, Python, Go и Node.js для сервисов Google Карт — это поддерживаемые сообществом клиентские библиотеки с открытым исходным кодом под лицензией Apache 2.0 . Загрузите их с GitHub, где также можно найти инструкции по установке и примеры кода.
Что дальше?
- Начните с примеров запросов и ответов : Перейти к запросу и ответу на геолокацию
- Следуйте рекомендациям : Перейдите в раздел Рекомендации по использованию веб-сервисов .
- Понимание выставления счетов : Перейдите в раздел Использование и выставление счетов .