Documentation de référence sur la classe GMSPlacesClient

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 de GMSPlacesClient, elle peut vouloir conserver cet objet directement, sinon votre connexion à Google risque d'être redémarrée régulièrement.

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 et est associée à l'ID de bundle de votre application pour l'identifier. Celui-ci doit être appelé par votre application avant d'utiliser GMSPlacesClient (par exemple, dans application:didFinishLaunchingWithOptions:).

Renvoie :

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

Renvoie les informations sur la licence du logiciel Open Source pour le SDK Google Places pour iOS.

Ces informations doivent être disponibles dans votre application.

Renvoie la version de cette version du SDK Google Places pour iOS.

pour en savoir plus. Exemple : "1.0.0".

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

pour en savoir plus. Par exemple, "1.0.0 (102.1)".

Obtenez des informations sur un lieu.

Cette méthode n'est pas bloquante.

Paramètres :

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

Remarque :

Cette fonctionnalité est obsolète. Cette méthode est remplacée par fetchPlaceWithRequest:callback: et sera supprimée dans une prochaine version.

Trouvez les suggestions 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 restreints à une zone spécifique. Cette méthode n'est pas bloquante.

Le rappel fourni est appelé avec un tableau de suggestions de saisie semi-automatique en cas de réussite et une erreur NSError en cas d'erreur.

Paramètres :

request	Requête GMSAutocompleteRequest de saisie semi-automatique.
rappel	Rappel à invoquer avec les suggestions.

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

Les photos proviennent de différentes sources, y compris les propriétaires d'établissement et les photos fournies par les utilisateurs de Google+. Dans la plupart des cas, ces photos peuvent être utilisées sans attribution, ou contiendront l'attribution requise dans l'image. Cependant, vous devez utiliser la propriété attributions dans la réponse pour récupérer les attributions supplémentaires requises et les afficher dans votre application partout où vous affichez l'image. Un maximum de 10 photos est renvoyé.

Plusieurs appels de cette méthode renverront 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.

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

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

Paramètres :

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

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

L'image est 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 d'échelle n'est pas 1.0, la valeur maxSize sera multipliée par cette valeur, et la valeur UIImage renvoyée sera 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 de l'image peuvent être mises en cache par le SDK. Si la photo demandée n'existe pas dans le cache, une recherche réseau est effectuée.

Remarque :

Une fois le facteur d'échelle appliqué, les dimensions spécifiées dans "maxSize" sont arrondies à l'entier le plus proche avant utilisation. Si une image plus grande que la taille maximale disponible est demandée, une image plus petite peut être renvoyée.

</ph>

Paramètres :

photoMetadata	Le GMSPlacePhotoMetadata pour lequel charger un UIImage.
maxSize	Taille maximale de l'image.
Google.	Échelle à laquelle l'image doit être chargée.
rappel	Rappel à invoquer avec le UIImage chargé.

Affiche une estimation de la localisation actuelle de l'appareil.

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

Remarque :

Pour utiliser cette méthode, votre application doit être autorisée à accéder à la position actuelle de l'appareil. Avant d'appeler cette méthode, veillez à demander l'accès à la position géographique de l'utilisateur à l'aide de [CLLocationManager requestWhenInUseAuthorization] ou de [CLLocationManager requestToujoursAuthorization]. Si vous appelez cette méthode et que l'état d'autorisation de votre application est incorrect, le rappel sera appelé avec une erreur.

</ph>

Paramètres :

rappel

Rappel à invoquer avec la liste de probabilité de lieu.

Recherchez 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 restreints à une zone spécifique. Cette méthode n'est pas bloquante.

Le rappel fourni est appelé 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 être nul.
sessionToken	Le GMSAutocompleteSessionToken pour associer la requête à une session de facturation.
rappel	Rappel à invoquer avec les prédictions.

Extrayez les détails d'un lieu.

Cette méthode n'est pas bloquante.

Paramètres :

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

Remarque :

Cette fonctionnalité est obsolète. Cette méthode est remplacée par fetchPlaceWithRequest:callback: callback: et sera supprimée dans une prochaine version.

Déterminez la probabilité d'un lieu en utilisant la position actuelle de l'utilisateur.

