Informações gerais

Interface principal do SDK do Places.

Usado para pesquisar e ver detalhes sobre lugares. Essa classe deve ser acessada pelo método [GMSPlacesClient sharedClient].

Os métodos GMSPlacesClient só devem ser chamados a partir do thread principal. Chamar esses métodos de outra linha de execução resultará em uma exceção ou um comportamento indefinido. A menos que especificado de outra forma, todos os retornos de chamada serão invocados na linha de execução principal.

Funções públicas de membros
(nulo)	- lookUpPlaceID:callback:
	Ver detalhes de um lugar.
(nulo)	- lookUpPhotosForPlaceID:callback:
	Recebe os metadados de até 10 fotos associadas a um lugar.
(nulo)	- loadPlacePhoto:callback:
	Carrega a imagem de uma foto específica no tamanho máximo.
(nulo)	- loadPlacePhoto:restrictedToSize:scale:callback:
	Carrega a imagem de uma foto específica, dimensionada para se ajustar às dimensões máximas fornecidas.
(nulo)	- currentPlaceWithCallback:
	Retorna uma estimativa do lugar onde o dispositivo está localizado atualmente.
(nulo)	- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Encontre previsões de preenchimento automático de consulta de texto.
(nulo)	- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	Buscar detalhes de um lugar.
(nulo)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Encontre probabilidades de local usando a localização atual do usuário.
(nulo)	- isOpenWithPlaceID:callback:
	Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar `GMSPlaceOpenStatus` no momento atual.
(nulo)	- isOpenWithPlaceID:date:callback:
	Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar `GMSPlaceOpenStatus` no `NSDate` especificado.
(nulo)	- isOpenWithPlace:callback:
	Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar `GMSPlaceOpenStatus` no momento atual.
(nulo)	- isOpenWithPlace:date:callback:
	Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar `GMSPlaceOpenStatus` no `NSDate` especificado.
Funções estáticas de membros públicos
(instancetype)	+ sharedClient.
	Fornece a instância compartilhada de GMSPlacesClient para o SDK do Google Places para iOS, criando-a se necessário.
(BOOL)	+ provideAPIKey:
	Fornece sua chave de API para o SDK do Google Places para iOS.
(NSString *)	+ openSourceLicenseInfo
	Retorna informações de licença de software de código aberto do SDK do Google Places para iOS.
(NSString *)	+ SDKVersion
	Retorna a versão para esta versão do SDK do Google Places para iOS.
(NSString *)	+ SDKLongVersion
	Retorna a versão longa desta versão do SDK do Google Places para iOS.
Funções relacionadas
Essas funções não são membros.
typedef void(^	GMSPlaceResultCallback )(GMSPlace _Nullable result, NSError _Nullable error)
	Tipo de callback para receber pesquisas de detalhes de lugares.
typedef void(^	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Nullable likelihoodList, NSError _Nullable error)
	Tipo de callback para receber listas de probabilidade de lugar.
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Probabilidades anuláveis, NSError _Nullable error)
	Tipo de callback para receber uma matriz de `GMSPlaceLikelihood`s.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * * > _Nullable results, NSError _Nullable error)
	Tipo de callback para receber resultados de preenchimento automático.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Nullable photos, NSError _Nullable error)
	Tipo de callback para receber resultados de fotos de lugares.
typedef void(^	GMSPlacePhotoImageResultCallback)(UIImage _nullable photo, NSError _Nullable error)
	Tipo de callback para receber objetos `UIImage` de um objeto `GMSPlacePhotoMetadata`.
typedef void(^	GMSPlaceOpenStatusCallback )(resultado de GMSPlaceOpenStatus, NSError *_Nullable error)
	Tipo de callback para receber o status de horário de funcionamento do lugar.

Documentação da função do membro

+ (tipo de instância) sharedClient

Fornece a instância compartilhada de GMSPlacesClient para o SDK do Google Places para iOS, criando-a se necessário.

Se seu aplicativo usa frequentemente métodos de GMSPlacesClient, convém manter esse objeto diretamente, caso contrário, sua conexão com o Google pode ser reiniciada regularmente.

