Usar o serviço Places e a API Geocoding com estilo baseado em dados para limites

Selecione a plataforma: Android iOS JavaScript

Você pode usar o serviço Places e a a API Geocoding com o SDK do Maps para Android para pesquisar regiões ver mais informações sobre lugares. O serviço Places e a API Geocoding são alternativas avançadas e estáveis para obter IDs de lugares. Se você já usa IDs de lugar, pode reutilizá-los com baseado em dados para limites.

Adicione o serviço Places e a geocodificação ao seu O SDK do Maps para apps Android acontece das seguintes maneiras:

  • SDK do Places para Android é uma biblioteca Android que contém métodos para retornar informações sobre lugares.
  • A API Places retorna informações sobre lugares usando solicitações HTTP.
  • Classe Geocoder pode geocodificar e reverter a geocodificação dinamicamente a partir da entrada do usuário.
  • Com a API Geocoding, é possível geocodificar endereços estáticos e conhecidos.
.

Usar o serviço Places

Usar o Text Search (novo) para encontrar um ID de lugar

Você pode usar o Text Search (novo) API REST na API Places para acessar um ID de lugar que inclua a região especificando places.id na máscara de campo. O uso do O Text Search (novo) para solicitar apenas IDs de lugar gera sem custo financeiro. Saiba mais.

Por exemplo, para conseguir o ID de lugar de Trinidad, Califórnia, você pode fazer o seguinte: Chamada de API:

curl -X POST -d '{
  "textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Usar o Place Autocomplete para encontrar regiões

O Place Autocomplete no SDK do Places para Android oferece uma maneira conveniente de permitir onde os usuários pesquisam regiões. Para configurar o serviço Place Autocomplete para retornar apenas regiões, use AutocompleteSupportFragment.setTypesFilter(List) para definir o filtro de tipo como PlaceTypes.REGIONS.

Gerar detalhes de lugares em uma região

A documentação do Place Details serviço de retorno de dados de uma região no SDK do Places para Android pode ser muito úteis. Por exemplo, você pode:

  • Procurar IDs de lugares limites com base nos nomes deles.
  • Acessar a janela de visualização para aplicar zoom a um limite.
  • Encontrar o tipo de recurso do limite (por exemplo, locality).
  • Consiga o endereço formatado, que é resolvido como "Nome do lugar, estado, país". no na região dos Estados Unidos (por exemplo, "Ottumwa, IA, EUA").
  • Localizar outros dados úteis, como fotos.

Usar a API Geocoding

A API Geocoding permite converter um endereço em coordenadas de latitude e longitude e um ID de lugar, ou converte coordenadas de latitude e longitude ou um ID de lugar em um endereço. Os exemplos de uso a seguir combinam bem com o estilo baseado em dados para limites:

  • Use a geocodificação para acessar a janela de visualização de uma região.
  • Aplique a filtragem de componentes à chamada da geocodificação para receber os IDs de lugar das áreas político-administrativas 1-4, regiões administrativas ou códigos postais.
  • Usar a geocodificação inversa para encontrar IDs de lugar por latitude e longitude coordenadas ou até mesmo retornar IDs de local para todos os componentes em um determinado o local.

O exemplo a seguir usa um endereço (com escape de URL) para fazer uma solicitação ao API Geocoding:

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

Você pode usar a geocodificação inversa para encontrar IDs de lugares. O exemplo a seguir de Geocoding retorna os IDs de local de todos os componentes de endereço na coordenadas especificadas de latitude e longitude:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

Usar a geocodificação inversa com filtragem de componentes para acessar o componente de endereço para um ou mais dos seguintes tipos no local especificado:

  • administrativeArea
  • country
  • locality
  • postalCode

O próximo exemplo mostra o uso do serviço de geocodificação, adicionando restrições de componentes com geocodificação inversa para encontrar todos os componentes de endereço no local especificado apenas para o tipo locality:

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY