Présentation

Interface principale du SDK Places

Permet de rechercher et d'obtenir des informations sur des lieux. Vous devez accéder à cette classe via la méthode [GMSPlacesClient sharedClient].

Les méthodes GMSPlacesClient ne doivent être appelées qu'à partir du thread principal. L'appel de ces méthodes à partir d'un autre thread entraînera une exception ou un comportement non défini. Sauf indication contraire, tous les rappels seront appelés sur le thread principal.

Fonctions de membre public
(void)	- lookUpPlaceID:callback:
	Obtenez des informations sur un lieu.
(void)	- lookUpPhotosForPlaceID:callback:
	Récupère les métadonnées de 10 photos associées à un lieu au maximum.
(void)	- loadPlacePhoto:callback:
	Charge l'image d'une photo spécifique en taille maximale.
(void)	- loadPlacePhoto:constrainedToSize:scale:callback:
	Charge l'image d'une photo spécifique, mise à l'échelle pour s'adapter aux dimensions maximales données.
(void)	- currentPlaceWithCallback:
	Affiche une estimation du lieu où se trouve actuellement l'appareil.
(void)	- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Rechercher des prédictions de saisie semi-automatique à partir d'une requête textuelle.
(void)	- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	Permet d'extraire les détails d'un lieu.
(void)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Trouvez les probabilités de lieux à l'aide de la position actuelle de l'utilisateur.
(void)	- isOpenWithPlaceID:callback:
	Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer `GMSPlaceOpenStatus` à l'heure actuelle.
(void)	- isOpenWithPlaceID:date:callback:
	Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer `GMSPlaceOpenStatus` au `NSDate` spécifié.
(void)	- isOpenWithPlace:callback:
	Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer `GMSPlaceOpenStatus` à l'heure actuelle.
(void)	- isOpenWithPlace:date:callback:
	Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer `GMSPlaceOpenStatus` au `NSDate` spécifié.
(void)	- searchByTextWithRequest:callback:
	Recherchez des lieux à l'aide de texte et de restrictions.
Fonctions de membre public statiques
(type d'instance)	+ sharedClient
	Fournit l'instance partagée de GMSPlacesClient pour le SDK Google Places pour iOS, en la créant si nécessaire.
(BOOL)	+ provideAPIKey :
	Fournit votre clé API au SDK Google Places pour iOS.
(NSString *)	+ openSourceLicenseInfo
	Affiche les informations de licence du logiciel Open Source pour le SDK Google Places pour iOS.
(NSString *)	+ SDKVersion
	Affiche la version correspondant à cette version du SDK Google Places pour iOS.
(NSString *)	+ SDKLongVersion
	Affiche la version longue de cette version du SDK Google Places pour iOS.
Fonctions associées
Notez qu'il ne s'agit pas de fonctions membres.
typedef void(^	GMSPlaceResultCallback )(GMSPlace _Nullable résultat, NSError _Nullable erreur)
	Type de rappel pour la réception des recherches de détails sur un lieu.
typedef void(^	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Nullable probabilitéList, NSError _Nullable erreur)
	Type de rappel pour la réception de listes de probabilité de lieu.
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Nullable probabilités, NSError _Nullable erreur)
	Type de rappel pour la réception d'un tableau de `GMSPlaceLikelihood`.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > _Nullable results, NSError _Nullable erreur)
	Type de rappel pour la réception des résultats de saisie semi-automatique.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Nullable photos, NSError _Nullable erreur)
	Type de rappel pour la réception des résultats concernant les photos de lieu.
typedef void(^	GMSPlacePhotoImageResultCallback )(UIImage _Nullable photo, NSError _Nullable erreur)
	Type de rappel pour la réception d'objets `UIImage` à partir d'un objet `GMSPlacePhotoMetadata`.
typedef void(^	GMSPlaceOpenStatusCallback)(résultat GMSPlaceOpenStatus, erreur NSError *_Nullable)
	Type de rappel pour recevoir les horaires d'ouverture de l'établissement.
typedef void(^	GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > _Nullable places, NSError _Nullable erreur)
	Type de rappel pour la réception de résultats de recherche au format texte.

Documentation sur les fonctions de membre