+ (BOOL) provideAPIKey: (NSString *) key

Fornece sua chave de API para o SDK do Google Places para iOS.

Essa chave é gerada para seu aplicativo por meio do Console do Google Cloud Platform e é pareada com o ID do pacote do seu aplicativo para identificá-la. Isso deve ser chamado pelo aplicativo antes de usar GMSPlacesClient (por exemplo, em application:didFinishLaunchingWithOptions:).

Retorna:: SIM, se a chave de API foi fornecida.

+ (NSString *) openSourceLicenseInfo

Retorna informações de licença de software de código aberto do SDK do Google Places para iOS.

Essas informações precisam ser disponibilizadas no seu aplicativo.

+ (NSString *) SDKVersion

Retorna a versão para esta versão do SDK do Google Places para iOS.

. Por exemplo, "1.0.0".

+ (NSString *) SDKLongVersion

Retorna a versão longa desta versão do SDK do Google Places para iOS.

Por exemplo, "1.0.0 (102.1)".

- (void) lookUpPlaceID:	(NSString *)	ID do local
retorno de chamada:	(GMSPlaceResultCallback).	callback

Ver detalhes de um lugar.

Esse método não causa bloqueios.

Parâmetros:

ID de lugar	O ID de lugar a ser pesquisado.
callback	O callback a ser invocado com o resultado da pesquisa.

- (void) lookUpPhotosForPlaceID:	(NSString *)	ID do local
retorno de chamada:	(GMSPlacePhotoMetadataResultCallback).	callback

Recebe os metadados de até 10 fotos associadas a um lugar.

As fotos são provenientes de vários locais, incluindo proprietários de empresas e fotos enviadas por usuários do Google+. Na maioria dos casos, essas fotos podem ser usadas sem atribuição ou terão a atribuição necessária incluída na imagem. No entanto, é necessário usar a propriedade attributions na resposta para recuperar quaisquer atribuições adicionais necessárias e exibir essas atribuições em seu aplicativo sempre que exibir a imagem. No máximo 10 fotos são retornadas.

Várias chamadas desse método provavelmente retornarão as mesmas fotos todas as vezes. No entanto, isso não é garantido, porque os dados subjacentes podem ter mudado.

Esse método executa uma pesquisa de rede.

Parâmetros:

ID de lugar	O ID de local para o qual as fotos serão pesquisadas.
callback	O callback a ser invocado com o resultado da pesquisa.

- (nulo) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata.
retorno de chamada:	(GMSPlacePhotoImageResultCallback)	callback

Carrega a imagem de uma foto específica no tamanho máximo.

Os dados da imagem podem ser armazenados em cache pelo SDK. Se a foto solicitada não existir no cache, será realizada uma pesquisa na rede.

Parâmetros:

metadados de foto	O `GMSPlacePhotoMetadata` para o qual carregar um `UIImage`.
callback	O callback a ser invocado com o `UIImage` carregado.

- (nulo) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata.
restrictedToSize:	(CGSize)	maxSize (em inglês)
escala:	(CGFloat)	escalar
retorno de chamada:	(GMSPlacePhotoImageResultCallback)	callback

Carrega a imagem de uma foto específica, dimensionada para se ajustar às dimensões máximas fornecidas.

A imagem será redimensionada para se ajustar às dimensões especificadas, mantendo a proporção da imagem original. Esse escalonamento é realizado no lado do servidor.

Se o parâmetro de escala não for 1.0, maxSize será multiplicado por esse valor e o UIImage retornado será definido para ter a escala especificada. Esse parâmetro deve ser definido para a escala da tela se você estiver carregando imagens para exibição.

Os dados da imagem podem ser armazenados em cache pelo SDK. Se a foto solicitada não existir no cache, será realizada uma pesquisa na rede.

Observação:: Após aplicar o fator de escala, as dimensões em maxSize serão arredondadas para o número inteiro mais próximo antes de serem usadas. Se for solicitada uma imagem maior que o tamanho máximo disponível, uma imagem menor poderá ser retornada.

