Migrer vers Place Details (nouveau)

Le SDK Places pour iOS est compatible avec Place Details. Si vous connaissez le SDK Places pour iOS existant, la nouvelle version de Place Details apporte les modifications suivantes:

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

  • Le masquage du champ est obligatoire. Vous devez spécifier les champs qui doivent être renvoyés 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 effectuer une requête, appelez la nouvelle méthode GMSPlacesClient fetchPlaceWithRequest:.

  • Transmettez à la requête:

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

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

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

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

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

  • L'instance GMSPlace de réponse 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 envoyez une requête et transmettez tous les paramètres dans l'instance GMSFetchPlaceRequest. Cet exemple utilise également un masque de champ afin 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);
  }
}];