Migrer vers Place Details (nouveau)

Le SDK Places pour iOS est compatible avec Place Details (Legacy). Si vous connaissez le SDK Places pour iOS (ancienne version), Place Details (New) apporte les modifications suivantes :

  • Utilise un nouveau modèle de tarification. Pour obtenir des informations sur les tarifs de toutes les API, consultez Tarifs du SDK Places pour iOS (nouveau).

  • Le masquage de champ est obligatoire. Vous devez spécifier les champs que vous souhaitez voir figurer dans la réponse. Il n'existe pas de liste par défaut des champs renvoyés. Si vous omettez cette liste, les méthodes renvoient une erreur.

  • Pour envoyer une requête, appelez la nouvelle méthode GMSPlacesClient fetchPlaceWithRequest:.

  • Transmettez à la requête :

    • Instance de la nouvelle classe GMSFetchPlaceRequest qui définit tous les paramètres de la requête, tels que l'ID du lieu et le jeton de session.

    • Rappel de type GMSPlaceResultCallback pour gérer la réponse.

  • La réponse contient une instance GMSPlace contenant des informations sur le lieu. Les valeurs de la propriété types de l'instance GMSPlace sont désormais définies par le Tableau A et le Tableau B.

  • L'instance de réponse GMSPlace contient la nouvelle propriété reviews de type GMSPlaceReview. Lorsque votre application affiche des informations obtenues à partir de l'instance GMSPlace, comme des photos et des avis, elle doit également afficher les attributions requises.

    Pour en savoir plus, consultez la documentation sur les attributions.

  • L'instance de réponse GMSPlace contient les fonctions membres suivantes :

    • isOpen calcule si un lieu est ouvert à l'heure indiquée.

    • isOpenAtDate calcule si un lieu est ouvert à une date donnée.

    Ces fonctions ne sont disponibles que lorsque vous activez le SDK Places pour iOS. Elles ne sont pas disponibles lorsque vous activez le SDK Places pour iOS (nouveau). Pour en savoir plus, consultez Choisir votre version du SDK.

Exemple de requête

Avec Place Details (New), vous effectuez une requête et transmettez tous les paramètres dans l'instance GMSFetchPlaceRequest. Cet exemple utilise également un masque de champ pour que la réponse n'inclue que le nom à afficher et l'URL du site Web du lieu :

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields = [GMSPlaceProperty.name, GMSPlaceProperty.website].map {$0.rawValue}

// Create the GMSFetchPlaceRequest instance.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: fields, sessionToken: nil)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  guard let place, error == nil else { return }
  print("Place found: \(String(describing: place.name))")
})

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
NSArray<NSString *> *fields = @[GMSPlacePropertyName, GMSPlacePropertyWebsite];

// Create the GMSFetchPlaceRequest instance.
GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: fields sessionToken:nil];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
    if (error != nil) {
      NSLog(@"An error occurred %@", [error localizedDescription]);
      return;
    } else {
    NSLog(@"Place Found: %@", place.name);
    NSLog(@"The place URL: %@", place.website);
  }
}];