Parâmetros:

metadados de foto	O `GMSPlacePhotoMetadata` para o qual carregar um `UIImage`.
tamanho máximo	O tamanho máximo da imagem.
escalonar	A escala em que a imagem será carregada.
callback	O callback a ser invocado com o `UIImage` carregado.

- (nulo) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) callback

Retorna uma estimativa do lugar onde o dispositivo está localizado atualmente.

Gera uma lista de probabilidade de lugar com base na última localização estimada do dispositivo. O retorno de chamada fornecido será invocado com esta lista de probabilidades após a conclusão e um NSError quando ocorrer um erro.

Observação:: Este método exige que o app tenha permissão para acessar a localização atual do dispositivo. Antes de chamar, certifique-se de solicitar acesso à localização dos usuários usando [CLLocationManager requestWhenInUseAuthorization] ou [CLLocationManager requestAlwaysAuthorization]. Se você chamar esse método e o app não tiver o status de autorização correto, o callback será chamado com um erro.

Parâmetros:

callback O callback a ser invocado com a lista de probabilidade de lugar.

- (void) findAutocompletePredictionsFromQuery:	(NSString *)	query
filtro:	(anulável GMSAutocompleteFilter *)	filter
sessionToken:	(GMSAutocompleteSessionToken * anulável)	sessionToken (em inglês)
retorno de chamada:	(GMSAutocompletePredictionsCallback)	callback

Encontre previsões de preenchimento automático de consulta de texto.

Os resultados podem ser direcionados para um local específico ou restritos a uma área. Esse método não causa bloqueios.

O retorno de chamada fornecido será invocado com uma matriz de previsões de preenchimento automático em caso de êxito e um NSError em caso de erro.

Parâmetros:

consulta	O texto parcial a ser preenchido automaticamente.
Função filter	O filtro a ser aplicado aos resultados. Este parâmetro pode ser nulo.
token de sessão	O `GMSAutocompleteSessionToken` para associar a solicitação a uma sessão de faturamento.
callback	O callback a ser invocado com as previsões.

- (nulo) fetchPlaceFromPlaceID:	(NSString *)	ID do local
placeFields:	(GMSPlaceField).	placeFields.
sessionToken:	(GMSAutocompleteSessionToken * anulável)	sessionToken (em inglês)
retorno de chamada:	(GMSPlaceResultCallback).	callback

Buscar detalhes de um lugar.

Esse método não causa bloqueios.

Parâmetros:

ID de lugar	O ID de lugar a ser pesquisado.
placeFields	Os campos de local individuais solicitados para os objetos de local na lista.
token de sessão	O `GMSAutocompleteSessionToken` para associar a solicitação a uma sessão de faturamento.
callback	O callback a ser invocado com o resultado da pesquisa.

- (nulo) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:	(GMSPlaceField).	placeFields.
retorno de chamada:	(GMSPlaceLikelihoodsCallback)	callback

Encontre probabilidades de local usando a localização atual do usuário.

Esse método não causa bloqueios.

O retorno de chamada fornecido será invocado com uma matriz de locais com pontuações de probabilidade em caso de sucesso e um NSError em caso de erro.

Parâmetros:

placeFields	Os campos de local individuais solicitados para os objetos de local na lista.
callback	O callback a ser invocado com probabilidades de local.

- (nulo) isOpenWithPlaceID:	(NSString *)	ID do local
retorno de chamada:	(GMSPlaceOpenStatusCallback)	callback

Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar GMSPlaceOpenStatus no momento atual.

Esse método não causa bloqueios.

Parâmetros:

ID de lugar	O ID de lugar a ser pesquisado.
callback	O callback a ser invocado com o resultado do lugar.

- (nulo) isOpenWithPlaceID:	(NSString *)	ID do local
data:	(NSDate *)	date
retorno de chamada:	(GMSPlaceOpenStatusCallback)	callback

Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar GMSPlaceOpenStatus no NSDate especificado.

Esse método não causa bloqueios.

