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 para 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 Geolocation API

Usa la API de Geolocation para ubicar dispositivos móviles que no proporcionen 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 tiene ubicación geográfica nativa o GPS.

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 arreglos de puntos de acceso Wi-Fi para mostrar las 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 formato JSON. En el siguiente ejemplo, se muestra la URL de solicitud y un cuerpo de solicitud de ejemplo: 

    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.
      ]
    }
La API puede mostrar datos de 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 proporcionan en esas consultas.

Recursos de datos Datos mostrados Formato de devolución
Campos de datos del dispositivo móvil, como información del proveedor, el dispositivo y la red Coordenadas de latitud/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 Configuración Comienza con Configura tu proyecto de Google Cloud y completa las siguientes instrucciones de configuración.
2 Prueba una solicitud de ubicación geográfica Una vez que tengas una clave de API, podrás comenzar a probar la API de Geolocation mediante cURL o Postman. Consulta Solicitudes de muestra en la guía Solicitudes y respuesta de ubicación geográfica para obtener más detalles.
3 Cómo obtener el ID de la celda de diferentes torres de radio Consulta Calcula el cellID y Calcula newRadioCellID para obtener acceso a torres 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 a fin de prepararte para usar los datos de elevación de tu app. Consulta Respuestas de ubicación geográfica a fin de obtener más información.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje 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 compatibles con la comunidad y de código abierto bajo la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos