Le format de réponse des nouvelles API Place Details, Nearby Search et Text Search a changé. La principale différence réside dans le format de l'objet Place renvoyé par chaque méthode, comme décrit dans la section Modifications apportées à l'objet Place de la réponse.
En outre, les champs de niveau supérieur de l'objet de réponse ont également été modifiés pour chaque API. Consultez les pages suivantes :
- Modifications apportées aux réponses à la recherche de texte
- Modifications apportées aux réponses de Nearby Search
- Modifications apportées aux réponses Place Details
Modifications apportées à l'objet Place de la réponse
Ce tableau présente les modifications apportées au nouvel objet Place dans la réponse de Place Details (New), de Nearby Search (New) et de Text Search (New) par rapport à l'objet Place existant.
Le nouvel objet de réponse utilise la casse Camel pour les noms de champ, contient de nouveaux champs et renomme certains des champs existants.
| Champ | Objet Place existant | Nouvel objet Place | Notes |
|---|---|---|---|
| Composant d'adresse | address_components |
addressComponents |
|
| Adresse du microformat | adr_address |
adrFormatAddress |
|
| État de l'établissement | business_status |
businessStatus |
|
| Horaires d'ouverture pour la semaine prochaine | current_opening_hours |
currentOpeningHours |
|
| Résumé éditorial | editorial_summary |
editorialSummary |
|
| Adresse formatée | formatted_address |
formattedAddress |
|
| Numéro de téléphone national | formatted_phone_number |
nationalPhoneNumber |
|
| Emplacement | geometry.location |
location |
|
| Fenêtre d'affichage | geometry.viewport |
viewport |
|
| Attributions de lieux | html_attributions |
attributions |
Champ de premier niveau de la réponse dans les API existantes |
| URL d'icône | icon |
Supprimé. Utilisez iconMaskBaseUri et iconBackgroundColor. Pour en savoir plus, consultez Icônes de lieu. |
|
| Couleur d'arrière-plan de l'icône | icon_background_color |
iconBackgroundColor |
|
| URL du masque d'icône | icon_mask_base_uri |
iconMaskBaseUri |
|
| Numéro de téléphone international | international_phone_number |
internationalPhoneNumber |
|
| Texte du nom du lieu | name |
displayName |
Le nom du lieu textuel est désormais accessible en tant que displayName.text et language en tant que displayName.languageCode |
| Horaires d'ouverture | opening_hours |
regularOpeningHours |
|
| Photos | photos |
photos |
Le format de photos a changé dans le nouvel objet Place. Pour en savoir plus, consultez Modifier les références photo. |
| ID de lieu | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Niveau de prix | price_level |
priceLevel |
|
| Notes | rating |
rating |
|
| Avis | reviews |
reviews |
|
| Horaires d'ouverture secondaires pour la semaine prochaine, à l'exception des exceptions et de toutes les autres données | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Types de lieu | types |
types |
|
| URL Google Maps du lieu | url |
googleMapsUri |
|
| Nombre d'avis des visiteurs | user_ratings_total |
userRatingCount |
|
| Décalage par rapport à l'UTC | utc_offset |
utcOffsetMinutes |
|
| Version abrégée de l'adresse incluant le nom de la rue et la ville | vicinity |
shortFormattedAddress |
|
| Site Web du lieu | website |
websiteUri |
|
| Informations sur l'accessibilité en fauteuil roulant | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance est désormais à accessibilityOptions.wheelchairAccessibleEntrance |
| Attributs Places | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Nom de la ressource | Champ name dans le formulaire places/PLACE_ID |
Dans l'API existante, le champ name contenait le nom du lieu sous forme de chaîne de texte. Dans la nouvelle API, ces informations se trouvent dans displayName. |
|
| Type principal de lieu | primaryTypeName |
Nouvelle version | |
| Placer le type principal en tant que chaîne de texte | primaryTypeDisplayName |
Nouvelle version | |
| Horaires d'ouverture secondaires hebdomadaires standards, sauf exceptions et toutes les autres données | regularSecondaryOpeningHours |
Nouvelle version | |
| Options de paiement acceptées par le lieu | paymentOptions |
Nouvelle version | |
| Options de stationnement | parkingOptions |
Nouvelle version | |
| Liste des sous-destinations associées au lieu | subDestinations |
Nouvelle version | |
| Informations les plus récentes sur les options de carburant d'une station-service | fuelOptions |
Nouvelle version | |
| Informations sur la recharge de VE pour un lieu | evChargeOptions |
Nouvelle version | |
| Attributs Places | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nouvelle version |
Modifications apportées aux réponses Text Search
Le tableau suivant montre les modifications apportées aux champs de premier niveau de l'objet de réponse pour Text Search existant et de l'objet de réponse pour Text Search (New). Pour la nouvelle API, le seul champ de niveau supérieur dans la réponse est le tableau places.
| Champ | Recherche textuelle (existante) | Text Search (nouvelle version) | Notes |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé vers le nouvel objet Place pour chaque lieu en tant que place.attributions |
|
| Tableau de lieux | Tableau results de l'objet Place existant |
Tableau places du nouvel objet Place |
|
| État de la demande | status |
Transféré vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Messages d'erreur de tout type | error_message |
Transféré vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Tous les messages d'information | info_messages |
Supprimée | |
| Jeton de page | next_page_token |
Supprimée |
Modifications apportées aux réponses Nearby Search
Le tableau suivant présente les modifications apportées aux champs de premier niveau de l'objet de réponse pour la recherche à proximité existante et de l'objet de réponse pour la recherche à proximité (nouveau). Pour la nouvelle API, le seul champ de premier niveau dans la réponse est le tableau places.
| Champ | Nearby Search (existant) | Nearby Search (nouveauté) | Notes |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé vers le nouvel objet Place pour chaque lieu en tant que place.attributions |
|
| Tableau de lieux | Tableau results de l'objet Place existant |
Tableau places du nouvel objet Place |
|
| État de la demande | status |
Transféré vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Messages d'erreur de tout type | error_message |
Transféré vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Tous les messages d'information | info_messages |
Supprimée | |
| Jeton de page | next_page_token |
Supprimée |
Modifications apportées aux réponses Place Details
Le tableau suivant montre les modifications apportées aux champs de premier niveau de l'objet de réponse pour l'objet Place Details existant et de l'objet de réponse pour Place Details (New). Pour la nouvelle API, le seul champ de premier niveau dans la réponse est le tableau places.
| Champ | Place Details (existant) | Place Details (nouveau) | Notes |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé vers le nouvel objet Place en tant que attributions |
|
| Détails sur le lieu | result contenant l'objet Place existant |
Nouvel objet Place | |
| État de la demande | status |
Transféré vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Tous les messages d'information | info_messages |
Transféré vers la réponse HTTP standard (code de réponse et message HTTP) |