Descripción general

Interfaz principal del SDK de Places.

Se utiliza para buscar y obtener detalles sobre lugares. Se debe acceder a esta clase a través del método [GMSPlacesClient sharedClient].

Solo se debe llamar a los métodos GMSPlacesClient desde el subproceso principal. Llamar a estos métodos desde otro subproceso dará como resultado una excepción o un comportamiento indefinido. A menos que se especifique lo contrario, se invocarán todas las devoluciones de llamada en el subproceso principal.

Funciones de miembros públicas
(nulo)	- lookUpPlaceID:callback:
	Obtener detalles de un lugar
(nulo)	- lookUpPhotosForPlaceID:callback:
	Obtiene los metadatos de hasta 10 fotos relacionadas con un lugar.
(nulo)	- loadPlacePhoto:callback:
	Carga la imagen de una foto específica a su tamaño máximo.
(nulo)	- loadPlacePhoto:restrictedToSize:scale:callback:
	Carga la imagen de una foto específica y ajusta su tamaño para que se ajuste a las dimensiones máximas indicadas.
(nulo)	- currentPlaceWithCallback:
	Muestra una estimación del lugar donde se sabe que se encuentra actualmente el dispositivo.
(nulo)	- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Busca predicciones de Autocomplete a partir de una búsqueda de texto.
(nulo)	- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	Recupera los detalles de un lugar.
(nulo)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Busca las probabilidades de lugares con la ubicación actual del usuario.
Funciones de miembros públicos estáticos
(tipo de instancia)	+ sharedClient
	Proporciona la instancia compartida de GMSPlacesClient para el SDK de Google Places para iOS y la crea si es necesario.
(BOOL)	+ ProvideAPIKey:
	Proporciona tu clave de API al SDK de Google Places para iOS.
(NSString *)	+ openSourceLicenseInfo
	Muestra la información de la licencia de software de código abierto del SDK de Google Places para iOS.
(NSString *)	+ SDKVersion
	Muestra la versión de esta versión del SDK de Google Places para iOS.
(NSString *)	+ SDKLongVersion
	Muestra la versión larga de esta versión del SDK de Google Places para iOS.
Funciones relacionadas
Ten en cuenta que estas no son funciones de los miembros.
typedef void(^	GMSPlaceResultCallback )(GMSPlace _resultado anulable, NSError _Error anulable)
	Tipo de devolución de llamada para recibir búsquedas de detalles del lugar.
typedef void(^	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Lista_probable anulable, NSError _Error anulable)
	Tipo de devolución de llamada para recibir listas de probabilidades de lugares.
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Probabilidades nulas, NSError _Error anulable)
	Tipo de devolución de llamada para recibir un array de `GMSPlaceLikelihood`.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > _Resultados anulables, NSError _Error anulable)
	Tipo de devolución de llamada para recibir resultados de autocompletado.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Fotos que se pueden anular, NSError _Error anulable)
	Tipo de devolución de llamada para recibir resultados de fotos de lugares.
typedef void(^	GMSPlacePhotoImageResultCallback )(UIImage _Nullable Photo, NSError _Nullable error)
	Tipo de devolución de llamada para recibir objetos `UIImage` de un objeto `GMSPlacePhotoMetadata`.

Documentación de la función de miembro

+ (instancetype) sharedClient

Proporciona la instancia compartida de GMSPlacesClient para el SDK de Google Places para iOS y la crea si es necesario.

Si tu aplicación a menudo usa métodos de GMSPlacesClient, es posible que quieras retener este objeto directamente, ya que, de lo contrario, tu conexión a Google podría reiniciarse periódicamente.

+ (BOOL) ProvideAPIKey: (NSString *) key

Proporciona tu clave de API al SDK de Google Places para iOS.

Esta clave se genera para su aplicación a través de Google Cloud Platform Console y se sincroniza con el ID del paquete de la aplicación para identificarla. La aplicación debe llamar a esta función antes de utilizar GMSPlacesClient (p.ej., en application:didFinishLaunchingWithOptions:).

Muestra:: SÍ, si la APIKey se proporcionó correctamente.

+ (NSString *) openSourceLicenseInfo

Muestra la información de la licencia de software de código abierto del SDK de Google Places para iOS.

Esta información debe estar disponible en tu aplicación.

+ (NSString *) SDKVersion

Muestra la versión de esta versión del SDK de Google Places para iOS.

. Por ejemplo, “1.0.0”.

+ (NSString *) SDKLongVersion

Muestra la versión larga de esta versión del SDK de Google Places para iOS.

. Por ejemplo, "1.0.0 (102.1)".

- (void) lookUpPlaceID:	(NSString *)	IDdelugar
devolución de llamada:	(GMSPlaceResultCallback).	devolución de llamada

Obtener detalles de un lugar

Este método no genera bloqueos.

Parámetros:

ID de lugar	El ID de lugar que se buscará.
callback	Es la devolución de llamada que se invoca con el resultado de la búsqueda.

- (void) lookUpPhotosForPlaceID:	(NSString *)	IDdelugar
devolución de llamada:	(GMSPlacePhotoMetadataResultCallback).	devolución de llamada

Obtiene los metadatos de hasta 10 fotos relacionadas con un lugar.

Las fotos provienen de una variedad de ubicaciones, incluidos propietarios de empresas y fotos que aportan los usuarios de Google+. En la mayoría de los casos, estas fotos se pueden utilizar sin atribución o tendrán la atribución requerida incluida como parte de la imagen. Sin embargo, debes usar la propiedad attributions en la respuesta para recuperar las atribuciones adicionales requeridas y mostrarlas en tu aplicación en cualquier lugar donde muestres la imagen. Se muestra un máximo de 10 fotos.

Es probable que varias llamadas de este método muestren las mismas fotos cada vez. Sin embargo, esto no está garantizado porque es posible que los datos subyacentes hayan cambiado.

Este método realiza una búsqueda de red.

Parámetros:

ID de lugar	El ID de lugar para buscar fotos.
callback	Es la devolución de llamada que se invoca con el resultado de la búsqueda.

- (void) loadPlacePhoto:	(GMSPlacePhotoMetadata *).	photoMetadata
devolución de llamada:	(GMSPlacePhotoImageResultCallback)	devolución de llamada

Carga la imagen de una foto específica a su tamaño máximo.

Es posible que el SDK almacene en caché los datos de imágenes. Si la foto solicitada no existe en la caché, se realizará una búsqueda de red.

Parámetros:

Fotofotos	El `GMSPlacePhotoMetadata` para el que se carga una `UIImage`.
callback	Es la devolución de llamada que se invoca con el `UIImage` cargado.

- (void) loadPlacePhoto:	(GMSPlacePhotoMetadata *).	photoMetadata
restrictedToSize:	(CGSize)	Tamaño máx.
Escala:	(CGFloat)	escala
devolución de llamada:	(GMSPlacePhotoImageResultCallback)	devolución de llamada

Carga la imagen de una foto específica y ajusta su tamaño para que se ajuste a las dimensiones máximas indicadas.

Se ajustará la escala de la imagen para que se ajuste a las dimensiones indicadas y se mantendrá la relación de aspecto de la imagen original. Este escalamiento se realiza en el servidor.

Si el parámetro de escala no es 1.0, el tamaño máx. se multiplicará por este valor y el UIImage que se muestre tendrá la escala especificada. Este parámetro debe establecerse en la escala de la pantalla si estás cargando imágenes para mostrar en la pantalla.

Es posible que el SDK almacene en caché los datos de imágenes. Si la foto solicitada no existe en la caché, se realizará una búsqueda de red.

Nota:: Después de aplicar el factor de escala, las dimensiones en maxSize se redondearán hacia arriba al número entero más cercano antes de usarlo. Si se solicita una imagen que es mayor que el tamaño máximo disponible, se puede mostrar una imagen más pequeña.

Parámetros:

Fotofotos	El `GMSPlacePhotoMetadata` para el que se carga una `UIImage`.
tamaño máx.	El tamaño máximo de la imagen.
de Google.	La escala en la que se cargará la imagen.
callback	Es la devolución de llamada que se invoca con el `UIImage` cargado.

- (void) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback). callback

Muestra una estimación del lugar donde se sabe que se encuentra actualmente el dispositivo.

Genera una lista de probabilidades de lugares en función de la ubicación estimada más reciente del dispositivo. La devolución de llamada proporcionada se invocará con esta lista de probabilidades en caso de éxito y un NSError en caso de error.

Nota:: Este método requiere que la app tenga permiso para acceder a la ubicación actual del dispositivo. Antes de llamar a esta función, asegúrate de solicitar acceso a la ubicación de los usuarios mediante [CLLocationManager requestWhenInUseAuthorization] o [CLLocationManager requestAlwaysAuthorization]. Si llamas a este método y tu app no tiene el estado de autorización correcto, la devolución de llamada se realizará con un error.

Parámetros:

