
API геолокации — это служба, которая принимает HTTPS-запрос с помощью вышки сотовой связи и точек доступа Wi-Fi, которые может обнаружить мобильный клиент. Он возвращает координаты широты/долготы и радиус, указывающий точность результата для каждого допустимого ввода.
Зачем использовать API геолокации
Используйте API геолокации для поиска мобильных устройств, которые не предоставляют встроенные функции геолокации.
Что вы можете делать с API геолокации
С помощью API геолокации вы можете использовать геопространственные данные от вышек сотовой связи и узлов Wi-Fi, чтобы определить местоположение устройства, у которого нет собственной геолокации или GPS.
Как работает API геолокации
API геолокации использует поля данных сотового устройства, данные вышек сотовой связи и данные массива точек доступа Wi-Fi для возврата координат широты/долготы и точного радиуса. Он принимает запрос HTTPS POST к своей конечной точке вместе со структурированным телом запроса JSON. В следующем примере показан URL-адрес запроса и примерное тело запроса:
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY { "homeMobileCountryCode": 310, "homeMobileNetworkCode": 410, "radioType": "gsm", "carrier": "Vodafone", "considerIp": true, "cellTowers": [ // See the Cell Tower Objects section below. ], "wifiAccessPoints": [ // See the WiFi Access Point Objects section below. ] }API может возвращать данные для ряда общих полей данных сотовой связи, как указано ниже.
Ресурсы
В следующей таблице приведены поля в тексте запроса вызова конечной точки геолокации, а также тип данных, предоставляемых такими запросами.
Ресурсы данных | Данные возвращены | Формат возврата |
---|---|---|
Поля данных сотового устройства , такие как информация об операторе связи, устройстве и сети. | Координаты широты/долготы и радиус точности | JSON |
Данные вышек сотовой связи , например код города и мобильные коды стран. | ||
Данные точек доступа Wi-Fi , такие как MAC-адрес и мощность сигнала. |
Как использовать API геолокации
1 | Настроить | Начните с настройки проекта Google Cloud и выполните следующие инструкции по настройке. |
2 | Попробуйте запрос геолокации | Получив ключ API, вы можете приступить к тестированию API геолокации с помощью cURL или Postman. Дополнительные сведения см. в разделе Образцы запросов в Руководстве по запросам и ответам на геолокацию . |
3 | Получите идентификатор ячейки с разных радиовышек | См . Вычисление идентификатора ячейки и Вычисление нового идентификатора радиосоты , чтобы получить доступ к более старой и новой вышкам соответственно. |
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, где вы также можете найти инструкции по установке и примеры кода.
Что дальше
- Начните с примеров запросов и ответов : перейдите к запросу и ответу о геолокации.
- Следуйте рекомендациям : перейдите к рекомендациям по веб-службе .
- Что такое выставление счетов : перейдите в раздел Использование и выставление счетов .