Migrer la réponse de l'API Places

Développeurs de l'Espace économique européen (EEE)

Introduction

Le format de réponse des API Place Details (New), Nearby Search (New), et Text Search (New) 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. Vous devriez voir ce qui suit :

Modifications apportées à l'objet Place de la réponse

Ce tableau présente les modifications apportées au nouvel Place objet dans la réponse pour Place Details (New), Nearby Search (New) et Text Search (New) par rapport à l'ancien Place objet.

Le nouvel objet de réponse utilise la casse mixte pour les noms de champs, contient de nouveaux champs et renomme certains des champs existants.

Champ Objet de l'API Places (existant) Objet de l'API Places (nouveau) Remarques
Composant de l'adresse address_components addressComponents
Adresse au format microdonnées du lieu 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
Emplacement geometry.location location
Fenêtre d'affichage geometry.viewport viewport
Attributions de lieu 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 de l'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
Nom du lieu au format 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 Place objet. Pour en savoir plus, consultez Modifications apportées aux 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
Horaires d'ouverture secondaires de la semaine prochaine à partir d'aujourd'hui, avec exceptions et toutes les autres données secondary_opening_hours currentSecondaryOpeningHours
Types de lieu types types
URL Google Maps du lieu url googleMapsUri
Nombre d'avis d'utilisateurs user_ratings_total userRatingCount
Décalage par rapport à l'UTC utc_offset utcOffsetMinutes
Forme abrégée 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 se trouve désormais dans accessibilityOptions.wheelchairAccessibleEntrance.
Attributs de lieu 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 du lieu sous forme de chaîne de texte. Dans la nouvelle API, ces informations se trouvent dans displayName.
Type principal du lieu primaryTypeName Nouveau
Type principal du lieu 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 du lieu 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 de lieu outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports Nouveau

Modifications apportées à la réponse 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 (existant) et de l' objet de réponse pour Text Search (nouveau). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.

Champ Text Search (existant) Text Search (nouveau) Remarques
Attributions de lieu html_attributions Déplacé dans 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 Déplacé vers la réponse HTTP standard (code et message de réponse HTTP)
Messages d'erreur de tout type error_message Déplacé vers la réponse HTTP standard (code et message de réponse HTTP)
Messages d'information info_messages Supprimé
Jeton de page next_page_token Supprimé

Modifications apportées à la réponse 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 (existant) et de l'objet de réponse pour Nearby Search (nouveau). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.

Champ Nearby Search (existant) Nearby Search (nouveau) Remarques
Attributions de lieu html_attributions Déplacé dans le nouvel Place objet 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 et message de réponse HTTP)
Messages d'erreur de tout type error_message Déplacé vers la réponse HTTP standard (code et message de réponse HTTP)
Messages d'information info_messages Supprimé
Jeton de page next_page_token Supprimé

Modifications apportées à la réponse 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 (existant) et de l'objet de réponse pour Place Details (nouveau). Pour la nouvelle API, le seul champ de premier niveau de la réponse est le tableau places.

Champ Place Details (existant) Place Details (nouveau) Remarques
Attributions de lieu html_attributions Déplacé dans le nouvel Place objet en tant que attributions
Place Details (New) result contenant l'objet Place existant Le nouvel objet Place
État de la demande status Déplacé vers la réponse HTTP standard (code et message de réponse HTTP)
Messages d'information info_messages Déplacé vers la réponse HTTP standard (code et message de réponse HTTP)