Descripción general de la API de Geolocation

La API de Geolocation es un servicio que acepta una solicitud HTTPS con el torre de telefonía celular y puntos de acceso wifi que un cliente móvil puede detectar. Muestra coordenadas de latitud y longitud y un radio que indique la precisión de la resultado para cada entrada válida.

Por qué usar la API de Geolocation

Usar la API de Geolocation para localizar dispositivos móviles que no proporcionen ubicación geográfica nativa atributos.

Qué puedes hacer con la API de Geolocation

Con la API de Geolocation, puedes utilizar datos geoespaciales de torres de telefonía celular y Wi-Fi para obtener la ubicación de un dispositivo que no cuenta con GPS o ubicación geográfica nativos.

Cómo funciona la API de Geolocation

La API de Geolocation usa campos de datos de dispositivos móviles, y los datos de la matriz de puntos de acceso WiFi para devolver coordenadas de latitud/longitud y una exactitud radio. Acepta una solicitud HTTPS POST en su extremo junto con una solicitud estructurada JSON. cuerpo. El siguiente ejemplo muestra la URL de la solicitud y un cuerpo de solicitud de ejemplo:

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
}'
La API puede mostrar datos para varios campos comunes de datos móviles, como se indica a continuación.

Recursos

En la siguiente tabla, se resumen los campos del cuerpo de la solicitud del extremo de ubicación geográfica llamada, junto con el tipo de datos proporcionados en esas consultas.

Recursos de datos Datos mostrados Formato de devolución
Campos de datos de dispositivos móviles como información del operador, del dispositivo y de la red. Coordenadas de latitud y longitud y un radio de precisión JSON
Datos de torres de telefonía celular, como el código de área de ubicación y los códigos móviles de país.
Datos de los puntos de acceso Wi-Fi, como la dirección MAC y la intensidad de la señal.

Cómo usar la API de Geolocation

1 Preparación Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que siguen.
2 Prueba una solicitud de ubicación geográfica Una vez que tengas una clave de API, puedes comenzar a probar la API de Geolocation usando cURL o Postman. Consulta Solicitudes de muestra en la guía Solicitudes y respuestas de ubicación geográfica para obtener más detalles.
3 Obtén el ID de celular de diferentes torres de radio Consulta Cálculo del ID de celda. y calculando newRadioCellID para acceder a torres nuevas y antiguas, respectivamente.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos de ubicación geográfica para prepararte para usar los datos de elevación de tu app. Consulta Respuestas de ubicación geográfica para conocer los detalles.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje de que elijas mediante una de las siguientes bibliotecas cliente:

Los clientes de Java, Python, Go y Node.js para Google Maps Los servicios son bibliotecas cliente con asistencia de la comunidad, de código abierto en el Licencia 2.0 de Apache. Descárgalas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

¿Qué sigue?