Places Service

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

PlacesService

Classe google.maps.places.PlacesService

Contient des méthodes liées à la recherche de lieux et à la récupération de détails sur un lieu.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
PlacesService
PlacesService(attrContainer)
Paramètres :
  • attrContainer : HTMLDivElement|Map
Crée une instance de PlacesService qui affiche les attributions dans le conteneur spécifié.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Paramètres :
Valeur de retour:aucune
Récupère une liste de lieux à partir d'un numéro de téléphone. Dans la plupart des cas, la liste des résultats ne doit inclure 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 pour le lieu souhaité.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Paramètres :
Valeur de retour:aucune
Récupère une liste de lieux en fonction d'une chaîne de requête. Dans la plupart des cas, la liste des résultats ne doit inclure 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 pour le lieu souhaité.
getDetails
getDetails(request, callback)
Paramètres:
Valeur de retour:aucune
Récupère les détails du lieu identifié par le placeId donné.
nearbySearch
nearbySearch(request, callback)
Paramètres :
Valeur de retour : aucune
Récupère une liste de lieux situés à proximité d'un lieu précis, 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 des paramètres location et radius. Les PlaceResult transmis au rappel sont des sous-ensembles des PlaceResult complets. Votre application peut obtenir un PlaceResult plus détaillé pour chaque lieu en envoyant une requête Places Details qui transmet le PlaceResult.place_id pour le lieu souhaité. L'objet PlaceSearchPagination peut être utilisé pour extraire des pages de résultats supplémentaires (vide 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 :
Valeur de retour:aucune
Récupère une liste de lieux en fonction d'une chaîne de requête (par exemple, "pizza à New York" ou "magasin de chaussures près d'Ottawa"). Les paramètres de localisation sont facultatifs. Lorsque l'emplacement est spécifié, les résultats ne sont orientés que vers les résultats à proximité et non limités aux lieux situés à l'intérieur de la zone. Utilisez textSearch lorsque vous souhaitez rechercher des lieux à l'aide d'une chaîne arbitraire, et lorsque vous ne souhaitez pas limiter les résultats de recherche à un lieu spécifique. L'objet PlaceSearchPagination peut être utilisé pour extraire des pages de résultats supplémentaires (vide 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

google.maps.places.PlaceDetailsRequest interface

Requête Place Details à envoyer au PlacesService.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
placeId
Type:string
Identifiant du lieu pour lequel des informations sont demandées.
fields optional
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 sont renvoyés et facturés (non recommandé pour les déploiements en production). Pour obtenir la liste des champs, consultez PlaceResult. Vous pouvez spécifier des champs imbriqués à l'aide de points (par exemple, "geometry.location").
">language optional
Type : string optional
Identifiant de la langue dans laquelle les informations doivent être renvoyées. Consultez la liste des langues disponibles. Cette liste peut ne pas être exhaustive, car Google met régulièrement à jour les langues prises en charge.
">region optional
Type:string optional
Code de région de l'utilisateur. Cela peut affecter les photos renvoyées, voire d'autres éléments. Le code de région 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) alors que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
sessionToken optional
Type : AutocompleteSessionToken optional
Référence unique utilisée pour regrouper la requête de détails avec une session de saisie semi-automatique.

Interface FindPlaceFromPhoneNumberRequest

google.maps.places.FindPlaceFromPhoneNumberRequest interface

Lieu à partir duquel envoyer une requête de recherche textuelle à PlacesService.findPlaceFromPhoneNumber.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
fields
Type:Array<string>
Champs à inclure dans la réponse, qui seront facturés. Si la valeur ['ALL'] est transmise, tous les champs disponibles sont renvoyés et facturés (non recommandé pour les déploiements en production). Pour obtenir la liste des champs, consultez PlaceResult. Vous pouvez spécifier des champs imbriqués à l'aide de points (par exemple, "geometry.location").
phoneNumber
Type : string
Numéro de téléphone du lieu à rechercher. Le format doit être E.164.
">language optional
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. Cette liste peut ne pas être exhaustive, car Google met régulièrement à jour les langues prises en charge.
locationBias optional
Type:LocationBias optional
Biais utilisé lors de la recherche de lieu. Le résultat sera orienté vers le LocationBias donné, mais sans s'y limiter.

