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:
- Você está criando um app Android nativo. Use o SDK do Places para Android.
- Você está criando uma página da Web no navegador. Use a API Maps JavaScript.
- Você precisa de dados de lugares de um servidor ou back-end por HTTP, em vez de um cliente iOS. Use a API Places (nova).
SDK do Places para iOS: configuração
- Serviço a ser ativado:
places.googleapis.com - Autenticação: chave de API
- Atribuição de uso: chame o método de classe
addInternalUsageAttributionIDemGMSPlacesClient(Objective-C/Swift) ouPlacesClient(GooglePlacesSwift) para adicionar um ID de atribuição de uso. Exclua a chamada para desativar. - Começar: configurar o SDK do Places para iOS
- Referência: referência do SDK do Places para iOS
- Preços: uso e faturamento do SDK do Places para iOS
- Políticas: políticas do SDK do Places para iOS
- Notas da versão: notas da versão do SDK do Places para iOS
Pacotes oficiais do SDK do Places para iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
SDK do Places para iOS: produtos relacionados
- Geralmente usado com: SDK do Maps para iOS
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,GMSAutocompleteFetchereGMSAutocompleteViewController) 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. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornereGMSAutocompleteFetcherinitWithBounds:filter: desativados desde 13/10/2020. Substituição:GMSAutocompleteFilter(locationBiasoulocationRestriction) emGMSAutocompleteRequestporGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:ou os modificadoresGooglePlacesSwiftplaceAutocompleteoubasicPlaceAutocompletepara um widget de interface. Sintoma: os métodos não existem no SDK 4.0.0 e versões mais recentes (eGMSAutocompleteResultsViewControllereGMSAutocompleteFetcherforam removidos no SDK 11.0.0). Consulte o guia de migração.- Limites de preenchimento automático com base em
GMSCoordinateBounds(parâmetrosGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModedefindAutocompletePredictionsFromQueryeautocompleteQuery): desativados desde 13/10/2020. Substituição:GMSAutocompleteRequestporGMSAutocompleteFilter(locationBiasoulocationRestriction) eGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:, ou os modificadoresGooglePlacesSwiftplaceAutocompleteoubasicPlaceAutocompletepara um widget de interface. Sintoma: as propriedades e os parâmetros não existem no SDK 4.0.0 e versões mais recentes (eGMSAutocompleteViewControllerefindAutocompletePredictionsFromQueryforam removidos no SDK 11.0.0). Consulte o guia de migração. GMSPlace.openNowStatus: desativado desde 13/10/2020. Substituição:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) ouPlacesClient.isPlaceOpen(with:)emGooglePlacesSwift. Sintoma: a propriedade não existe no SDK 4.0.0 e em versões mais recentes. Consulte o guia de migração.GMSPlaceFieldcomoNS_ENUM: desativado desde 13/10/2020. Substituição: constantesGMSPlacePropertypor classes de solicitação, comoGMSFetchPlaceRequesteGMSPlaceSearchByTextRequest, ouPlacePropertyemGooglePlacesSwift. Sintoma: substituído porNS_OPTIONSno SDK 4.0.0 (GMSPlaceField, já queNS_OPTIONSpertence à 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
- Retorna um resumo gerado com IA das avaliações de usuários para um identificador de lugar do Google especificado.
- Retorna um resumo gerado com IA da área e das comodidades ao redor de um identificador de lugar do Google especificado para uma estação de recarga de veículos elétricos.
SDK do Places para iOS: Places
- Retorna uma lista de lugares e Place Details com base em uma string de consulta.
- Retornar uma lista de lugares e Place Details perto de um local específico.
- Retorna resultados de preenchimento automático sobre lugares com base em uma string de consulta.
- Retornar informações detalhadas sobre um lugar específico.
- Retornar fotos de um lugar específico. Observação: mostre as atribuições do autor de cada foto (o nome do autor, vinculado ao URI do perfil) com a foto. As políticas do Places para cada plataforma exigem isso, por exemplo, /maps/documentation/javascript/policies#photo-attributions e /maps/documentation/places/web-service/policies#photos-and-review.
- Redimensionar fotos de lugares
- Retornar notas e avaliações de um lugar específico. Observação: no serviço da web da API Places (nova), o Place Details é uma solicitação GET HTTP para https://places.googleapis.com/v1/places/{placeId} com X-Goog-FieldMask (por exemplo, rating,userRatingCount,reviews). O Text Search, o Nearby Search e o Autocomplete usam POST. No Android, transmita Place.Field.RATING, USER_RATING_COUNT e REVIEWS para PlacesClient.fetchPlace(). No iOS, transmita GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal e GMSPlacePropertyReviews em GMSFetchPlaceRequest.
- Adicione um widget de preenchimento automático a uma página da Web ou app que retorna resultados sobre lugares com base em uma string de consulta.
- Especifique os campos de dados incluídos nas respostas de informações de lugar.
- Especifique os tipos de lugar que serão incluídos nas respostas com informações sobre lugares.
- Retornar informações sobre o lugar onde o dispositivo do usuário está localizado. Observação: os métodos legados do Local Atual foram removidos do SDK do Places para Android v6.0+ e do SDK do Places para iOS v11.0+. Recupere as coordenadas do dispositivo nos serviços de localização da plataforma e chame o Nearby Search.
- Retorna um resumo de visão geral criada por IA para um lugar específico.
- Retornar um resumo de área gerado com IA que descreve os lugares ao redor de um local específico.
- Retorna informações sobre lugares com base em uma string de consulta que estão localizados ao longo de um trajeto predefinido.
- Retornar distância, tempo de viagem e URI de rotas para lugares de Text Search com base em um conjunto de coordenadas de latitude/longitude.
- Retornar a distância, o tempo de viagem e o URI de rotas para lugares por perto de um conjunto de coordenadas de latitude/longitude.
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