Le SDK Places pour Android est compatible avec les détails des lieux existants. Si vous connaissez le SDK Places existant pour Android, la nouvelle version de Place Details apporte les modifications suivantes:
Utilise un nouveau modèle de tarification. Pour en savoir plus sur les tarifs de toutes les API, consultez la page SDK Places pour Android (nouveau).
Vous devez initialiser votre application en appelant la méthode
Places.initializeWithNewPlacesApiEnabled(). Pour en savoir plus sur la sélection du service de l'API Places, consultez la section Configurer votre projet Google Cloud.Le masquage de champ est obligatoire. Vous devez spécifier les champs à renvoyer 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.
Les sections suivantes décrivent d'autres modifications.
Accéder à de nouveaux types de lieux
Chaque lieu peut être associé à une ou plusieurs valeurs de type. Le SDK Places pour Android version 3.3.0 et ultérieure ajoute de nombreuses nouvelles valeurs de type. Pour obtenir la liste complète, consultez Types d'établissements étendus.
La méthode Place.getPlaceTypes() renvoie les valeurs de type sous la forme d'une liste de valeurs de chaîne. Les valeurs renvoyées dépendent de votre version du SDK Places pour Android:
SDK Places pour Android (nouveau): renvoie les chaînes définies par les tableaux A et B affichés dans Types d'établissements (nouveau), y compris tous les types d'établissements ajoutés dans la version 3.3.0.
SDK Places pour Android: renvoie les énumérations définies par
Place.Types, qui n'inclut pas les nouveaux types ajoutés à partir de la version 3.3.0.
Accéder aux avis sur les lieux
Le SDK Places pour Android (nouveau) ajoute la classe Review, qui contient un avis sur un lieu. L'objet Place peut contenir jusqu'à cinq avis.
La classe Review peut également contenir une attribution et une attribution d'auteur. Si vous affichez l'avis dans votre application, vous devez également afficher toute attribution ou attribution de l'auteur. Pour en savoir plus, consultez Afficher un avis.
Pour en savoir plus, consultez la documentation sur les attributions.
Code de langue du nom du lieu
La méthode Place.getName() existante renvoie une chaîne de texte contenant le nom d'un lieu. Pour renseigner l'objet Place avec le nom du lieu, vous devez inclure Place.Field.DISPLAY_NAME dans la liste des champs de la requête Place Details.
L'objet Place contient désormais le code de langue de la chaîne de nom. Pour renseigner l'objet Place avec un code de langue, vous devez:
Incluez
Place.Field.DISPLAY_NAMEdans la liste des champs de la requête. Cette valeur configure la réponse pour qu'elle inclue à la fois le nom du lieu et le code de langue dans l'objetPlace.Appelez
PlacesClient.fetchPlace().PlacesClient.findCurrentPlace()n'est pas compatible avec le champ de code de langue.Utilisez la méthode
Place.getNameLanguageCode()pour accéder au champ de code de langue dans l'objetPlace.
Définir le code régional
Le SDK Places pour Android (nouveau) ajoute le paramètre de requête de code de région à "Place Details" (Détails du lieu). Le code de région permet de mettre en forme la réponse. Il est spécifié sous la forme d'une valeur de code CLDR à deux caractères. Ce paramètre peut également avoir un effet biaisé sur les résultats de recherche. Il n'existe pas de valeur par défaut. Vous devez activer le nouveau SDK pour définir le code de région.
Si le nom du pays du champ d'adresse dans la réponse correspond au code de région, le code pays est omis de l'adresse.
La plupart des codes CLDR sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord"). Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable.
Exemple de requête
Pour voir un exemple complet, consultez Informations sur le lieu (nouveau).