Referência rápida do SDK do Places para iOS

Com o SDK do Places para iOS, os apps iOS recebem informações sobre lugares (empresas, pontos de interesse, localizações geográficas) usando o Place Details, o Place Photos, o Text Search, o Nearby Search e o Autocomplete. A API Places (nova) é a versão atual do SDK.

SDK do Places para iOS: informações importantes

  • Produto: SDK do Places para iOS
  • Também conhecido como: SDK do Places para iOS (novo)
  • Categoria: lugares
  • Plataforma: iOS
  • Executado em: cliente (código do app ou do navegador)
  • Estágio de lançamento: GA
  • Ciclo de vida: Ativo
  • Visão geral: Visão geral do SDK do Places para iOS

SDK do Places para iOS: quando usar

Use o SDK do Places para iOS quando:

  • Você precisa de Place Details, Fotos, Text Search ou resultados da pesquisa Nearby Search em um app iOS nativo.
  • Você precisa do preenchimento automático de nomes de lugares ou endereços conforme os usuários digitam em um app iOS.
  • Você quer componentes pré-criados do Kit de interface do Places (detalhes, pesquisa e preenchimento automático de lugares) em um app iOS.

Não use o SDK do Places para iOS quando:

SDK do Places para iOS: configuração

Pacotes oficiais do SDK do Places para iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

SDK do Places para iOS: erros comuns

  • Problema: as chamadas do SDK do Places para iOS (novo) vão falhar se a API Places (nova) não estiver ativada no projeto na nuvem ou não estiver na lista de APIs autorizadas da chave de API. Correção: ative a API Places (nova) e adicione-a às restrições de chave de API usadas pelo app. Consulte /maps/documentation/places/ios-sdk/legacy/migrate-overview.
  • Problema: kGMSPlacesRateLimitExceeded (-7) significa que a chave de API excedeu o limite de taxa de uso. Os apps em versões desativadas do SDK 2.x (desativadas em 29 de julho de 2019) também recebem esse erro. Correção: verifique a cota e o uso da API Places (nova) no console do Google Cloud e atualize os apps em versões do SDK anteriores à 3.0. Consulte /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode.
  • Problema: os tokens de sessão reutilizados em apps no mesmo projeto ou em sessões interrompem o agrupamento de faturamento da sessão de preenchimento automático. Correção: gere um token de sessão exclusivo (recomendamos o UUID versão 4) para cada sessão de preenchimento automático. Os tokens precisam ser exclusivos por projeto. Consulte /maps/documentation/places/ios-sdk/use-session-tokens.
  • Problema: os apps mostram dados de lugares sem as atribuições retornadas pela API. Correção: mostre todas as atribuições relevantes retornadas com os dados do Places, de acordo com a página de políticas. Consulte /maps/documentation/places/ios-sdk/overview.

SDK do Places para iOS: recursos legados e descontinuados

  • SDK do Places para iOS (versão legada): legado desde 01/03/2025. Substituição: SDK do Places para iOS (novo), que requer a API Places (nova). Sintoma: classes e métodos legados (por exemplo, fetchPlaceFromPlaceID, GMSAutocompleteFetcher e GMSAutocompleteViewController) não existem no SDK 11.0.0 e versões mais recentes, o que interrompe a compilação. Consulte o guia de migração.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner e GMSAutocompleteFetcher initWithBounds:filter: desativados desde 13/10/2020. Substituição: GMSAutocompleteFilter (locationBias ou locationRestriction) em GMSAutocompleteRequest por GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: ou os modificadores GooglePlacesSwift placeAutocomplete ou basicPlaceAutocomplete para um widget de interface. Sintoma: os métodos não existem no SDK 4.0.0 e versões mais recentes (e GMSAutocompleteResultsViewController e GMSAutocompleteFetcher foram removidos no SDK 11.0.0). Consulte o guia de migração.
  • Limites de preenchimento automático com base em GMSCoordinateBounds (parâmetros GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode de findAutocompletePredictionsFromQuery e autocompleteQuery): desativados desde 13/10/2020. Substituição: GMSAutocompleteRequest por GMSAutocompleteFilter (locationBias ou locationRestriction) e GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:, ou os modificadores GooglePlacesSwift placeAutocomplete ou basicPlaceAutocomplete para um widget de interface. Sintoma: as propriedades e os parâmetros não existem no SDK 4.0.0 e versões mais recentes (e GMSAutocompleteViewController e findAutocompletePredictionsFromQuery foram removidos no SDK 11.0.0). Consulte o guia de migração.
  • GMSPlace.openNowStatus: desativado desde 13/10/2020. Substituição: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) ou PlacesClient.isPlaceOpen(with:) em GooglePlacesSwift. Sintoma: a propriedade não existe no SDK 4.0.0 e em versões mais recentes. Consulte o guia de migração.
  • GMSPlaceField como NS_ENUM: desativado desde 13/10/2020. Substituição: constantes GMSPlaceProperty por classes de solicitação, como GMSFetchPlaceRequest e GMSPlaceSearchByTextRequest, ou PlaceProperty em GooglePlacesSwift. Sintoma: substituído por NS_OPTIONS no SDK 4.0.0 (GMSPlaceField, já que NS_OPTIONS pertence à API legada e não existe no SDK 11.0.0 e versões mais recentes). Consulte o guia de migração.
  • SDK do Places para iOS versão 2.7.0: desativado desde 29/07/2019. Substituição: versão atual do SDK do Places para iOS. Sintoma: erros kGMSPlacesRateLimitExceeded.

O que você pode fazer com o SDK do Places para iOS

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.

SDK do Places para iOS: IA generativa

SDK do Places para iOS: Places

SDK do Places para iOS: Kit de Interface do Places

  • Aplicar estilo CSS a um elemento da interface de dados de lugar. Observação: as propriedades personalizadas de CSS se aplicam aos elementos do Kit de Interface do Places da API Maps JavaScript. O SDK do Places para Android e o SDK do Places para iOS estilizam as visualizações do Kit de Interface do Places de forma programática usando atributos de tema e estilo. REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
  • Personalize o estilo e as configurações dos elementos da interface com dados de lugares usando uma ferramenta de personalização de elementos da interface. Observação: REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
  • Adicione um elemento da interface que mostre informações sobre um lugar específico em uma página da Web ou um app para dispositivos móveis. Observação: REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
  • Adicionar um elemento da interface que mostra uma lista de lugares com base em uma string de consulta em uma página da Web. Observação: compatível com páginas da Web (API Maps JavaScript) e apps para dispositivos móveis (SDK do Places para Android e SDK do Places para iOS). REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
  • Adicione um elemento da interface que mostre uma lista de lugares próximos a um local específico em uma página da Web. Observação: compatível com páginas da Web (API Maps JavaScript) e apps para dispositivos móveis (SDK do Places para Android e SDK do Places para iOS). REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq
  • Adicione um elemento da interface de preenchimento automático básico a uma página da Web ou app que retorna identificadores de lugares do Google com base em uma string de consulta. Observação: REQUISITO DE CONFORMIDADE DO EEE: para mostrar dados de lugares em um mapa no Espaço Econômico Europeu (EEE), não chame os serviços da Web da API Places de um servidor de back-end. Use os componentes do Kit de Interface do Places do lado do cliente na plataforma de destino (API Maps JavaScript na Web, SDK do Places para Android no Android ou SDK do Places para iOS no iOS). Requisitos completos e perguntas frequentes: https://developers.google.com/maps/comms/eea/faq