Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Places Service (deprecated)

Classe PlacesService

classe google.maps.places.PlacesService
bibliothèque "places"

Obsolète : depuis le 1er mars 2025, google.maps.places.PlacesService n'est plus disponible pour les nouveaux clients. Veuillez plutôt utiliser Place. Pour le moment, il n'est pas prévu d'arrêter google.maps.places.PlacesService, mais nous vous recommandons d'utiliser Place plutôt que google.maps.places.PlacesService. Bien que google.maps.places.PlacesService continuera de recevoir des corrections de bugs pour les régressions majeures, les bugs existants dans google.maps.places.PlacesService ne seront pas corrigés. Vous recevrez une notification au moins 12 mois avant la fin de leur prise en charge. Pour en savoir plus, consultez https://developers.google.com/maps/legacy et le guide de migration sur https://developers.google.com/maps/documentation/javascript/places-migration-overview.

Contient des méthodes permettant de rechercher des lieux et de récupérer des informations les concernant.

const {PlacesService} = await google.maps.importLibrary("places");

Constructeur
`PlacesService`	`PlacesService(attrContainer)` Paramètres : `attrContainer: HTMLDivElement\|Map` Crée une instance de `PlacesService` qui affiche les attributions dans le conteneur spécifié.

Méthodes
`findPlaceFromPhoneNumber`	`findPlaceFromPhoneNumber(request, callback)` Paramètres : `request: FindPlaceFromPhoneNumberRequest` `callback: function(Array<PlaceResult> optional, PlacesServiceStatus): void` Valeur renvoyée : aucune Récupère une liste de lieux en fonction d'un numéro de téléphone. Dans la plupart des cas, la liste de résultats ne doit contenir qu'un seul élément. Toutefois, si la requête est ambiguë, plusieurs résultats peuvent être renvoyés. Les `PlaceResult` transmis au rappel sont des sous-ensembles d'un `PlaceResult` complet. Votre application peut obtenir un `PlaceResult` plus détaillé pour chaque lieu en appelant `PlacesService.getDetails` et en transmettant le `PlaceResult.place_id` du lieu souhaité.
`findPlaceFromQuery`	`findPlaceFromQuery(request, callback)` Paramètres : `request: FindPlaceFromQueryRequest` `callback: function(Array<PlaceResult> optional, PlacesServiceStatus): void` Valeur renvoyée : aucune Récupère une liste de lieux en fonction d'une chaîne de requête. Dans la plupart des cas, la liste de résultats ne doit contenir qu'un seul élément. Toutefois, si la requête est ambiguë, plusieurs résultats peuvent être renvoyés. Les `PlaceResult` transmis au rappel sont des sous-ensembles d'un `PlaceResult` complet. Votre application peut obtenir un `PlaceResult` plus détaillé pour chaque lieu en appelant `PlacesService.getDetails` et en transmettant le `PlaceResult.place_id` du lieu souhaité.
`getDetails`	`getDetails(request, callback)` Paramètres : `request: PlaceDetailsRequest` `callback: function(PlaceResult optional, PlacesServiceStatus): void` Valeur renvoyée : aucune Récupère des informations sur le lieu identifié par l'`placeId` donné.
`nearbySearch`	`nearbySearch(request, callback)` Paramètres : `request: PlaceSearchRequest` `callback: function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void` Valeur renvoyée : aucune Récupère une liste de lieux à proximité d'un emplacement particulier, en fonction d'un mot clé ou d'un type. L'emplacement doit toujours être spécifié, soit en transmettant un paramètre `LatLngBounds`, soit en transmettant les paramètres `location` et `radius`. Les `PlaceResult` transmis au rappel sont des sous-ensembles du `PlaceResult` complet. Votre application peut obtenir un `PlaceResult` plus détaillé pour chaque lieu en envoyant une requête Place Details transmettant le `PlaceResult.place_id` du lieu souhaité. L'objet `PlaceSearchPagination` peut être utilisé pour récupérer des pages de résultats supplémentaires (null s'il s'agit de la dernière page de résultats ou s'il n'y a qu'une seule page de résultats).
`textSearch`	`textSearch(request, callback)` Paramètres : `request: TextSearchRequest` `callback: function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void` Valeur renvoyée : aucune Récupère une liste de lieux en fonction d'une chaîne de requête (par exemple, "pizza à New York" ou "magasins de chaussures près d'Ottawa"). Les paramètres de localisation sont facultatifs. Lorsque la localisation est spécifiée, les résultats sont simplement pondérés en faveur des résultats à proximité, plutôt que limités aux lieux situés dans la zone. Utilisez `textSearch` lorsque vous souhaitez rechercher des lieux à l'aide d'une chaîne arbitraire et que vous ne souhaitez pas limiter les résultats de recherche à un emplacement particulier. L'objet `PlaceSearchPagination` peut être utilisé pour récupérer des pages de résultats supplémentaires (null s'il s'agit de la dernière page de résultats ou s'il n'y a qu'une seule page de résultats).

