Descripción general de la API de Geolocation

La API de Geolocation es un servicio que acepta una solicitud HTTPS con la torre de telefonía celular y los puntos de acceso Wi-Fi que un cliente de dispositivos móviles puede detectar. Muestra coordenadas de latitud y longitud y un radio que indica la exactitud del resultado para cada entrada válida.

Por qué usar la API de Geolocation

Usa la API de Geolocation para ubicar dispositivos móviles que no proporcionan funciones nativas de ubicación geográfica.

Qué puedes hacer con la API de Geolocation

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

Cómo funciona la API de Geolocation

La API de Geolocation usa campos de datos de dispositivos móviles, datos de torres de telefonía celular y datos de arrays de puntos de acceso Wi-Fi para mostrar coordenadas de latitud y longitud, y un radio de precisión. Acepta una solicitud HTTPS POST a su extremo junto con un cuerpo de solicitud estructurado JSON. 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 de datos móviles comunes, como se indica a continuación.

Recursos

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

Recursos de datos Datos mostrados Formato de devolución
Campos de datos del dispositivo móvil, como información sobre el proveedor, el dispositivo y 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 la ubicación y los códigos móviles de país.
Datos de 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 Prepárate Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que aparecen a continuación.
2 Cómo probar una solicitud de ubicación geográfica Una vez que tengas una clave de API, puedes comenzar a probar la API de Geolocation mediante cURL o Postman. Para obtener más detalles, consulta Solicitudes de ejemplo en la guía Solicitudes y respuesta de ubicación geográfica.
3 Obtén el ID de la celda de distintas torres de radio Consulta Cómo calcular el ID de celda y Cálculo de newRadioCellID para acceder a las torres más antiguas y nuevas, respectivamente.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos de ubicación geográfica a fin de prepararte para usar datos de elevación en tu app. Consulta Respuestas de ubicación geográfica para obtener más información.

Bibliotecas cliente disponibles

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

Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas de código abierto que cuentan con asistencia de la comunidad y que se rigen por la licencia Apache 2.0. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos