![Visão geral da API Geolocation](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=6&hl=pt)
A API Geolocation é um serviço que aceita uma solicitação HTTPS com o torre de celular e pontos de acesso Wi-Fi que um cliente móvel pode detectar. Ela retorna coordenadas de latitude/longitude e um raio indicando a precisão do para cada entrada válida.
Por que usar a API Geolocation
Usar a API Geolocation para localizar dispositivos móveis que não forneçam geolocalização nativa atributos de machine learning.
O que você pode fazer com a API Geolocation
Com a API Geolocation, você pode usar dados geoespaciais de torres de celular e nós de Wi-Fi para obter 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, torres de celular e dados de matriz de ponto de acesso Wi-Fi para retornar coordenadas de latitude/longitude e uma precisão raio. Ele aceita uma solicitação POST HTTPS para o endpoint junto com uma solicitação estruturada JSON. corpo O exemplo a seguir mostra o URL 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 diversos campos comuns de dados de celular, conforme indicado abaixo.
Recursos
A tabela a seguir resume os campos no corpo da solicitação do endpoint de geolocalização chamada, além do tipo de dados fornecidos a partir dessas consultas.
Recursos de dados | Dados retornados | Formato de devolução |
---|---|---|
Campos de dados de dispositivos móveis como operadora, dispositivo e informações de rede. | Coordenadas de latitude/longitude e um raio de precisão | JSON |
Dados de torres de celular, como código de área do local e códigos de país para celular. | ||
Dados de pontos de acesso Wi-Fi, como endereço MAC e 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 | Tentar uma solicitação de geolocalização | Quando você tiver uma chave de API, poderá começar a testar a API Geolocation usando cURL ou Carteiro. Consulte Exemplos de solicitações. no guia de Solicitações e respostas de geolocalização para mais detalhes. |
3 | Obter o sinal de celular de diferentes torres de rádio | Consulte Como calcular oCellID e calculando newRadioCellID para ter acesso a torres mais antigas e mais novas, respectivamente. |
4 | Noções básicas sobre respostas | Confira as respostas dos dados de geolocalização e se prepare para usar os 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 do sua escolha por meio de uma das seguintes bibliotecas de cliente:
- Java Cliente para serviços do Google Maps
- Python Cliente para serviços do Google Maps
- Cliente Go para serviços do Google Maps
- Node.js Cliente para serviços do Google Maps
Os clientes Java, Python, Go e Node.js para Google Maps Os serviços são bibliotecas-cliente com suporte da comunidade, com código aberto de acordo com a Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.
A seguir
- Começar a usar exemplos de solicitações e respostas: acesse Solicitação e resposta de geolocalização
- Seguir as práticas recomendadas: acessar Práticas recomendadas para serviços da Web.
- Para entender o faturamento: acesse Uso e faturamento.