Introduction
Le format de réponse des API Place Details (New), Nearby Search (New) et Text Search (New) a changé par rapport à celui des anciennes API. La principale différence réside dans le format de l'objet Place renvoyé par chaque méthode, comme décrit dans Modifications apportées à l'objet Lieu de la réponse.
De plus, les champs de premier niveau de l'objet de réponse ont également changé pour chaque API. Consultez les pages suivantes :
- Modifications apportées aux réponses de la recherche de texte
- Modifications apportées aux réponses Nearby Search
- Modifications apportées à la réponse "Place Details"
Modifications apportées à l'objet Lieu de la réponse
Ce tableau présente les modifications apportées au Place nouveau dans la réponse pour Place Details (New), Nearby Search (New) et Text Search (New), par rapport à l'Place ancien.
Le nouvel objet de réponse utilise la casse mixte pour les noms de champs, contient de nouveaux champs et renomme certains des anciens champs.
| Champ | Objet de l'ancienne API Places | Objet API Places (nouvelle version) | Remarques |
|---|---|---|---|
| Composant d'adresse | address_components |
addressComponents |
|
| Adresse au format microformat Place | 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 anciennes API |
| URL d'icône | icon |
Supprimé. Utilisez iconMaskBaseUri et iconBackgroundColor. Pour en savoir plus, consultez Icônes de lieux. |
|
| Couleur de l'arrière-plan de l'icône | icon_background_color |
iconBackgroundColor |
|
| URL du masque de l'icône | icon_mask_base_uri |
iconMaskBaseUri |
|
| Numéro de téléphone international | international_phone_number |
internationalPhoneNumber |
|
| Nom du lieu (texte) | name |
displayName |
Le nom du lieu au format texte 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 Modification des références de photos. |
| ID de lieu | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Niveau de prix | price_level |
priceLevel |
|
| Notes | rating |
rating |
|
| Avis | reviews |
reviews |
|
| Heures d'ouverture secondaires pour la semaine prochaine à partir d'aujourd'hui, avec les exceptions et toutes les autres données | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Types de lieu | types |
types |
|
| URL Google Maps du lieu | url |
googleMapsUri |
|
| Nombre de notes des utilisateurs | user_ratings_total |
userRatingCount |
|
| Décalage UTC | utc_offset |
utcOffsetMinutes |
|
| Forme abrégée de l'adresse, y compris le nom de la rue et de 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 disponible à l'adresse suivante :
accessibilityOptions.wheelchairAccessibleEntrance |
| Attributs des lieux | 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 au format places/PLACE_ID |
Dans l'ancienne API, 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 |
Nouveau | |
| Placer le type principal sous forme de chaîne de texte | primaryTypeDisplayName |
Nouveau | |
| Horaires d'ouverture secondaires hebdomadaires habituels, avec exceptions et toutes les autres données | regularSecondaryOpeningHours |
Nouveau | |
| Options de paiement acceptées par le lieu | paymentOptions |
Nouveau | |
| Options de stationnement | parkingOptions |
Nouveau | |
| Liste des sous-destinations associées au lieu | subDestinations |
Nouveau | |
| Informations les plus récentes sur les options de carburant dans une station-service | fuelOptions |
Nouveau | |
| Informations sur la recharge de véhicules électriques pour un lieu | evChargeOptions |
Nouveau | |
| Attributs des lieux | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nouveau |
Modifications apportées aux réponses Text Search
Le tableau suivant présente les modifications apportées aux champs de premier niveau de l'objet de réponse pour Text Search (Legacy) et de l'objet de réponse pour Text Search (New). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.
| Champ | Text Search (ancienne version) | Text Search (nouvelle version) | Remarques |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé dans le nouvel objet Place pour chaque lieu en tant que place.attributions |
|
| Tableau de lieux | Tableau results de l'ancien objet Place |
Tableau places du nouvel objet Place |
|
| État de la demande | status |
Passé à la réponse HTTP standard (code et message de réponse HTTP) | |
| Messages d'erreur de tout type | error_message |
Passé à la réponse HTTP standard (code et message de réponse 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 Nearby Search (ancienne version) et de l'objet de réponse pour Nearby Search (nouvelle version). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.
| Champ | Nearby Search (ancienne version) | Nearby Search (nouveau) | Remarques |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé dans le nouvel objet Place pour chaque lieu en tant que place.attributions |
|
| Tableau de lieux | Tableau results de l'ancien objet Place |
Tableau places du nouvel objet Place |
|
| État de la demande | status |
Passé à la réponse HTTP standard (code et message de réponse HTTP) | |
| Messages d'erreur de tout type | error_message |
Passé à la réponse HTTP standard (code et message de réponse 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 (New)
Le tableau suivant présente les modifications apportées aux champs de premier niveau de l'objet de réponse pour Place Details (Legacy) et de l'objet de réponse pour Place Details (New). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.
| Champ | Place Details (Legacy) | Place Details (New) | Remarques |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacez-vous dans le nouvel objet Place en tant que attributions. |
|
| Place Details (New) | result contenant l'ancien objet Place |
Le nouvel objet Place | |
| État de la demande | status |
Passé à la réponse HTTP standard (code et message de réponse HTTP) | |
| Tous les messages d'information | info_messages |
Passé à la réponse HTTP standard (code et message de réponse HTTP) |