+ (type d'instance) sharedClient

Fournit l'instance partagée de GMSPlacesClient pour le SDK Google Places pour iOS, en la créant si nécessaire.

Si votre application utilise souvent des méthodes GMSPlacesClient, il peut être judicieux de conserver directement cet objet, sinon votre connexion à Google risque d'être redémarrée régulièrement.

+ (BOOL) provideAPIKey: (NSString *) clé

Fournit votre clé API au SDK Google Places pour iOS.

Cette clé est générée pour votre application via la console Google Cloud Platform. Elle est associée à l'ID de bundle de votre application afin de l'identifier. Elle doit être appelée par votre application avant d'utiliser GMSPlacesClient (par exemple, dans application:didFinishLaunchingWithOptions:).

Renvoie :: OUI si la clé API a bien été fournie.

+ (NSString *) openSourceLicenseInfo

Affiche les informations de licence du logiciel Open Source pour le SDK Google Places pour iOS.

Ces informations doivent être disponibles dans votre demande.

+ (NSString *) SDKVersion

Affiche la version correspondant à cette version du SDK Google Places pour iOS.

(par exemple, "1.0.0").

+ (NSString *) SDKLongVersion

Affiche la version longue de cette version du SDK Google Places pour iOS.

. Par exemple, "1.0.0 (102.1)".

- (void) lookUpPlaceID:	(NSString *)	placeID
rappel:	(GMSPlaceResultCallback)	rappel

Obtenez des informations sur un lieu.

Cette méthode est non bloquante.

Paramètres :

placeID	ID de lieu à rechercher.
rappel	Rappel à invoquer avec le résultat de la recherche.

- (void) lookUpPhotosForPlaceID:	(NSString *)	placeID
rappel:	(GMSPlacePhotoMetadataResultCallback)	rappel

Récupère les métadonnées de 10 photos associées à un lieu au maximum.

Les photos proviennent de plusieurs sources, y compris celles des propriétaires d'entreprise et des contributions des utilisateurs de Google+. Dans la plupart des cas, ces photos peuvent être utilisées sans attribution, ou bien la mention requise sera incluse dans l'image. Toutefois, vous devez utiliser la propriété attributions dans la réponse pour récupérer les attributions supplémentaires requises, et afficher ces attributions dans votre application partout où vous affichez l'image. Un maximum de 10 photos sont renvoyées.

Si vous appelez cette méthode à plusieurs reprises, vous obtiendrez probablement les mêmes photos à chaque fois. Toutefois, cela n'est pas garanti, car les données sous-jacentes peuvent avoir changé.

Cette méthode effectue une recherche réseau.

Paramètres :

placeID	ID de lieu pour lequel rechercher des photos.
rappel	Rappel à invoquer avec le résultat de la recherche.

- (void) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata
rappel:	(GMSPlacePhotoImageResultCallback)	rappel

Charge l'image d'une photo spécifique en taille maximale.

Les données d'image peuvent être mises en cache par le SDK. Si la photo demandée n'existe pas dans le cache, une recherche du réseau est effectuée.

Paramètres :

photoMetadata	Le `GMSPlacePhotoMetadata` pour lequel charger un `UIImage`.
rappel	Rappel à invoquer avec le `UIImage` chargé.

- (void) loadPlacePhoto:	(GMSPlacePhotoMetadata *)	photoMetadata
constrainedToSize:	(Taille du verre de protection)	maxSize
d'échelle:	(CGFloat)	à grande échelle
rappel:	(GMSPlacePhotoImageResultCallback)	rappel

Charge l'image d'une photo spécifique, mise à l'échelle pour s'adapter aux dimensions maximales données.

L'image sera mise à l'échelle pour s'adapter aux dimensions données tout en conservant les proportions de l'image d'origine. Ce scaling est effectué côté serveur.

Si le paramètre "scale" n'est pas 1.0, la valeur "maxSize" est multipliée par cette valeur, et la valeur UIImage renvoyée est définie sur l'échelle spécifiée. Ce paramètre doit être défini sur l'échelle de l'écran si vous chargez des images à afficher à l'écran.

Les données d'image peuvent être mises en cache par le SDK. Si la photo demandée n'existe pas dans le cache, une recherche du réseau est effectuée.

Remarque :: Après avoir appliqué le facteur d'échelle, les dimensions de "maxSize" sont arrondies à l'entier le plus proche avant utilisation. Si vous demandez une image dont la taille est supérieure à la taille maximale disponible, une image plus petite peut être renvoyée.

Paramètres :

photoMetadata	Le `GMSPlacePhotoMetadata` pour lequel charger un `UIImage`.
maxSize	Taille maximale de l'image.
Google.	Échelle de chargement de l'image.
rappel	Rappel à invoquer avec le `UIImage` chargé.

- (void) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) callback

