Migrer la réponse de l'API Places

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 à 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)