Le format de réponse des nouvelles API Place Details, Nearby Search et Text Search a changé par rapport à celui des API existantes. 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.
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 textuelle
- Modifications apportées à la réponse Nearby Search
- Modifications apportées à la réponse "Place Details"
Modifications apportées à l'objet Place de la réponse
Ce tableau montre les modifications apportées au nouveau
Objet Place
dans la réponse pour Place Details (New),
Nearby Search (nouveau)
Text Search (nouvelle version) par rapport à l'outil existant
Objet Place.
Le nouvel objet de réponse utilise la mise en casse de camel case pour les noms de champs, contient de nouveaux champs, et renomme certains des champs existants.
| Champ | Objet Lieu existant | Nouvel objet Place | Remarques |
|---|---|---|---|
| Composant de l'adresse | address_components |
addressComponents |
|
| Adresse au format microformat | adr_address |
adrFormatAddress |
|
| État de l'établissement | business_status |
businessStatus |
|
| Horaires d'ouverture de 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 |
|
| Lieu | 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é. Utiliser iconMaskBaseUri et
iconBackgroundColor Pour en savoir plus, consultez la section Icônes de lieu. |
|
| Couleur de l'arrière-plan de l'icône | icon_background_color |
iconBackgroundColor |
|
| URL de masque d'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 de 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 la section 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 à 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 visiteurs | user_ratings_total |
userRatingCount |
|
| Décalage UTC | utc_offset |
utcOffsetMinutes |
|
| Version courte de l'adresse, y compris 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 actuellement à
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 au format places/PLACE_ID |
Dans l'API existante, le champ name contenait le
nom de lieu sous forme de chaîne de texte. Dans la nouvelle API, ces informations se trouvent dans displayName. |
|
| Type de lieu principal | primaryTypeName |
Nouveau | |
| Placer le type principal en tant que chaîne de texte | primaryTypeDisplayName |
Nouveau | |
| Horaires d'ouverture secondaires hebdomadaires réguliers, avec exceptions et toutes les autres données | regularSecondaryOpeningHours |
Nouveau | |
| Options de paiement acceptées par l'établissement | 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 disponibles dans une station-service | fuelOptions |
Nouveau | |
| Informations sur la recharge de VE pour un lieu | evChargeOptions |
Nouveau | |
| Attributs Places | 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 niveau supérieur de l'objet de réponse pour la recherche textuelle existante et l'objet de réponse pour la recherche textuelle (nouvelle). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.
| Champ | Text Search (Existing) | Text Search (nouvelle version) | Remarques |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé dans le nouvel objet Lieu 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 |
Déplacé vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Messages d'erreur de tout type | error_message |
Déplacé 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 à la réponse de Nearby Search
Le tableau suivant présente les modifications apportées aux champs de niveau supérieur de l'objet de réponse pour la recherche à proximité existante et l'objet de réponse pour la recherche à proximité (nouvelle). Pour la nouvelle API, seul champ de premier niveau dans la
la réponse est le tableau places.
| Champ | Nearby Search (existant) | Nearby Search (nouveau) | Remarques |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé vers le nouvel emplacement Place
objet pour chaque lieu sous la forme place.attributions |
|
| Tableau de lieux | Tableau results de l'objet Place existant |
Tableau places du nouvel objet Place |
|
| État de la demande | status |
Déplacé vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Messages d'erreur de tout type | error_message |
Déplacé 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 à la réponse Place Details
Le tableau suivant présente les modifications apportées aux champs de premier niveau de l'objet de réponse pour les informations sur le lieu existantes et l'objet de réponse pour les informations sur le lieu (nouvelles). Pour la nouvelle API, le seul champ de niveau supérieur de la réponse est le tableau places.
| Champ | Place Details (Existing) | Place Details (New) | Remarques |
|---|---|---|---|
| Attributions de lieux | html_attributions |
Déplacé vers le nouvel emplacement Place
objet en tant que attributions |
|
| Détails sur le lieu | result contenant l'objet Place existant |
Nouvel objet Lieu | |
| État de la demande | status |
Déplacé vers la réponse HTTP standard (code de réponse et message HTTP) | |
| Messages d'information | info_messages |
Déplacé vers la réponse HTTP standard (code de réponse et message HTTP) |