callback Es la devolución de llamada para invocar con la lista de probabilidades de lugares.

- (void) findAutocompletePredictionsFromQuery:	(NSString *)	query
filtro:	(GMSAutocompleteFilter anulable *)	filtro
sessionToken:	(GMSAutocompleteSessionToken anulable *)	sessionToken;
devolución de llamada:	(GMSAutocompletePredictionsCallback)	devolución de llamada

Busca predicciones de Autocomplete a partir de una búsqueda de texto.

De manera opcional, los resultados pueden restringirse a una ubicación determinada o restringirse a un área. Este método no genera bloqueos.

La devolución de llamada proporcionada se invocará con un array de predicciones de autocompletado cuando se realice correctamente y un NSError en caso de que se produzca un error.

Parámetros:

verá la consulta cuando se guarde	El texto parcial que se autocompletará.
filtro	Es el filtro que se aplicará a los resultados. Este parámetro puede ser nulo.
sessionToken	El `GMSAutocompleteSessionToken` para asociar la solicitud a una sesión de facturación.
callback	Es la devolución de llamada que se invoca con las predicciones.

- (void) fetchPlaceFromPlaceID:	(NSString *)	IDdelugar
placeFields:	(GMSPlaceField)	lugares
sessionToken:	(GMSAutocompleteSessionToken anulable *)	sessionToken;
devolución de llamada:	(GMSPlaceResultCallback).	devolución de llamada

Recupera los detalles de un lugar.

Este método no genera bloqueos.

Parámetros:

ID de lugar	El ID de lugar que se buscará.
CamposPlace	Los campos de lugar individuales solicitados para los objetos de lugar en la lista.
sessionToken	El `GMSAutocompleteSessionToken` para asociar la solicitud a una sesión de facturación.
callback	Es la devolución de llamada que se invoca con el resultado de la búsqueda.

- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:	(GMSPlaceField)	lugares
devolución de llamada:	(GMSPlaceLikelihoodsCallback).	devolución de llamada

Busca las probabilidades de lugares con la ubicación actual del usuario.

Este método no genera bloqueos.

La devolución de llamada proporcionada se invocará con un array de lugares con puntuaciones de probabilidad de éxito y un NSError si se produce un error.

Parámetros:

CamposPlace	Los campos de lugar individuales solicitados para los objetos de lugar en la lista.
callback	Es la devolución de llamada para invocar con probabilidades de uso de sitios.

- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_resultado anulable, NSError *_error anulable) [related]

Tipo de devolución de llamada para recibir búsquedas de detalles del lugar.

Si se produce un error, result será nulo y error contendrá información sobre el error.

Parámetros:

resultado	El `GMSPlace` que se mostró.
error	El error que se produjo, si corresponde.

- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nulidad de probabilidad probable, NSError *_Error anulable) [related]

Tipo de devolución de llamada para recibir listas de probabilidades de lugares.

Si se produce un error, likelihoodList será nulo y error contendrá información sobre el error.

Parámetros:

Lista de probabilidades	La lista de probabilidades de lugares.
error	El error que se produjo, si corresponde.

- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable probables, NSError *_Nullable error) [related]

Tipo de devolución de llamada para recibir un array de GMSPlaceLikelihood.

Si se produce un error, el array será nulo y error contendrá información sobre el error.

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Resultados anulables, NSError *_Error anulable) [related]

Tipo de devolución de llamada para recibir resultados de autocompletado.

results es un array de GMSAutocompletePredictions que representa la finalización de solicitudes de los candidatos.

Parámetros:

resultados	Un array de `GMSAutocompletePrediction`
error	El error que se produjo, si corresponde.

- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Fotos anulables, NSError *_Error anulable) [related]

Tipo de devolución de llamada para recibir resultados de fotos de lugares.

Si se produce un error, photos será nulo y error contendrá información sobre el error.

Parámetros:

fotos	El resultado que contiene objetos `GMSPlacePhotoMetadata`.
error	El error que se produjo, si corresponde.

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

Tipo de devolución de llamada para recibir objetos UIImage de un objeto GMSPlacePhotoMetadata.

Si se produce un error, photo será nulo y error contendrá información sobre el error.

Parámetros:

foto	El `UIImage` que se cargó.
error	El error que se produjo, si corresponde.

Referencia de la clase GMSPlacesClient

Descripción general

Funciones de miembros públicas

Funciones de miembros públicos estáticos

Funciones relacionadas

Documentación de la función de miembro

Documentación de amigos y funciones relacionadas