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

Selecione a plataforma: iOS JavaScript

Você pode usar o SDK do Places para iOS e a API Geocoding com o SDK do Maps para iOS se quiser pesquisar regiões e conferir mais informações 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, reutilize esses IDs com o estilo baseado em dados para limites.

Adicione o Places e o Geocoding ao SDK do Maps para apps iOS das seguintes maneiras:

  • O SDK do Places para iOS retorna informações sobre lugares usando solicitações HTTP.
  • A classe CLGeocoder pode geocodificar e fazer a geocodificação inversa da entrada do usuário de forma dinâmica.
  • 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 locais 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 de permitir que os usuários pesquisem regiões. Para exibir os resultados na região definida, defina locationRestriction em GMSAutocompleteFilter.

Gerar detalhes de lugares em uma região

  • Os dados do Place Details de uma região também são eficazes. Por exemplo, você pode programar

    • Procurar IDs de lugares limites com base nos nomes deles.
    • Acessar a janela de visualização para aplicar zoom a um limite.
    • Descubra o tipo de elemento do limite (por exemplo, localidade).
    • Encontre 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 orientado a 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, localidade ou código postal.
    • Use a geocodificação inversa para encontrar IDs de lugar por coordenadas de latitude e longitude ou até mesmo retornar IDs de todos os componentes em um local específico.

    O exemplo a seguir usa um endereço (com escape 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

    Use a geocodificação inversa para encontrar esses IDs. 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 dos seguintes tipos no local especificado:

    • administrativeArea
    • country
    • locality
    • postalCode
    • schoolDistrict

    O exemplo a seguir mostra como usar o 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