Affiche une estimation du lieu où se trouve actuellement l'appareil.

Génère une liste de probabilité de lieu en fonction de la dernière position estimée de l'appareil. Le rappel fourni est invoqué avec cette liste de probabilités en cas de réussite, et NSError en cas d'erreur.

Remarque :: Cette méthode nécessite que votre application soit autorisée à accéder à la position actuelle de l'appareil. Avant d'appeler cette méthode, veillez à demander l'accès à la position des utilisateurs à l'aide de [CLLocationManager requestwhenInUseAuthorization] ou [CLLocationManager requestAlwaysAuthorization]. Si vous appelez cette méthode et que votre application ne dispose pas de l'état d'autorisation approprié, le rappel sera appelé avec une erreur.

Paramètres :

rappel Rappel à invoquer avec la liste de probabilités de lieux.

- (void) findAutocompletePredictionsFromQuery:	(NSString *)	query
filtre :	(GMSAutocompleteFilter* pouvant avoir une valeur nulle)	filtrer
sessionToken:	(GMSAutocompleteSessionToken pouvant avoir une valeur nulle *)	sessionToken
rappel:	(GMSAutocompletePredictionsCallback).	rappel

Rechercher des prédictions de saisie semi-automatique à partir d'une requête textuelle.

Les résultats peuvent éventuellement être pondérés en faveur d'un lieu donné ou limités à une zone spécifique. Cette méthode est non bloquante.

Le rappel fourni sera invoqué avec un tableau de prédictions de saisie semi-automatique en cas de réussite et une erreur NSError en cas d'erreur.

Paramètres :

requête	Texte partiel à utiliser pour la saisie semi-automatique.
filtre	Filtre à appliquer aux résultats. Ce paramètre peut avoir la valeur "nil".
sessionToken	Le `GMSAutocompleteSessionToken` permettant d'associer la requête à une session de facturation.
rappel	Rappel à invoquer avec les prédictions.

- (void) fetchPlaceFromPlaceID:	(NSString *)	placeID
placeFields:	(GMSPlaceField).	placeFields
sessionToken:	(GMSAutocompleteSessionToken pouvant avoir une valeur nulle *)	sessionToken
rappel:	(GMSPlaceResultCallback)	rappel

Permet d'extraire les détails d'un lieu.

Cette méthode est non bloquante.

Paramètres :

placeID	ID de lieu à rechercher.
placeFields	Champs de lieu individuels demandés pour les objets de lieu dans la liste.
sessionToken	Le `GMSAutocompleteSessionToken` permettant d'associer la requête à une session de facturation.
rappel	Rappel à invoquer avec le résultat de la recherche.

- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:	(GMSPlaceField).	placeFields
rappel:	(GMSPlaceLikelihoodsCallback)	rappel

Trouvez les probabilités de lieux à l'aide de la position actuelle de l'utilisateur.

Cette méthode est non bloquante.

Le rappel fourni sera invoqué avec un tableau de lieux avec des scores de probabilité en cas de réussite et une erreur NSError en cas d'erreur.

Paramètres :

placeFields	Champs de lieu individuels demandés pour les objets de lieu dans la liste.
rappel	Rappel à invoquer avec les probabilités de lieu.

- (void) isOpenWithPlaceID:	(NSString *)	placeID
rappel:	(GMSPlaceOpenStatusCallback)	rappel

Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer GMSPlaceOpenStatus à l'heure actuelle.

Cette méthode est non bloquante.

Paramètres :

placeID	ID de lieu à rechercher.
rappel	Rappel à invoquer avec le résultat du lieu.

- (void) isOpenWithPlaceID:	(NSString *)	placeID
Date :	(NSDate *)	date
rappel:	(GMSPlaceOpenStatusCallback)	rappel

Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer GMSPlaceOpenStatus au NSDate spécifié.

Cette méthode est non bloquante.

Paramètres :

placeID	ID de lieu à rechercher.
date	`NSDate` pour lequel déterminer l'état d'ouverture.
rappel	Rappel à invoquer avec le résultat du lieu.

- (void) isOpenWithPlace:	(GMSPlace *)	lieu
rappel:	(GMSPlaceOpenStatusCallback)	rappel

Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer GMSPlaceOpenStatus à l'heure actuelle.