Interface FindPlaceFromQueryRequest

google.maps.places.FindPlaceFromQueryRequest interface

Lieu à partir duquel envoyer une requête de recherche textuelle à PlacesService.findPlaceFromQuery.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
fields
Type : Array<string>
Champs à inclure dans la réponse, qui seront facturés. Si la valeur ['ALL'] est transmise, tous les champs disponibles sont renvoyés et facturés (non recommandé pour les déploiements en production). Pour obtenir la liste des champs, consultez PlaceResult. Vous pouvez spécifier des champs imbriqués à l'aide de points (par exemple, "geometry.location").
query
Type : string
Requête de la requête. Par exemple, le nom ou l'adresse d'un lieu.
">language optional
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. Cette liste peut ne pas être exhaustive, car Google met régulièrement à jour les langues prises en charge.
locationBias optional
Type:LocationBias optional
Biais utilisé lors de la recherche de lieu. Le résultat sera orienté vers le LocationBias donné, mais sans s'y limiter.

Interface PlaceSearchRequest

google.maps.places.PlaceSearchRequest interface

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
bounds optional
Limites dans lesquelles rechercher des lieux. location et radius seront ignorés si bounds est défini.
keyword optional
Type:string optional
Terme à comparer à 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 optional
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. Cette liste peut ne pas être exhaustive, car Google met régulièrement à jour les langues prises en charge.
location optional
Type : LatLng|LatLngLiteral optional
Lieu autour duquel rechercher des lieux.
maxPriceLevel optional
Type : number optional
Limite les résultats aux seuls lieux dont le 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. Doit être supérieur ou égal à minPrice , si spécifié.
minPriceLevel optional
Type : number optional
Limite les résultats aux seuls lieux dont le prix est supérieur ou égal à 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 optional
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 optional
Type : boolean optional
Limite les résultats aux lieux ouverts actuellement.
radius optional
Type:number optional
Distance par rapport au lieu de recherche de lieux, en mètres. La valeur maximale autorisée est de 50 000.
rankBy optional
Type:RankBy optional
Par défaut : RankBy.PROMINENCE
Spécifie la méthode de classement à utiliser lors du renvoi de résultats. Notez que lorsque rankBy est défini sur DISTANCE, vous devez spécifier un location, mais pas radius ou bounds.
type optional
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 dans 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 catégorielles indépendantes de la langue et de la région. Les types valides sont indiqués sur cette page.

Interface TextSearchRequest

google.maps.places.TextSearchRequest interface

Requête de recherche textuelle à envoyer au PlacesService.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
bounds optional
Limites utilisées pour pondérer 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 se limitent pas à ceux compris dans ces limites. En revanche, les résultats situés à l'intérieur obtiennent un meilleur classement.
">language optional
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. Cette liste peut ne pas être exhaustive, car Google met régulièrement à jour les langues prises en charge.
location optional
Type : LatLng|LatLngLiteral optional
Centre de la zone utilisée pour pondérer les résultats lors de la recherche de lieux.
query optional
Type:string optional
Terme de requête de la requête. Par exemple, le nom d'un lieu ("Tour Eiffel"), une catégorie suivie du nom d'un lieu ("pizza à Paris") ou le nom d'un lieu suivi du nom d'un lieu ("Starbucks Paris").
radius optional
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 optional
Type:string optional
Code régional vers lequel orienter les résultats. Le code de région 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) alors que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord").
type optional
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 dans 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 catégorielles indépendantes de la langue et de la région. Les types valides sont indiqués sur cette page.

Constantes RankBy

constantes google.maps.places.RankBy

Options de classement d'une requête PlaceSearchRequest

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
DISTANCE Classer les résultats en fonction de la distance par rapport au lieu
PROMINENCE Les classements placent les résultats en fonction de leur proéminence.

LocationBias typedef

google.maps.places.LocationBias typedef

