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 móvel pode detectar. Ele 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 oferecem 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 sem geolocalização nativa ou GPS.

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 POST HTTPS para o endpoint com um corpo de solicitação estruturado em JSON. O exemplo a seguir mostra o URL da solicitação e um exemplo de corpo da solicitação: 

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 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 fornecidos por essas consultas.

Recursos de dados Dados retornados Formato de retorno
Campos de dados de dispositivos móveis, como informações de operadora, dispositivo e rede. Coordenadas de latitude/longitude e um raio de precisão JSON
Dados de torres de celular, como código de área de localização 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 configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração.
2 Fazer uma solicitação de geolocalização Depois de ter uma chave de API, você pode começar a 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 Receber o cellID de diferentes torres de rádio Consulte Como calcular o cellID e Como calcular o newRadioCellID para acessar torres mais antigas e mais novas, respectivamente.
4 Entender os princípios básicos da resposta Analise as respostas de dados de geolocalização para se preparar para usar dados de elevação no seu app. Consulte Respostas de geolocalização para mais detalhes.

Bibliotecas de clientes disponíveis

Chame essa API no idioma 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 e que têm código aberto sob a Licença Apache 2.0. Faça o download deles no GitHub, onde você também encontra instruções de instalação e exemplos de código.

A seguir