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 para 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 lugar. Se você já usa esses IDs, reutilize esses IDs com o estilo baseado em dados para limites.

Adicione o Places e o Geocoding aos 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 geocodificar e inverter a geocodificação 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 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 qualquer viés de local definido.

  • O serviço Places Autocomplete oferece uma maneira conveniente de permitir que os usuários pesquisem regiões. Para exibir resultados na região definida, defina locationRestriction em GMSAutocompleteFilter.

Gerar detalhes de lugares em uma região

  • Os dados do Place Details para 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.
    • Encontre o tipo de elemento do limite (por exemplo, região administrativa).
    • Consiga 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, é possível converter um endereço, coordenadas de latitude e longitude ou ID de lugar em coordenadas geográficas e vice-versa. Os seguintes usos 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 a 4, da região administrativa ou do 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

    Você pode 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 dos seguintes 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