Interface PlaceDetailsRequest

interface google.maps.places.PlaceDetailsRequest

Requête Place Details à envoyer à PlacesService.

Propriétés
`placeId`	Type : `string` ID de lieu du lieu pour lequel des détails sont demandés.
`fields` facultatif	Type : `Array<string> optional` Champs à inclure dans la réponse détaillée, qui seront facturés. Si aucun champ n'est spécifié ou si `['ALL']` est transmis, tous les champs disponibles seront renvoyés et facturés (non recommandé pour les déploiements de production). Pour obtenir la liste des champs, consultez `PlaceResult`. Les champs imbriqués peuvent être spécifiés avec des chemins d'accès séparés par des points (par exemple, `"geometry.location"`).
`language` facultatif	Type : `string optional` Identifiant de la langue dans laquelle les détails doivent être renvoyés. Consultez la liste des langues disponibles.
`region` facultatif	Type : `string optional` Code de la région de l'utilisateur. Cela peut affecter les photos qui peuvent être renvoyées, et éventuellement d'autres éléments. Le code régional accepte une valeur ccTLD ("domaine de premier niveau") à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (`.co.uk`), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
`sessionToken` facultatif	Type : `AutocompleteSessionToken optional` Référence unique utilisée pour regrouper la requête de détails avec une session de saisie semi-automatique.

FindPlaceFromPhoneNumberRequest interface

interface google.maps.places.FindPlaceFromPhoneNumberRequest

Requête de recherche de lieu à partir d'une recherche textuelle à envoyer à PlacesService.findPlaceFromPhoneNumber.

Propriétés
`fields`	Type : `Array<string>` Champs à inclure dans la réponse, qui seront facturés. Si `['ALL']` est transmis, tous les champs disponibles sont renvoyés et facturés (non recommandé pour les déploiements de production). Pour obtenir la liste des champs, consultez `PlaceResult`. Les champs imbriqués peuvent être spécifiés avec des chemins d'accès par points (par exemple, `"geometry.location"`).
`phoneNumber`	Type : `string` Numéro de téléphone du lieu à rechercher. Le format doit être E.164.
`language` facultatif	Type : `string optional` Identifiant de la langue dans laquelle les noms et les adresses doivent être renvoyés, si possible. Consultez la liste des langues disponibles.
`locationBias` facultatif	Type : `LocationBias optional` La pondération utilisée lors de la recherche d'un lieu. Le résultat sera pondéré en faveur de la `LocationBias` donnée, mais ne s'y limitera pas.

Interface FindPlaceFromQueryRequest

interface google.maps.places.FindPlaceFromQueryRequest

Requête de recherche de lieu à partir d'une recherche textuelle à envoyer à PlacesService.findPlaceFromQuery.

Propriétés
`fields`	Type : `Array<string>` Champs à inclure dans la réponse, qui seront facturés. Si `['ALL']` est transmis, tous les champs disponibles sont renvoyés et facturés (non recommandé pour les déploiements de production). Pour obtenir la liste des champs, consultez `PlaceResult`. Les champs imbriqués peuvent être spécifiés avec des chemins d'accès séparés par des points (par exemple, `"geometry.location"`).
`query`	Type : `string` Requête de la demande. Par exemple, le nom ou l'adresse d'un lieu.
`language` facultatif	Type : `string optional` Identifiant de la langue dans laquelle les noms et les adresses doivent être renvoyés, si possible. Consultez la liste des langues disponibles.
`locationBias` facultatif	Type : `LocationBias optional` La pondération utilisée lors de la recherche d'un lieu. Le résultat sera pondéré en faveur de la valeur `LocationBias` donnée, mais ne s'y limitera pas.

