Descripción general de la API de Geolocation

La API de Geolocation es un servicio que acepta solicitudes HTTPS con la torre de telefonía celular y los puntos de acceso Wi-Fi que puede detectar un cliente de dispositivos móviles. Muestra las coordenadas de latitud y longitud, y un radio que indica la precisión 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 ofrezcan características 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 de Wi-Fi para obtener la ubicación de un dispositivo que no cuenta 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 array de puntos de acceso Wi-Fi para devolver 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 la 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 se indican a continuación.
2 Probar una solicitud de ubicación geográfica Una vez que tengas la clave de API, puedes comenzar a probar la API de Geolocation con cURL o Postman. Para obtener más información, consulta Solicitudes de ejemplo en la guía Solicitudes de ubicación geográfica y respuesta.
3 Obtén el ID de celda de diferentes torres de radio Consulta Cálculo del ID de celda y Cálculo de newRadioCellID para obtener acceso a 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 y prepárate para usar los datos de elevación en tu app. Consulta Respuestas de ubicación geográfica para obtener más detalles.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que prefieras 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 basadas en la licencia Apache 2.0 que asisten a la comunidad. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos