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 um cliente para dispositivos móveis pode detectar. Ela retorna coordenadas de latitude/longitude e um raio que indica a precisão do resultado para 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 Wi-Fi para saber 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 ponto de acesso Wi-Fi para retornar coordenadas de latitude/longitude e um raio de precisão. Ele aceita uma solicitação POST de HTTPS para o endpoint junto com um corpo de solicitação estruturado em JSON. O exemplo a seguir mostra o URL e um corpo de solicitação de exemplo:

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
}'
A API pode retornar dados para vários campos comuns de dados móveis, 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 fornecidos dessas consultas.

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

Como usar a API Geolocation

1 Configuração Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Testar uma solicitação de geolocalização Depois de gerar uma chave de API, você pode testar a API Geolocation usando cURL ou Postman. Consulte Exemplos de solicitações no guia Solicitações e respostas de geolocalização para mais detalhes.
3 Obter o CellID de diferentes torres de rádio Consulte Calculando CellID e Calculando newRadioCellID para ter acesso a torres mais antigas e mais novas, 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 seu app. Consulte Respostas de geolocalização para mais detalhes.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem que quiser usando uma destas 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 e que têm código aberto sob a Licença Apache 2.0. Faça o download delas no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir