
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:
- 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 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
- Primeiros passos com solicitações e respostas de amostra: 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 o faturamento: acesse Uso e faturamento.