Un LocationBias représente une limite flexible ou un indice à utiliser lorsque vous recherchez des 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 un biais, vous pouvez spécifier la chaîne "IP_BIAS". Remarque: Si vous utilisez Circle, vous devez définir le centre et le rayon.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.

LatLngBounds|LatLngBoundsLiteral

Constantes PlacesServiceStatus

constantes google.maps.places.PlacesServiceStatus

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
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

google.maps.places.PlaceSearchPagination interface

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
hasNextPage
Type:boolean
Indique si d'autres résultats sont disponibles. true lorsqu'il existe une page de résultats supplémentaire.
nextPage
nextPage()
Paramètres : aucun
Valeur de retour:aucune
Récupère la page suivante de résultats. Utilise la même fonction de rappel que celle fournie pour la première requête de recherche.

Interface PlaceResult

google.maps.places.PlaceResult interface

Définit les informations concernant un lieu.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
address_components optional
Type : Array<GeocoderAddressComponent> optional
Collection de composants d'adresse pour l'emplacement de ce lieu. Disponible uniquement avec PlacesService.getDetails.
adr_address optional
Type : string optional
Représentation de l'adresse du lieu au microformat adr. Disponible uniquement avec PlacesService.getDetails.
aspects optional
Type:Array<PlaceAspectRating> optional
Évaluation de ce lieu, basée sur les avis des utilisateurs de Google et Zagat. Les notes sont calculées sur une échelle de 0 à 30.
business_status optional
Type : BusinessStatus optional
Indicateur indiquant l'état opérationnel du lieu, s'il s'agit d'un établissement (il indique si le lieu est opérationnel, ou s'il est fermé temporairement ou définitivement). Si aucune donnée n'est disponible, l'indicateur n'est pas présent dans les réponses aux recherches ni aux détails.
formatted_address optional
Type : string optional
Adresse complète du lieu.
formatted_phone_number optional
Type : string optional
Numéro de téléphone du lieu, au format conforme à la norme régionale. Disponible uniquement avec PlacesService.getDetails.
geometry optional
Type : PlaceGeometry optional
Informations liées à la géométrie du lieu.
html_attributions optional
Type : Array<string> optional
Texte d'attribution à afficher pour ce résultat de lieu. Les html_attributions disponibles sont toujours renvoyés, quelles que soient les fields demandées, et doivent être affichées.
icon optional
Type:string optional
URL d'une ressource d'image pouvant représenter la catégorie de ce lieu.
icon_background_color optional
Type : string optional
Couleur d'arrière-plan à utiliser avec l'icône d'un lieu. Voir aussi PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Type:string optional
URL tronquée d'un masque d'icône. Accédez à différents types d'icônes en ajoutant une extension de fichier à la fin (c'est-à-dire .svg ou .png).
international_phone_number optional
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 optional
Type : string optional
Nom du lieu. Remarque: Dans le cas des adresses saisies par l'utilisateur, ces informations correspondent au texte brut saisi par l'utilisateur. Soyez prudent lorsque vous vous servez de ces données, car des utilisateurs malveillants peuvent essayer de l'utiliser comme vecteur pour effectuer des attaques par injection de code (voir http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
Type:PlaceOpeningHours optional
Définit les horaires d'ouverture ou de fermeture du lieu.
permanently_closed optional
Type : boolean optional
Indicateur signalant si le lieu est fermé définitivement ou temporairement. Si le lieu est opérationnel ou si aucune donnée n'est disponible, l'indicateur ne figure pas dans la réponse.
photos optional
Type:Array<PlacePhoto> optional
Photos de ce lieu. La collection contiendra jusqu'à 10 objets PlacePhoto.
place_id optional
Type:string optional
Identifiant unique du lieu.
plus_code optional
Type : PlacePlusCode optional
Définit les codes de lieu ouverts ou les plus codes associés au lieu.
price_level optional
Type : number optional
Niveau de tarification du lieu, sur une échelle de 0 à 4. Les niveaux de prix sont interprétés comme suit :
  • 0: offert
  • 1: petit prix
  • 2 : modéré
  • 3 : coûteux
  • 4: très cher
rating optional
Type:number optional
Note comprise entre 1 et 5, basée sur les avis des utilisateurs sur ce lieu.
reviews optional
Type:Array<PlaceReview> optional
Liste des avis sur ce lieu. Disponible uniquement avec PlacesService.getDetails.
types optional
Type:Array<string> optional
Tableau des types pour ce lieu (par exemple, ["political", "locality"] ou ["restaurant", "establishment"]).
url optional
Type : string optional
URL de la page Google officielle de ce lieu. Il s'agit de la page Google contenant les meilleures informations disponibles sur le lieu. Disponible uniquement avec PlacesService.getDetails.
user_ratings_total optional
Type : number optional
Nombre de notes des visiteurs qui ont contribué au PlaceResult.rating de ce lieu.
utc_offset optional
Type : number optional
Décalage par rapport au UTC du fuseau horaire actuel du lieu, en minutes. Par exemple, en Australie (à l'heure d'été), Sydney est en avance de 11 heures sur l'heure UTC, donc la valeur de utc_offset est 660. Pour les fuseaux horaires de type UTC, le décalage est négatif. Par exemple, utc_offset est -60 pour le Cap-Vert. Disponible uniquement avec PlacesService.getDetails.
utc_offset_minutes optional
Type:number optional
Décalage par rapport au UTC du fuseau horaire actuel du lieu, en minutes. Par exemple, en Australie (à l'heure d'été), Sydney est en avance de 11 heures sur l'heure UTC, donc la valeur de utc_offset_minutes est 660. Pour les fuseaux horaires de type UTC, le décalage est négatif. Par exemple, utc_offset_minutes est -60 pour le Cap-Vert. Disponible uniquement avec PlacesService.getDetails.
vicinity optional
Type:string optional
Adresse simplifiée du lieu, comprenant le nom de la rue, le numéro de rue et la localité, mais pas la province/l'État, le code postal ou le pays. Par exemple, le bureau de Google à Sydney en Australie a une valeur approximative de "48 Pirrama Road, Pyrmont". Disponible uniquement avec PlacesService.getDetails.
website optional
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

google.maps.places.PlaceAspectRating interface

Fournit des informations sur un aspect du lieu sur lequel les utilisateurs ont rédigé un avis.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
rating
Type : number
Note attribuée à 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

constantes google.maps.places.BusinessStatus

État opérationnel du lieu, s'il s'agit d'une entreprise, renvoyé dans un résultat PlaceResult (indique si le lieu est opérationnel, ou s'il est fermé temporairement ou définitivement). Indiquez-les par valeur ou par le nom de la constante (par exemple : 'OPERATIONAL' ou google.maps.places.BusinessStatus.OPERATIONAL).

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
CLOSED_PERMANENTLY L'établissement est définitivement fermé.
CLOSED_TEMPORARILY L'établissement est fermé temporairement.
OPERATIONAL L'établissement fonctionne normalement.

Interface PlaceGeometry

google.maps.places.PlaceGeometry interface

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
location optional
Type:LatLng optional
Position du lieu.
viewport optional
Type : LatLngBounds optional
Vue actuelle de ce lieu sur une carte. Cette propriété sera null si la fenêtre d'affichage préférée pour le lieu est inconnue. Disponible uniquement avec PlacesService.getDetails.

Interface PlaceOpeningHours

google.maps.places.PlaceOpeningHours interface

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
open_now optional
Type:boolean optional
Indique si le lieu est ouvert à cette heure.
periods optional
Type:Array<PlaceOpeningHoursPeriod> optional
Périodes d'ouverture pour chaque jour de la semaine, à partir du dimanche, dans l'ordre chronologique. Les jours où le lieu n'est pas ouvert ne sont pas inclus. Disponible uniquement avec PlacesService.getDetails.
weekday_text optional
Type : Array<string> optional
Tableau de sept chaînes représentant les heures d'ouverture formatées pour chaque jour de la semaine. Le service Places met en forme et localise les horaires d'ouverture dans 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. Les autres appels peuvent renvoyer un tableau vide.
isOpen
isOpen([date])
Paramètres :
  • date:  Date optional