Interface PlaceSearchRequest

interface google.maps.places.PlaceSearchRequest

Requête de recherche de lieu à envoyer à PlacesService.

Propriétés
`bounds` facultatif	Type : `LatLngBounds\|LatLngBoundsLiteral optional` Limites dans lesquelles rechercher des lieux. `location` et `radius` seront ignorés si `bounds` est défini.
`keyword` facultatif	Type : `string optional` Terme à mettre en correspondance avec tous les champs disponibles, y compris, mais sans s'y limiter, le nom, le type et l'adresse, ainsi que les avis des clients et d'autres contenus tiers.
`language` facultatif	Type : `string optional` Identifiant de la langue dans laquelle les noms et les adresses doivent être renvoyés, si possible. Consultez la liste des langues disponibles.
`location` facultatif	Type : `LatLng\|LatLngLiteral optional` Lieu autour duquel rechercher des établissements.
`maxPriceLevel` facultatif	Type : `number optional` Restreint les résultats aux seuls lieux dont le niveau de prix est inférieur ou égal à celui spécifié. Les valeurs valides sont comprises entre 0 (le moins cher) et 4 (le plus cher), inclus. La valeur doit être supérieure ou égale à `minPrice` , si elle est spécifiée.
`minPriceLevel` facultatif	Type : `number optional` Restreint les résultats aux seuls lieux dont le niveau de prix est égal ou supérieur à celui spécifié. Les valeurs valides sont comprises entre 0 (le moins cher) et 4 (le plus cher), inclus. Doit être inférieur ou égal à `maxPrice`, si spécifié.
`name` facultatif	Obsolète : utilisez plutôt `keyword`. Type : `string optional` Équivaut à `keyword`. Les valeurs de ce champ sont combinées à celles du champ `keyword` et transmises dans la même chaîne de recherche.
`openNow` facultatif	Type : `boolean optional` Restreint les résultats aux seuls lieux ouverts en ce moment.
`radius` facultatif	Type : `number optional` Distance (en mètres) par rapport à l'emplacement donné dans laquelle rechercher des lieux. La valeur maximale autorisée est de 50 000.
`rankBy` facultatif	Type : `RankBy optional` Par défaut : `RankBy.PROMINENCE` Spécifie la méthode de classement à utiliser pour renvoyer les résultats. Notez que lorsque `rankBy` est défini sur `DISTANCE`, vous devez spécifier `location`. Toutefois, vous ne pouvez définir ni `radius`, ni `bounds`.
`type` facultatif	Type : `string optional` Recherche des lieux du type donné. Le type est traduit dans la langue locale de l'emplacement cible de la requête et utilisé comme chaîne de requête. Si une requête est également fournie, elle est concaténée à la chaîne de type localisée. Les résultats d'un autre type sont supprimés de la réponse. Utilisez ce champ pour effectuer des recherches par catégorie indépendamment de la langue et de la région. Les types valides sont indiqués ici.

TextSearchRequest

interface google.maps.places.TextSearchRequest

Requête de recherche textuelle à envoyer à PlacesService.

Propriétés
`bounds` facultatif	Type : `LatLngBounds\|LatLngBoundsLiteral optional` Limites utilisées pour biaiser les résultats lors de la recherche de lieux (facultatif). `location` et `radius` seront ignorés si `bounds` est défini. Les résultats ne seront pas limités à ceux situés dans ces limites, mais ceux qui s'y trouvent seront mieux classés.
`language` facultatif	Type : `string optional` Identifiant de la langue dans laquelle les noms et les adresses doivent être renvoyés, si possible. Consultez la liste des langues disponibles.
`location` facultatif	Type : `LatLng\|LatLngLiteral optional` Centre de la zone utilisée pour biaiser les résultats lors de la recherche de lieux.
`query` facultatif	Type : `string optional` Terme de la requête. Par exemple, le nom d'un lieu ("Tour Eiffel"), une catégorie suivie du nom d'un lieu ("pizza à New York") ou le nom d'un lieu suivi d'un élément de désambiguïsation ("Starbucks à Sydney").
`radius` facultatif	Type : `number optional` Rayon de la zone utilisée pour pondérer les résultats lors de la recherche de lieux, en mètres.
`region` facultatif	Type : `string optional` Code régional pour orienter les résultats. Le code régional accepte une valeur ccTLD ("domaine de premier niveau") à deux caractères. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (`.co.uk`), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
`type` facultatif	Type : `string optional` Recherche des lieux du type donné. Le type est traduit dans la langue locale de l'emplacement cible de la requête et utilisé comme chaîne de requête. Si une requête est également fournie, elle est concaténée à la chaîne de type localisée. Les résultats d'un autre type sont supprimés de la réponse. Utilisez ce champ pour effectuer des recherches par catégorie indépendamment de la langue et de la région. Les types valides sont indiqués ici.