Parâmetros:

ID de lugar	O ID de lugar a ser pesquisado.
date	O `NSDate` para determinar o status aberto.
callback	O callback a ser invocado com o resultado do lugar.

- (nulo) isOpenWithPlace:	(GMSPlace *)	lugar
retorno de chamada:	(GMSPlaceOpenStatusCallback)	callback

Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar GMSPlaceOpenStatus no momento atual.

Só solicitará campos adicionais se GMSPlace não tiver todos os campos necessários. Caso contrário, GMSPlaceOpenStatus será retornado no callback imediatamente. Esse método não causa bloqueios.

Parâmetros:

lugar	O `GMSPlace` a ser pesquisado.
callback	O callback a ser invocado com o resultado do lugar.

- (nulo) isOpenWithPlace:	(GMSPlace *)	lugar
data:	(NSDate *)	date
retorno de chamada:	(GMSPlaceOpenStatusCallback)	callback

Recebe detalhes de um lugar, incluindo todos os campos necessários para determinar GMSPlaceOpenStatus no NSDate especificado.

Só solicitará campos adicionais se GMSPlace não tiver todos os campos necessários. Caso contrário, GMSPlaceOpenStatus\ will be returned in the callback immediately. This method is non-blocking. .


Parameters:

  
    place The GMSPlace to lookup. 
    date The NSDate to determine open status for. 
    callback The callback to invoke with the place result.

- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_resultado nulo, NSError *_Nullable error)) [related]

Tipo de callback para receber pesquisas de detalhes de lugares.

Se ocorrer um erro, result será nulo e error conterá informações sobre o erro.

Parâmetros:

resultado	O `GMSPlace` que foi retornado.
error	O erro que ocorreu, se houver.

- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable likelihoodList, NSError *_Nullable error)) [related]

Tipo de callback para receber listas de probabilidade de lugar.

Se ocorrer um erro, likelihoodList será nulo e error conterá informações sobre o erro.

Parâmetros:

Lista de probabilidades	A lista de probabilidades de local.
error	O erro que ocorreu, se houver.

- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Probabilidades anuláveis, NSError *_Nullable error)) [related]

Tipo de callback para receber uma matriz de GMSPlaceLikelihoods.

Se ocorrer um erro, a matriz será nula e error conterá informações sobre o erro.

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related]

Tipo de callback para receber resultados de preenchimento automático.

results é uma matriz de GMSAutocompletePredictions representando as conclusões candidatas da consulta.

Parâmetros:

resultados	Uma matriz de `GMSAutocompletePrediction`s.
error	O erro que ocorreu, se houver.

- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)) [related]

Tipo de callback para receber resultados de fotos de lugares.

Se ocorrer um erro, photos será nulo e error conterá informações sobre o erro.

Parâmetros:

fotos	O resultado contendo objetos `GMSPlacePhotoMetadata`.
error	O erro que ocorreu, se houver.

- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable photo, NSError *_Nullable error)) [related]

Tipo de callback para receber objetos UIImage de um objeto GMSPlacePhotoMetadata.

Se ocorrer um erro, photo será nulo e error conterá informações sobre o erro.

Parâmetros:

foto	O `UIImage` que foi carregado.
error	O erro que ocorreu, se houver.

- (typedef void(^ GMSPlaceOpenStatusCallback)(resultado de GMSPlaceOpenStatus, NSError *_Nullable error)) [related]

Tipo de callback para receber o status de horário de funcionamento do lugar.

Se ocorrer um erro, result será GMSPlaceOpenStatusUnknown e error conterá informações sobre o erro.

Parâmetros:

resultado	O `GMSPlaceOpenStatus` que foi retornado.
error	O erro que ocorreu, se houver.

place	The `GMSPlace` to lookup.
date	The `NSDate` to determine open status for.
callback	The callback to invoke with the place result.

Referência da classe GMSPlacesClient

Informações gerais

Funções públicas de membros

Funções estáticas de membros públicos

Funções relacionadas

Documentação da função do membro

Amigos e documentação da função relacionada