![Обзор API геолокации](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=5&hl=ru)
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-клиент для сервисов Google Maps
- Клиент Python для сервисов Google Maps
- Клиент Go для сервисов Google Maps
- Клиент Node.js для сервисов Google Maps
Клиент Java, клиент Python, клиент Go и клиент Node.js для служб Google Maps — это клиентские библиотеки, поддерживаемые сообществом, с открытым исходным кодом по лицензии Apache 2.0 . Загрузите их с GitHub, где вы также можете найти инструкции по установке и пример кода.
Что дальше
- Начните работу с примерами запросов и ответов : перейдите к запросу и ответу на геолокацию.
- Следуйте рекомендациям : перейдите к разделу «Рекомендации по использованию веб-служб» .
- Общие сведения о выставлении счетов . Перейдите в раздел «Использование и выставление счетов» .