
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:
- Cliente Java para serviços do Google Maps (em inglês)
- Cliente Python para serviços do Google Maps (em inglês)
- Cliente Go para serviços do Google Maps (em inglês)
- Cliente Node.js para serviços do Google Maps (em inglês)
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
- Primeiros passos com exemplos de solicitações e respostas: acesse Solicitação e resposta de geolocalização
- Siga as práticas recomendadas: acesse Práticas recomendadas para serviços da Web.
- Noções básicas sobre faturamento: acesse Uso e faturamento.