Visão geral da API Geolocation

A API Geolocation é um serviço que aceita uma solicitação HTTPS com a torre de celular e os pontos de acesso Wi-Fi que podem ser detectados por um cliente de dispositivos móveis. Ela retorna coordenadas de latitude/longitude e um raio indicando a precisão do resultado de cada entrada válida.

Por que usar a API Geolocation

Use a API Geolocation para localizar dispositivos móveis que não fornecem recursos nativos de geolocalização.

O que você pode fazer com a API Geolocation

Com a API Geolocation, é possível usar dados geoespaciais de torres de celular e nós de Wi-Fi para encontrar a localização de um dispositivo que não tem geolocalização ou GPS nativo.

Como a API Geolocation funciona

A API Geolocation usa campos de dados de dispositivos móveis, dados de torres de celular e dados de matriz de pontos de acesso Wi-Fi para retornar coordenadas de latitude/longitude e um raio de precisão. Ele aceita uma solicitação HTTPS POST ao endpoint com um corpo de solicitação estruturada JSON. O exemplo a seguir mostra o URL e o corpo de uma solicitação: 

    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.
      ]
    }
A API pode retornar dados de diversos campos comuns de dados de celular, conforme indicado abaixo.

Recursos

A tabela a seguir resume os campos no corpo da solicitação da chamada do endpoint de geolocalização, além do tipo de dados fornecido por essas consultas.

Recursos de dados Dados retornados Formato da devolução
Campos de dados de dispositivos móveis, como informações da operadora, do dispositivo e da rede Coordenadas de latitude/longitude e raio de precisão JSON
dados da torre de celular, como código de área do local e códigos de país para dispositivos móveis;
Dados de pontos de acesso Wi-Fi, como endereço MAC e intensidade do sinal.

Como usar a API Geolocation

1 Começar a configuração Comece com Configurar o projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Testar um pedido de geolocalização Quando você tiver uma chave de API, comece a testar a API Geolocation usando cURL ou Postman. Consulte Amostra de solicitações no guia Solicitações e respostas de geolocalização para ver mais detalhes.
3 Receber o ID da célula de diferentes torres de rádio Consulte Calculando cellID e Calculando newRadioCellID para ter acesso a torres mais antigas e mais recentes, respectivamente.
4 Noções básicas sobre respostas Explore as respostas de dados de geolocalização para se preparar para usar os dados de elevação do app. Consulte Respostas de geolocalização para mais detalhes.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem de sua escolha usando uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade, com código aberto sob a Licença Apache 2.0. Faça o download no GitHub, que também inclui instruções de instalação e amostras de código.

A seguir