Valeur renvoyée : boolean|undefined
Vérifiez si le lieu est actuellement ouvert (quand aucune date n'a été dépassée) ou à la date donnée. Si ce lieu ne comporte ni PlaceResult.utc_offset_minutes, ni 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 jours fériés.

Interface PlaceOpeningHoursPeriod

google.maps.places.PlaceOpeningHoursPeriod interface

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
open
Heure d'ouverture du lieu.
close optional
Type : PlaceOpeningHoursTime optional
Heure de fermeture du lieu.

Interface PlaceOpeningHoursTime

google.maps.places.PlaceOpeningHoursTime interface

Définit les horaires d'ouverture ou de fermeture d'un établissement.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
day
Type : number
Jours de la semaine, indiqués sous la forme d'un nombre compris dans la plage [0, 6], à partir du dimanche Par exemple, 2 signifie mardi.
hours
Type:number
Horaires de PlaceOpeningHoursTime.time sous forme de nombre, compris dans la plage [0, 23]. Ils seront indiqués selon le fuseau horaire du lieu.
minutes
Type : number
Minutes (PlaceOpeningHoursTime.time) exprimées sous forme de nombre dans la plage [0, 59]. Elles seront exprimées dans le fuseau horaire du lieu.
time
Type : string
Heure au format 24 heures "hhmm". Les valeurs sont comprises dans la plage ["0000", "2359"]. L'heure est alors indiquée dans le fuseau horaire du lieu.
nextDate optional
Type : number optional
Horodatage (en millisecondes depuis l'époque, adapté à une utilisation avec new Date()) représentant la prochaine occurrence de PlaceOpeningHoursTime. Elle est calculée à partir du PlaceOpeningHoursTime.day de la semaine, du PlaceOpeningHoursTime.time et du PlaceResult.utc_offset_minutes. Si la valeur de PlaceResult.utc_offset_minutes est undefined, nextDate est undefined.

Interface PlacePlusCode

google.maps.places.PlacePlusCode interface

Définit les codes de lieu ouverts ou les plus codes pour un lieu. Les Plus Codes peuvent 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).

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
global_code
Type : string
Un code plus avec une échelle de 1/8000e de degré par 1/8000e de degré Exemple : "8FVC9G8F+5W".
compound_code optional
Type:string optional
Un code plus avec une échelle de 1/8000e de degré par 1/8000e de degré, où les quatre premiers caractères (l'indicatif de zone) sont déposés et remplacés par une description de localité. Exemple : "9G8F+5W Zurich, Switzerland". Si aucune localité appropriée ne peut être raccourcie, ce champ est omis.

Interface PlacePhoto

google.maps.places.PlacePhoto interface

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

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
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.
getUrl
getUrl([opts])
Paramètres :
Valeur renvoyée : string
Renvoie l'URL de l'image correspondant aux options spécifiées.

PhotoOptions

google.maps.places.PhotoOptions interface

Définit les options de demande de photo.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
maxHeight optional
Type:number optional
Hauteur maximale en pixels de l'image renvoyée.
maxWidth optional
Type:number optional
Largeur maximale en pixels de l'image renvoyée.

Interface PlaceReview

google.maps.places.PlaceReview interface

Représente un seul avis sur un lieu.

Nécessite le paramètre d'URL &libraries=places. Consultez Bibliothèques dans l'API Maps JavaScript.
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 la balise de langue principale, sans aucune balise secondaire indiquant le pays ou la région. Par exemple, tous les avis en anglais sont associés au libellé 'en' au lieu de "en-AU" ou "en-UK".
profile_photo_url
Type:string
URL de l'image de profil du visiteur.
relative_time_description
Type:string
Chaîne d'heure récente mise en forme qui exprime l'heure de l'examen par rapport à l'heure actuelle dans un format adapté à la langue et au 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 optional
Type : Array<PlaceAspectRating> optional
Éléments évalués par l'avis. Les notes vont de 0 à 3.
author_url optional
Type:string optional
URL du profil du contributeur. Ce champ sera défini sur undefined lorsque sa fiche sera indisponible.
rating optional
Type:number optional
Note attribuée à cet avis (entre 1 et 5).