Usar as APIs do Places e a geocodificação com estilo orientado a dados para limites

Selecione a plataforma: Android iOS JavaScript

Você pode usar o SDK do Places para iOS e a API Geocoding com o SDK do Maps para iOS para pesquisar regiões e conferir mais detalhes sobre lugares. O SDK do Places para iOS e a API Geocoding são alternativas avançadas e estáveis para acessar IDs de lugares. Se você já usa IDs de lugar, é possível reutilizar esses IDs com o estilo baseado em dados para limites.

Adicione as APIs Places e Geocoding aos seus apps do SDK do Maps para iOS das seguintes maneiras:

  • O SDK do Places para iOS retorna informações sobre lugares usando solicitações HTTP.
  • A classe CLGeocoder pode fazer a geocodificação e a geocodificação inversa de forma dinâmica a partir da entrada do usuário.
  • Com a API Geocoding, é possível geocodificar endereços estáticos e conhecidos.

Usar a API Places

  • A Pesquisa de texto da API Places retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo", "loja de sapatos perto do Rio de Janeiro" ou "Avenida Brasil, 123". O serviço responde com uma lista de locais correspondentes à string de texto e a todos os direcionamentos de localização definidos.

  • O serviço Places Autocomplete oferece uma maneira conveniente para os usuários pesquisarem regiões. Para mostrar os resultados na região definida, defina locationRestriction em GMSAutocompleteFilter.

Gerar detalhes de lugares em uma região

  • Os dados de Detalhes do lugar de uma região também são eficazes. 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 elemento do limite (por exemplo, localidade).
    • Encontrar o endereço formatado, que é resolvido como "Nome do lugar, estado, país" na região dos Estados Unidos (por exemplo, "Kirkland, WA, EUA").
    • Localizar outros dados úteis, como fotos.

Usar a API Geocoding

  • Com a API Geocoding, você pode converter um endereço, coordenadas de latitude e longitude ou ID de lugar em coordenadas geográficas e vice-versa. Os usos 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 de geocodificação para receber os IDs de lugar das áreas político-administrativas 1-4, regiões administrativas ou códigos postais.
    • Use a geocodificação inversa para encontrar os IDs de lugar por coordenadas de latitude e longitude ou até mesmo retornar IDs de todos os componentes em um determinado local.

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

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

    É possível usar a geocodificação inversa para encontrar IDs de lugar. O exemplo de função do serviço de geocodificação a seguir retorna os IDs de lugar de todos os componentes de endereço nas coordenadas de latitude e longitude especificadas:

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

    Use a geocodificação inversa com filtragem de componentes para encontrar o componente de endereço de um ou mais destes tipos no local especificado:

    • administrativeArea
    • country
    • locality
    • postalCode
    • schoolDistrict

    O exemplo a seguir mostra o uso do serviço de geocodificação, adicionando restrições de componentes com geocodificação inversa para recuperar todos os componentes de endereço no local especificado para o tipo locality:

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