Cette méthode n'est pas 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 de la liste.
rappel	Rappel à invoquer avec des probabilités de lieu.

Récupère l'état d'ouverture d'un lieu, y compris toutes les propriétés nécessaires pour déterminer GMSPlaceOpenStatus à la date NSDate spécifiée. Cette méthode n'est pas bloquante.

Paramètres :

isOpenRequest	Requête permettant de déterminer l'état d'ouverture d'un lieu donné.
rappel	Rappel à invoquer avec la réponse d'état "ouvert".

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

Cette méthode n'est pas bloquante.

Paramètres :

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

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

Cette méthode n'est pas bloquante.

Paramètres :

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

Récupère l'état d'ouverture 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 sera immédiatement renvoyé dans le rappel. Cette méthode n'est pas bloquante.

Paramètres :

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

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\ will be returned in the callback immediately. This method is non-blocking.

Recherchez des lieux par texte et restrictions.

Cette méthode n'est pas bloquante.

Paramètres :

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

Obtenez un lieu à l'aide d'un objet de requête.

Cette méthode n'est pas bloquante.

Paramètres :

fetchPlaceRequest	GMSFetchPlaceRequest : requête de récupération de lieu à utiliser pour la requête.
rappel	Rappel à invoquer avec le résultat du lieu.

Demandez une photo à l'aide de la requête de récupération de photo.

Cette méthode n'est pas bloquante.

Paramètres :

fetchPhotoRequest	GMSFetchPhotoRequest Requête de photo à utiliser.
rappel	Rappel à invoquer avec le résultat NSURL.

Recherchez des lieux à proximité d'un lieu et d'une restriction.

Cette méthode n'est pas bloquante.

Paramètres :

searchNearbyRequest	GMSPlaceSearchNearbyRequest : requête de recherche à proximité à utiliser pour la requête.
rappel	Rappel à invoquer avec le résultat de la recherche.

Type de rappel pour la réception de 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	Le GMSPlace renvoyé.
erreur	L'erreur qui s'est produite, le cas échéant.

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.
erreur	L'erreur qui s'est produite, le cas échéant.

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.

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

results est un tableau de GMSAutocompletePredictions représentant les achèvements candidats de la requête.

Paramètres :

résultats	Tableau de valeurs GMSAutocompletePrediction.
erreur	L'erreur qui s'est produite, le cas échéant.

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

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

Paramètres :

photos	Le résultat contient des objets GMSPlacePhotoMetadata.
erreur	L'erreur qui s'est produite, le cas échéant.

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

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

Paramètres :

photo	Le UIImage qui a été chargé.
erreur	L'erreur qui s'est produite, le cas échéant.

Type de rappel pour la réception de l'état des horaires d'ouverture du lieu.

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

Paramètres :

résultat	Le GMSPlaceOpenStatus renvoyé.
erreur	L'erreur qui s'est produite, le cas échéant.

Type de rappel pour la réception de la réponse d'état d'ouverture.

Si une erreur s'est produite, la réponse aura l'état GMSPlaceOpenStatusUnknown et l'erreur contiendra des informations sur l'erreur.

Paramètres :

réponse	Le GMSPlaceIsOpenResponse renvoyé.
erreur	L'erreur qui s'est produite, le cas échéant.

Type de rappel pour la réception de résultats de recherche textuels.

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

Paramètres :

résultats	Tableau de valeurs GMSPlace.
erreur	L'erreur qui s'est produite, le cas échéant.

Type de rappel pour la réception d'une photo.

photoImage est un UIImage représentant la photo obtenue correspondant à la requête spécifiée. Si une erreur s'est produite, photoImage sera nul et error contiendra des informations sur l'erreur.

Paramètres :

photoImage

Un résultat UIImage.

Type de rappel pour les résultats de la saisie semi-automatique

Paramètres :

résultats	Tableau de GMSAutocompleteSuggestion.
erreur	L'erreur qui s'est produite, le cas échéant.

Type de rappel pour la réception de résultats de recherche à proximité.

Paramètres :

lieux	Un tableau de GMSPlace
erreur	L'erreur qui s'est produite, le cas échéant.