Descripción general de la API de Geolocation

La API de Geolocation es un servicio que acepta una solicitud HTTPS con las torres de telefonía celular y los puntos de acceso a Wi-Fi que puede detectar un cliente móvil. Devuelve 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 proporcionan funciones de geolocalización integradas.

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 tiene geolocalización o GPS integrados.

Cómo funciona la API de Geolocation

La API de Geolocation utiliza campos de datos de dispositivos celulares, datos de torres de telefonía celular y datos de arrays de puntos de acceso Wi-Fi para devolver coordenadas de latitud y longitud, y un radio de precisión. Acepta una solicitud POST de HTTPS a su extremo junto con un cuerpo de solicitud estructurado en JSON. En el siguiente ejemplo, se muestran la URL de la solicitud y un ejemplo del cuerpo de la solicitud:

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 devolver datos para varios campos de datos celulares 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 geolocalización, junto con el tipo de datos que se proporcionan a partir de esas consultas.

Recursos de datos Datos devueltos Formato de devolución
Campos de datos del dispositivo celular, como información de operador, dispositivo y 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 de país para dispositivos móviles
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 Inicia la configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación.
2 Prueba con una solicitud de geolocalización Una vez que tengas una clave de API, puedes comenzar a probar la API de Geolocation con cURL o Postman. Consulta Solicitudes de ejemplo en la guía Solicitudes y respuestas de Geolocation para obtener más detalles.
3 Cómo obtener el ID de celda de diferentes torres de radio Consulta Cómo calcular cellID y Cómo calcular newRadioCellID para acceder a torres más antiguas y más nuevas, respectivamente.
4 Comprende los conceptos básicos de las respuestas Explora las respuestas de datos de ubicación geográfica para prepararte para usar datos de elevación en tu app. Consulta las respuestas de ubicación geográfica para obtener más detalles.

Bibliotecas cliente disponibles

Llama a esta API en el idioma que elijas a través de una de las siguientes bibliotecas cliente:

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

¿Qué sigue?