La nouvelle génération de l'API Places est désormais disponible avec la nouvelle version de l'API Places.

Cette page a été traduite par l'API Cloud Translation.

Champs de données de lieu

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Les champs de données de lieu définissent les types de données de lieu à renvoyer lors des requêtes Place Details. Cette page liste tous les champs de données de lieu et explique comment ils sont pris en charge par chaque API/SDK (la compatibilité des champs de lieu varie selon la plate-forme et/ou l'élément géographique).

Pour en savoir plus sur la facturation des requêtes Place Details, consultez la page Utilisation et facturation.

Le tableau suivant répertorie toutes les valeurs acceptées dans les champs de données de lieu pour chaque niveau de tarification et chaque plate-forme.

Important : Étant donné que les données de lieu ne peuvent pas être vides, seuls les résultats contenant des données sont renvoyés. Par exemple, s'il n'existe pas de photos du lieu demandé, le résultat ne contiendra pas de champ photos.

Champs "Basic Data"

Champ	API Places	Bibliothèque Places, API Maps JavaScript	SDK Places pour Android	SDK Places pour iOS
Composants de l'adresse	`address_components`	`address_components`	`Place.Field.ADDRESS_COMPONENTS`	`GMSPlaceFieldAddressComponents`
Adresse	`adr_address`	`adr_address`	`---`	`---`
Statut de l'entreprise	`business_status`	`business_status`	`Place.Field.BUSINESS_STATUS`	`GMSPlaceFieldBusinessStatus`
Adresse formatée	`formatted_address`	`formatted_address`	`Place.Field.ADDRESS`	`GMSPlaceFieldFormattedAddress`
Fenêtre d'affichage	`geometry/viewport`	`geometry.viewport`	`Place.Field.VIEWPORT`	`GMSPlaceFieldViewport`
Lieu	`geometry/location`	`geometry.location`	`Place.Field.LAT_LNG`	`GMSPlaceFieldCoordinate`
Icône	`icon`	`icon`	`---`	`---`
URI de base de masque de l'icône	`icon_mask_base_uri`	`icon_mask_base_uri`	`Place.Field.ICON_URL`	`GMSPlaceFieldIconImageURL`
Couleur d'arrière-plan de l'icône	`icon_background_color`	`icon_background_color`	`Place.Field.ICON_BACKGROUND_COLOR`	`GMSPlaceFieldIconBackgroundColor`
Nom	`name`	`name`	`Place.Field.NAME`	`GMSPlaceFieldName`
Fermé définitivement (obsolète)	`permanently_closed`	`permanently_closed`	`---`	`---`
Photo	`photos`	`photos`	`Place.Field.PHOTO_METADATAS`	`GMSPlaceFieldPhotos`
ID de lieu	`place_id`	`place_id`	`Place.Field.ID`	`GMSPlaceFieldPlaceID`
Plus Code	`plus_code`	`plus_code`	`Place.Field.PLUS_CODE`	`GMSPlaceFieldPlusCode`
Type	`type`	`type`	`Place.Field.TYPES`	`GMSPlaceFieldTypes`
URL	`url`	`url`	`---`	`---`
Décalage par rapport à l'UTC	`utc_offset`	`utc_offset_minutes`	`Place.Field.UTC_OFFSET`	`GMSPlaceFieldUTCOffsetMinutes`
Proximité	`vicinity`	`vicinity`	`---`	`---`
Entrée accessible en fauteuil roulant	`wheelchair_accessible_entrance`	`---`	`Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`	`GMSPlaceFieldWheelchairAccessibleEntrance`

Champs de données de contact

Champ	API Places	Bibliothèque Places, API Maps JavaScript	SDK Places pour Android	SDK Places pour iOS
Numéro de téléphone	`formatted_phone_number`	`formatted_phone_number`	`---`	`---`
Numéro de téléphone international	`international_phone_number`	`international_phone_number`	`Place.Field.PHONE_NUMBER`	`GMSPlaceFieldPhoneNumber`
Horaires d'ouverture	`opening_hours`	`opening_hours`	`Place.Field.OPENING_HOURS`	`GMSPlaceFieldOpeningHours`
Horaires d'ouverture actuels	`current_opening_hours`	`---`	`Place.Field.CURRENT_OPENING_HOURS`	`GMSPlaceFieldCurrentOpeningHours`
Horaires d'ouverture secondaires	`secondary_opening_hours`	`---`	`Place.Field.SECONDARY_OPENING_HOURS`	`GMSPlaceFieldSecondaryOpeningHours`
Site Web	`website`	`website`	`Place.Field.WEBSITE_URI`	`GMSPlaceFieldWebsite`

Champs de données d'atmosphère

Champ	API Places	Bibliothèque Places, API Maps JavaScript	SDK Places pour Android	SDK Places pour iOS
Drive disponible	`curbside_pickup`	`---`	`Place.Field.CURBSIDE_PICKUP`	`GMSPlaceFieldCurbsidePickup`
Livraison	`delivery`	`---`	`Place.Field.DELIVERY`	`GMSPlaceFieldDelivery`
Repas sur place	`dine_in`	`---`	`Place.Field.DINE_IN`	`GMSPlaceFieldDineIn`
Résumé éditorial	`editorial_summary`	`---`	`Place.Field.EDITORIAL_SUMMARY`	`GMSPlaceFieldEditorialSummary`
Niveau de prix	`price_level`	`price_level`	`Place.Field.PRICE_LEVEL`	`GMSPlaceFieldPriceLevel`
Notes	`rating`	`rating`	`Place.Field.RATING`	`GMSPlaceFieldRating`
Réservation possible	`reservable`	`---`	`Place.Field.RESERVABLE`	`GMSPlaceFieldReservable`
Avis	`reviews`	`reviews`	`Place.Field.REVIEWS`	`---`
Sert de la bière	`serves_beer`	`---`	`Place.Field.SERVES_BEER`	`GMSPlaceFieldServesBeer`
Sert le petit-déjeuner	`serves_breakfast`	`---`	`Place.Field.SERVES_BREAKFAST`	`GMSPlaceFieldServesBreakfast`
Sert des brunchs	`serves_brunch`	`---`	`Place.Field.SERVES_BRUNCH`	`GMSPlaceFieldServesBrunch`
Sert à dîner	`serves_dinner`	`---`	`Place.Field.SERVES_DINNER`	`GMSPlaceFieldServesDinner`
Sert à déjeuner	`serves_lunch`	`---`	`Place.Field.SERVES_LUNCH`	`GMSPlaceFieldServesLunch`
Sert des plats végétariens	`serves_vegetarian_food`	`---`	`Place.Field.SERVES_VEGETARIAN_FOOD`	`GMSPlaceFieldServesVegetarianFood`
Sert du vin	`serves_wine`	`---`	`Place.Field.SERVES_WINE`	`GMSPlaceFieldServesWine`
Vente à emporter	`takeout`	`---`	`Place.Field.TAKEOUT`	`GMSPlaceFieldTakeout`
Total des notes des visiteurs	`user_ratings_total`	`user_ratings_total`	`Place.Field.USER_RATINGS_TOTAL`	`GMSPlaceFieldUserRatingsTotal`

Champs compatibles avec l'API Places

Les requêtes Find Place, Nearby Search et Text Search renvoient toutes un sous-ensemble de champs renvoyés par les requêtes Place Details. Ces méthodes ne renvoient PAS les champs suivants :

address_component
adr_address
curbside_pickup
current_opening_hours
delivery
dine_in
editorial_summary
formatted_phone_number
international_phone_number
opening_hours.periods
opening_hours.special_days
opening_hours.type
opening_hours.weekday_text
reservable
secondary_opening_hours
reviews

serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch
serves_vegetarian_food
serves_wine
takeout
type
url
user_ratings_total
utc_offset_minutes
vicinity
website
wheelchair_accessible_entrance

Pour renvoyer un ou plusieurs de ces champs de données pour un lieu, effectuez une requête Place Details, transmettez un ID de lieu et spécifiez les champs à renvoyer.