Visão geral da API Geolocation

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:

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