Ne demande des champs supplémentaires que si GMSPlace ne contient pas tous les champs nécessaires. Sinon, GMSPlaceOpenStatus est immédiatement renvoyé dans le rappel. Cette méthode est non bloquante.

Paramètres :

lieu	`GMSPlace` à rechercher.
rappel	Rappel à invoquer avec le résultat du lieu.

- (void) isOpenWithPlace:	(GMSPlace *)	lieu
Date :	(NSDate *)	date
rappel:	(GMSPlaceOpenStatusCallback)	rappel

Récupère les détails d'un lieu, y compris tous les champs nécessaires pour déterminer GMSPlaceOpenStatus au NSDate spécifié.

Ne demande des champs supplémentaires que si GMSPlace ne contient pas tous les champs nécessaires. Sinon, GMSPlaceOpenStatus est immédiatement renvoyé dans le rappel. Cette méthode est non bloquante.

Paramètres :

lieu	`GMSPlace` à rechercher.
date	`NSDate` pour lequel déterminer l'état d'ouverture.
rappel	Rappel à invoquer avec le résultat du lieu.

- (void) searchByTextWithRequest:	(GMSPlaceSearchByTextRequest *)	textSearchRequest
rappel:	(GMSPlaceSearchByTextResultCallback)	rappel

Recherchez des lieux à l'aide de texte et de restrictions.

Cette méthode est non bloquante.

Paramètres :

textSearchRequest	`GMSPlaceSearchByTextRequest` : requête de texte à utiliser pour la requête.
rappel	Rappel à invoquer avec le résultat de la recherche.

- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable résultat, NSError *_Nullable erreur)) [related]

Type de rappel pour la réception des recherches de détails sur un lieu.

Si une erreur s'est produite, result sera nul et error contiendra des informations sur l'erreur.

Paramètres :

résultat	`GMSPlace` renvoyé.
error	Erreur qui s'est produite, le cas échéant.

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

Type de rappel pour la réception de listes de probabilité de lieu.

Si une erreur s'est produite, likelihoodList sera nul et error contiendra des informations sur l'erreur.

Paramètres :

likelihoodList	Liste des probabilités de lieu.
error	Erreur qui s'est produite, le cas échéant.

- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable probabilités, NSError *_Nullable erreur)) [related]

Type de rappel pour la réception d'un tableau de GMSPlaceLikelihood.

Si une erreur s'est produite, le tableau sera nul et error contiendra des informations sur l'erreur.

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

Type de rappel pour la réception des résultats de saisie semi-automatique.

results est un tableau de GMSAutocompletePredictions représentant les suggestions de saisie de la requête.

Paramètres :

résultats	Tableau de valeurs `GMSAutocompletePrediction`.
error	Erreur qui s'est produite, le cas échéant.

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

Type de rappel pour la réception des résultats concernant les photos de lieu.

Si une erreur s'est produite, photos sera nul et error contiendra des informations sur l'erreur.

Paramètres :

photos	Résultat contenant des objets `GMSPlacePhotoMetadata`.
error	Erreur qui s'est produite, le cas échéant.

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

Type de rappel pour la réception d'objets UIImage à partir d'un objet GMSPlacePhotoMetadata.

Si une erreur s'est produite, photo sera nul et error contiendra des informations sur l'erreur.

Paramètres :

photo	`UIImage` qui a été chargé.
error	Erreur qui s'est produite, le cas échéant.

- (typedef void(^ GMSPlaceOpenStatusCallback)(GMSPlaceOpenStatus résultat, NSError *_Nullable error)) [related]

Type de rappel pour recevoir les horaires d'ouverture de l'établissement.

Si une erreur s'est produite, result sera GMSPlaceOpenStatusUnknown et error contiendra des informations sur l'erreur.

Paramètres :

résultat	`GMSPlaceOpenStatus` renvoyé.
error	Erreur qui s'est produite, le cas échéant.

- (typedef void(^ GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

Type de rappel pour la réception de résultats de recherche au format texte.

results est un tableau de GMSPlace représentant des résultats individuels correspondant à la requête.

Paramètres :

résultats	Tableau de valeurs `GMSPlace`.
error	Erreur qui s'est produite, le cas échéant.

Documentation de référence sur la classe GMSPlacesClient

Présentation

Fonctions de membre public

Fonctions de membre public statiques

Fonctions associées

Documentation sur les fonctions de membre

Documentation sur les amis et les fonctions associées