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 forneçam recursos de geolocalização nativos.

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 saber o local 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 HTTPS POST para o endpoint junto com um corpo de solicitação estruturado em JSON. O exemplo a seguir mostra o URL da solicitação e um exemplo de corpo de 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 redes 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 e o tipo de dados fornecidos por essas 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 do país para dispositivos móveis.
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 pela seção Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Tente usar uma solicitação de geolocalização Quando você tiver uma chave de API, poderá testar a API Geolocation usando cURL ou Postman. Consulte Solicitações de amostra no guia Solicitações e resposta de geolocalização para mais detalhes.
3 Consiga o ID do celular de diferentes torres de rádio Consulte Calculando ID de celular e Cálculo de newRadioCellID para ter acesso a torres mais antigas e mais novas, respectivamente.
4 Noções básicas sobre respostas Explore as respostas dos dados de geolocalização e prepare-se 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 preferir 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 de 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