Constantes RankBy

google.maps.places.RankBy
bibliothèque "places"

Options de classement pour une requête PlaceSearchRequest.

const {RankBy} = await google.maps.importLibrary("places");

Constantes
`DISTANCE`	Classe les résultats par distance par rapport au lieu.
`PROMINENCE`	Classe les résultats de lieux en fonction de leur importance.

typedef LocationBias

typedef google.maps.places.LocationBias

Un LocationBias représente une limite ou une indication approximative à utiliser lors de la recherche de lieux. Les résultats peuvent provenir de l'extérieur de la zone spécifiée. Pour utiliser l'adresse IP de l'utilisateur actuel comme pondération, vous pouvez spécifier la chaîne "IP_BIAS". Remarque : Si vous utilisez un Circle, le centre et le rayon doivent être définis.

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

Un LocationRestriction représente une limite stricte à utiliser lors de la recherche de lieux.

LatLngBounds|LatLngBoundsLiteral

Constantes PlacesServiceStatus

google.maps.places.PlacesServiceStatus
bibliothèque "places"

État renvoyé par PlacesService à la fin de ses recherches. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'OK' ou google.maps.places.PlacesServiceStatus.OK.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type PlacesServiceStatusString.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");

Constantes
`INVALID_REQUEST`	Cette requête n'est pas valide.
`NOT_FOUND`	Le lieu référencé est introuvable.
`OK`	La réponse contient un résultat valide.
`OVER_QUERY_LIMIT`	L'application a dépassé son quota de requêtes.
`REQUEST_DENIED`	L'application n'est pas autorisée à utiliser `PlacesService`.
`UNKNOWN_ERROR`	La requête `PlacesService` n'a pas pu être traitée en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir.
`ZERO_RESULTS`	aucun résultat n'a été trouvé pour cette requête.

Interface PlaceSearchPagination

interface google.maps.places.PlaceSearchPagination

Objet utilisé pour récupérer des pages supplémentaires de résultats Places.

Propriétés
`hasNextPage`	Type : `boolean` Indique si d'autres résultats sont disponibles. Elle est `true` lorsqu'il existe une page de résultats supplémentaire.

Méthodes
`nextPage`	`nextPage()` Paramètres : aucun Valeur renvoyée : `void` Récupère la page de résultats suivante. Utilise la même fonction de rappel que celle fournie à la première requête de recherche.

Interface PlaceResult

interface google.maps.places.PlaceResult

Définit les informations sur un lieu.

