
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:
- 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, 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
- Primeiros passos com exemplos e solicitações de amostra: acesse Solicitação e resposta de geolocalização
- Siga as práticas recomendadas: acesse Práticas recomendadas de serviços da Web.
- Entenda o faturamento: acesse Uso e faturamento.