Propriétés
`address_components` facultatif	Type : `Array<GeocoderAddressComponent> optional` Ensemble des composants d'adresse pour l'emplacement de ce lieu. Disponible uniquement avec `PlacesService.getDetails`.
`adr_address` facultatif	Type : `string optional` Représentation de l'adresse du lieu au microformat adr. Disponible uniquement avec `PlacesService.getDetails`.
`aspects` facultatif	Type : `Array<PlaceAspectRating> optional` Aspects évalués de ce lieu, d'après les avis des utilisateurs de Google et de Zagat. Les notes sont comprises entre 0 et 30.
`business_status` facultatif	Type : `BusinessStatus optional` Indicateur spécifiant l'état opérationnel du lieu, s'il s'agit d'un établissement (indique si le lieu est opérationnel, ou fermé temporairement ou définitivement). Si aucune donnée n'est disponible, l'indicateur n'est pas présent dans les réponses de recherche ou de détails.
`formatted_address` facultatif	Type : `string optional` Adresse complète du lieu.
`formatted_phone_number` facultatif	Type : `string optional` Numéro de téléphone du lieu, au format conforme à la norme régionale. Disponible uniquement avec `PlacesService.getDetails`.
`geometry` facultatif	Type : `PlaceGeometry optional` Informations liées aux propriétés géométriques du lieu.
`html_attributions` facultatif	Type : `Array<string> optional` Texte d'attribution à afficher pour ce résultat de lieu. Les `html_attributions` disponibles sont toujours renvoyées, quelles que soient les `fields` demandées, et doivent être affichées.
`icon` facultatif	Type : `string optional` URL d'une ressource d'image pouvant être utilisée pour représenter la catégorie de ce lieu.
`icon_background_color` facultatif	Type : `string optional` Couleur d'arrière-plan à utiliser avec l'icône d'un lieu. Consultez également `PlaceResult.icon_mask_base_uri`.
`icon_mask_base_uri` facultatif	Type : `string optional` URL tronquée vers un masque d'icône. Accédez à différents types d'icônes en ajoutant une extension de fichier à la fin (par exemple, `.svg` ou `.png`).
`international_phone_number` facultatif	Type : `string optional` Numéro de téléphone du lieu au format international. Le format international inclut l'indicatif du pays, précédé du signe plus (+). Disponible uniquement avec `PlacesService.getDetails`.
`name` facultatif	Type : `string optional` Nom du lieu. Remarque : Dans le cas de lieux saisis par l'utilisateur, il s'agit du texte brut, tel qu'il a été saisi par l'utilisateur. Soyez prudent lorsque vous utilisez ces données, car des utilisateurs malveillants peuvent essayer de les utiliser comme vecteur pour des attaques par injection de code (voir http://en.wikipedia.org/wiki/Code_injection).
`opening_hours` facultatif	Type : `PlaceOpeningHours optional` Définit l'heure d'ouverture ou de fermeture du lieu.
`permanently_closed` facultatif	Obsolète : `permanently_closed` est obsolète depuis mai 2020 et sera désactivé en mai 2021. Utilisez plutôt `PlaceResult.business_status`, car `permanently_closed` ne fait pas de distinction entre les fermetures temporaires et définitives. Type : `boolean optional` Indicateur signalant si le lieu est fermé, de manière permanente ou temporaire. Si le lieu est opérationnel ou si aucune donnée n'est disponible, l'indicateur est absent de la réponse.
`photos` facultatif	Type : `Array<PlacePhoto> optional` Photos de ce lieu. La collection contiendra jusqu'à dix objets `PlacePhoto`.
`place_id` facultatif	Type : `string optional` Identifiant unique du lieu.
`plus_code` facultatif	Type : `PlacePlusCode optional` Définit les Open Location Codes ou "plus codes" du lieu.
`price_level` facultatif	Type : `number optional` Niveau de prix du lieu, sur une échelle de 0 à 4. Les niveaux de prix sont interprétés comme suit : `0` : sans frais `1` : pas cher `2` : moyenne `3` : Son prix élevé `4` : Très cher
`rating` facultatif	Type : `number optional` Note comprise entre 1,0 et 5,0, basée sur les avis des utilisateurs sur ce lieu.
`reviews` facultatif	Type : `Array<PlaceReview> optional` Liste des avis sur ce lieu. Disponible uniquement avec `PlacesService.getDetails`.
`types` facultatif	Type : `Array<string> optional` Tableau de types pour ce lieu (par exemple, `["political", "locality"]` ou `["restaurant", "establishment"]`).
`url` facultatif	Type : `string optional` URL de la page Google officielle de ce lieu. Il s'agit de la page Google contenant les informations les plus pertinentes disponibles sur le lieu. Disponible uniquement avec `PlacesService.getDetails`.
`user_ratings_total` facultatif	Type : `number optional` Nombre d'avis d'utilisateurs ayant contribué à la note (`PlaceResult.rating`) de ce lieu.
`utc_offset` facultatif	Obsolète : `utc_offset` est obsolète depuis novembre 2019. Utilisez plutôt `PlaceResult.utc_offset_minutes`. Consultez https://goo.gle/js-open-now. Type : `number optional` Décalage horaire actuel du lieu par rapport à UTC, exprimé en minutes. Par exemple, Sydney (Australie) en heure d'été a 11 heures d'avance sur l'heure UTC. Le `utc_offset` sera donc `660`. Pour les fuseaux horaires en retard par rapport à l'UTC, le décalage est négatif. Par exemple, le `utc_offset` est `-60` pour le Cap-Vert. Disponible uniquement avec `PlacesService.getDetails`.
`utc_offset_minutes` facultatif	Type : `number optional` Décalage horaire actuel du lieu par rapport à UTC, exprimé en minutes. Par exemple, Sydney (Australie) en heure d'été a 11 heures d'avance sur l'heure UTC. Le `utc_offset_minutes` sera donc `660`. Pour les fuseaux horaires en retard par rapport à l'UTC, le décalage est négatif. Par exemple, le `utc_offset_minutes` est `-60` pour le Cap-Vert. Disponible uniquement avec `PlacesService.getDetails`.
`vicinity` facultatif	Type : `string optional` Adresse simplifiée du lieu, comprenant la rue, le numéro et la ville, mais sans le département/la province, le code postal ou le pays. Par exemple, la valeur de l'attribut "vicinity" du bureau de Google à Sydney en Australie est de `"48 Pirrama Road, Pyrmont"`. Disponible uniquement avec `PlacesService.getDetails`.
`website` facultatif	Type : `string optional` Site Web faisant autorité pour ce lieu, comme la page d'accueil d'un établissement. Disponible uniquement avec `PlacesService.getDetails`.

Interface PlaceAspectRating

interface google.maps.places.PlaceAspectRating

Définit des informations sur un aspect du lieu que les utilisateurs ont examiné.

Propriétés
`rating`	Type : `number` Note de cet aspect. Pour les avis individuels, il s'agit d'un entier compris entre 0 et 3. Pour les notes agrégées d'un lieu, il s'agit d'un entier compris entre 0 et 30.
`type`	Type : `string` Type d'aspect. Par exemple, `"food"`, `"decor"`, `"service"` ou `"overall"`.

Constantes BusinessStatus

google.maps.places.BusinessStatus
bibliothèque "places"

État de l'établissement. Pour en savoir plus, consultez la documentation sur les services Web.

Ces constantes peuvent également être utilisées comme des chaînes. En TypeScript, les littéraux de chaîne sont définis par le type BusinessStatusString.

const {BusinessStatus} = await google.maps.importLibrary("places");

Constantes
`CLOSED_PERMANENTLY`	L'établissement est fermé définitivement. Pour en savoir plus, consultez la documentation sur les services Web.
`CLOSED_TEMPORARILY`	L'établissement est temporairement fermé. Pour en savoir plus, consultez la documentation sur les services Web.
`FUTURE_OPENING`	L'établissement ouvrira à une date ultérieure. Pour en savoir plus, consultez la documentation sur les services Web.
`OPERATIONAL`	L'établissement est opérationnel, mais pas nécessairement ouvert actuellement. Pour en savoir plus, consultez la documentation sur les services Web.

Interface PlaceGeometry

interface google.maps.places.PlaceGeometry

Définit les informations sur la géométrie d'un lieu.

Propriétés
`location` facultatif	Type : `LatLng optional` La position du lieu.
`viewport` facultatif	Type : `LatLngBounds optional` Fenêtre d'affichage préférée lors de l'affichage de ce lieu sur une carte. Cette propriété sera `null` si la fenêtre d'affichage préférée pour le lieu n'est pas connue. Disponible uniquement avec `PlacesService.getDetails`.

Interface PlaceOpeningHours

interface google.maps.places.PlaceOpeningHours

Définit les informations sur les horaires d'ouverture d'un lieu.

Propriétés
`open_now` facultatif	Obsolète : `open_now` est obsolète depuis novembre 2019. Utilisez plutôt la méthode `PlaceOpeningHours.isOpen` à partir d'un résultat `PlacesService.getDetails`. Consultez https://goo.gle/js-open-now. Type : `boolean optional` Indique si le lieu est ouvert à l'heure actuelle.
`periods` facultatif	Type : `Array<PlaceOpeningHoursPeriod> optional` Périodes d'ouverture pour chaque jour de la semaine, à partir du dimanche, dans l'ordre chronologique. Les jours où l'établissement est fermé ne sont pas inclus. Disponible uniquement avec `PlacesService.getDetails`.
`weekday_text` facultatif	Type : `Array<string> optional` Tableau de sept chaînes représentant les horaires d'ouverture formatés pour chaque jour de la semaine. Le service Places formate et localise les horaires d'ouverture de manière appropriée pour la langue actuelle. L'ordre des éléments dans ce tableau dépend de la langue. Pour certaines langues, le premier jour de la semaine est le lundi ; pour d'autres, c'est le dimanche. Disponible uniquement avec `PlacesService.getDetails`. D'autres appels peuvent renvoyer un tableau vide.

Méthodes
`isOpen`	`isOpen([date])` Paramètres : `date: Date optional` Valeur renvoyée : `boolean\|undefined` Vérifiez si le lieu est ouvert maintenant (si aucune date n'est transmise) ou à la date indiquée. Si ce lieu n'a pas de `PlaceResult.utc_offset_minutes` ni de `PlaceOpeningHours.periods`, `undefined` est renvoyé (`PlaceOpeningHours.periods` n'est disponible que via `PlacesService.getDetails`). Cette méthode ne prend pas en compte les horaires exceptionnels, comme les horaires d'ouverture pendant les jours fériés.

Méthodes

isOpen

isOpen([date])

Paramètres :

date: Date optional

Valeur renvoyée : boolean|undefined

Vérifiez si le lieu est ouvert maintenant (si aucune date n'est transmise) ou à la date indiquée. Si ce lieu n'a pas de PlaceResult.utc_offset_minutes ni de PlaceOpeningHours.periods, undefined est renvoyé (PlaceOpeningHours.periods n'est disponible que via PlacesService.getDetails). Cette méthode ne prend pas en compte les horaires exceptionnels, comme les horaires d'ouverture pendant les jours fériés.

Interface PlaceOpeningHoursPeriod

interface google.maps.places.PlaceOpeningHoursPeriod

Définit des informations structurées sur les horaires d'ouverture d'un lieu. Remarque : Si un lieu est toujours ouvert, la section close ne figurera pas dans la réponse. Vous pouvez représenter un lieu toujours ouvert par une période open contenant day avec la valeur 0 et time avec la valeur "0000", et aucun close.

Propriétés
`open`	Type : `PlaceOpeningHoursTime` Heure d'ouverture du lieu.
`close` facultatif	Type : `PlaceOpeningHoursTime optional` Heure de fermeture du lieu.

PlaceOpeningHoursTime interface

interface google.maps.places.PlaceOpeningHoursTime

Définit l'heure d'ouverture ou de fermeture d'un lieu.

Propriétés
`day`	Type : `number` Les jours de la semaine, sous forme de nombre compris entre `0` et `6`, en commençant par le dimanche. Par exemple, `2` correspond au mardi.
`hours`	Type : `number` Heures de `PlaceOpeningHoursTime.time` sous forme de nombre, dans la plage [`0`, `23`]. Elles seront indiquées dans le fuseau horaire du lieu.
`minutes`	Type : `number` Minutes de l'`PlaceOpeningHoursTime.time` sous forme de nombre, comprises entre [`0`, `59`]. Elles seront indiquées dans le fuseau horaire du lieu.
`time`	Type : `string` Heure de la journée au format 24 heures "hhmm". Les valeurs sont comprises entre `"0000"` et `"2359"`. L'heure sera indiquée dans le fuseau horaire du lieu.
`nextDate` facultatif	Type : `number optional` Code temporel (en millisecondes depuis l'epoch, adapté à une utilisation avec `new Date()`) représentant la prochaine occurrence de ce PlaceOpeningHoursTime. Il est calculé à partir du `PlaceOpeningHoursTime.day` de la semaine, du `PlaceOpeningHoursTime.time` et du `PlaceResult.utc_offset_minutes`. Si `PlaceResult.utc_offset_minutes` est défini sur `undefined`, `nextDate` sera défini sur `undefined`.

Interface PlacePlusCode

interface google.maps.places.PlacePlusCode

Définit les codes Open Location Code ou "plus codes" d'un lieu. Vous pouvez utiliser des Plus Codes pour remplacer les adresses postales dans les endroits où elles n'existent pas (où les bâtiments ne sont pas numérotés ni nommés).

Propriétés
`global_code`	Type : `string` Plus Code avec une zone de 1/8 000e de degré par 1/8 000e de degré. Exemple :`"8FVC9G8F+5W"`
`compound_code` facultatif	Type : `string optional` Plus code avec une zone de 1/8 000e de degré par 1/8 000e de degré, où les quatre premiers caractères (l'indicatif régional) sont supprimés et remplacés par une description de la localité. Exemple :`"9G8F+5W Zurich, Switzerland"` Si aucune localité appropriée ne peut être trouvée pour raccourcir le code, ce champ est omis.

Interface PlacePhoto

interface google.maps.places.PlacePhoto

Représente un élément photo d'un lieu.

Propriétés
`height`	Type : `number` Hauteur de la photo en pixels.
`html_attributions`	Type : `Array<string>` Texte d'attribution à afficher pour cette photo.
`width`	Type : `number` Largeur de la photo en pixels.

Méthodes
`getUrl`	`getUrl([opts])` Paramètres : `opts: PhotoOptions optional` Valeur renvoyée : `string` Renvoie l'URL de l'image correspondant aux options spécifiées.

PhotoOptions

interface google.maps.places.PhotoOptions

Définit les options de demande de photo.

Propriétés
`maxHeight` facultatif	Type : `number optional` Hauteur maximale en pixels de l'image renvoyée.
`maxWidth` facultatif	Type : `number optional` Largeur maximale en pixels de l'image renvoyée.

PlaceReview

interface google.maps.places.PlaceReview

Représente un avis unique sur un lieu.

Propriétés
`author_name`	Type : `string` Nom de l'auteur de l'avis.
`language`	Type : `string` Code de langue IETF indiquant la langue dans laquelle cet avis est rédigé. Notez que ce code n'inclut que l'indicateur principal de la langue, sans tag secondaire indiquant le pays ou la région. Par exemple, tous les avis en anglais sont signalés par `'en'`, et non "en-AU" ou "en-UK".
`profile_photo_url`	Type : `string` URL de l'image de profil de l'auteur de l'avis.
`relative_time_description`	Type : `string` Chaîne de texte formatée indiquant l'heure récente, exprimant l'heure de l'avis par rapport à l'heure actuelle dans un format approprié pour la langue et le pays. Exemple : `"a month ago"`.
`text`	Type : `string` Texte d'un avis.
`time`	Type : `number` Horodatage de l'avis, exprimé en secondes depuis l'epoch.
`aspects` facultatif	Obsolète : ce champ n'est plus disponible. Type : `Array<PlaceAspectRating> optional` Aspects évalués par l'avis. Les notes sur une échelle de 0 à 3.
`author_url` facultatif	Type : `string optional` URL du profil de l'auteur de l'avis. Cette valeur sera `undefined` lorsque le profil de l'auteur de l'avis ne sera pas disponible.
`rating` facultatif	Type : `number optional` Note de cet avis, un nombre compris entre 1,0 et 5,0 (inclus).

Places Service (deprecated) Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Classe PlacesService

Constructeur

Méthodes

Interface PlaceDetailsRequest

Propriétés

FindPlaceFromPhoneNumberRequest interface

Propriétés

Interface FindPlaceFromQueryRequest

Propriétés

Interface PlaceSearchRequest

Propriétés

TextSearchRequest

Propriétés

Constantes RankBy

Constantes

typedef LocationBias

LocationRestriction typedef

Constantes PlacesServiceStatus

Constantes

Interface PlaceSearchPagination

Propriétés

Méthodes

Interface PlaceResult

Propriétés

Interface PlaceAspectRating

Propriétés

Constantes BusinessStatus

Constantes

Interface PlaceGeometry

Propriétés

Interface PlaceOpeningHours

Propriétés

Méthodes

Interface PlaceOpeningHoursPeriod

Propriétés

PlaceOpeningHoursTime interface

Propriétés

Interface PlacePlusCode

Propriétés

Interface PlacePhoto

Propriétés

Méthodes

PhotoOptions

Propriétés

PlaceReview

Propriétés

Places Service (deprecated)