Places Service (deprecated)

Classe PlacesService

classe google.maps.places.PlacesService
libreria "places"

Ritirato: a partire dal 1° marzo 2025, google.maps.places.PlacesService non è disponibile per i nuovi clienti. Utilizza Place. Al momento, non è prevista la dismissione di google.maps.places.PlacesService, ma è consigliabile utilizzare Place anziché google.maps.places.PlacesService. Sebbene google.maps.places.PlacesService continuerà a ricevere correzioni di bug per eventuali regressioni importanti, i bug esistenti in google.maps.places.PlacesService non verranno risolti. Verrà dato un preavviso di almeno 12 mesi prima dell'interruzione dell'assistenza. Per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/legacy e la guida alla migrazione all'indirizzo https://developers.google.com/maps/documentation/javascript/places-migration-overview.

Contiene metodi relativi alla ricerca di luoghi e al recupero di dettagli su un luogo.

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

Costruttore
PlacesService	PlacesService(attrContainer) Parametri: attrContainer: HTMLDivElement|Map Crea una nuova istanza di PlacesService che esegue il rendering delle attribuzioni nel contenitore specificato.

Metodi
findPlaceFromPhoneNumber	findPlaceFromPhoneNumber(request, callback) Parametri: request: FindPlaceFromPhoneNumberRequest callback: function(Array<PlaceResult> optional, PlacesServiceStatus): void Valore restituito: nessuno Recupera un elenco di luoghi in base a un numero di telefono. Nella maggior parte dei casi, l'elenco dei risultati dovrebbe contenere un solo elemento, ma se la richiesta è ambigua, potrebbero essere restituiti più risultati. Gli oggetti PlaceResult passati al callback sono sottoinsiemi di un oggetto PlaceResult completo. La tua app può ottenere un PlaceResult più dettagliato per ogni luogo chiamando PlacesService.getDetails e passando il PlaceResult.place_id per il luogo desiderato.
findPlaceFromQuery	findPlaceFromQuery(request, callback) Parametri: request: FindPlaceFromQueryRequest callback: function(Array<PlaceResult> optional, PlacesServiceStatus): void Valore restituito: nessuno Recupera un elenco di luoghi in base a una stringa di query. Nella maggior parte dei casi, l'elenco dei risultati dovrebbe contenere un solo elemento, ma se la richiesta è ambigua, potrebbero essere restituiti più risultati. Gli oggetti PlaceResult passati al callback sono sottoinsiemi di un oggetto PlaceResult completo. La tua app può ottenere un PlaceResult più dettagliato per ogni luogo chiamando PlacesService.getDetails e passando il PlaceResult.place_id per il luogo desiderato.
getDetails	getDetails(request, callback) Parametri: request: PlaceDetailsRequest callback: function(PlaceResult optional, PlacesServiceStatus): void Valore restituito: nessuno Recupera i dettagli del luogo identificato dal placeId specificato.
nearbySearch	nearbySearch(request, callback) Parametri: request: PlaceSearchRequest callback: function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void Valore restituito: nessuno Recupera un elenco di luoghi vicino a una determinata località, in base alla parola chiave o al tipo. La località deve essere sempre specificata, passando un parametro LatLngBounds o i parametri location e radius. Gli oggetti PlaceResult passati al callback sono sottoinsiemi dell'oggetto PlaceResult completo. La tua app può ottenere un PlaceResult più dettagliato per ogni luogo inviando una richiesta Place Details che trasmette il PlaceResult.place_id per il luogo desiderato. L'oggetto PlaceSearchPagination può essere utilizzato per recuperare altre pagine di risultati (null se questa è l'ultima pagina di risultati o se esiste una sola pagina di risultati).
textSearch	textSearch(request, callback) Parametri: request: TextSearchRequest callback: function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void Valore restituito: nessuno Recupera un elenco di luoghi in base a una stringa di query (ad esempio, "pizza a New York" o "negozi di scarpe vicino a Ottawa"). I parametri di posizione sono facoltativi. Quando la posizione è specificata, i risultati sono solo orientati verso i risultati nelle vicinanze, anziché essere limitati ai luoghi all'interno dell'area. Utilizza textSearch quando vuoi cercare luoghi utilizzando una stringa arbitraria e nei casi in cui non vuoi limitare i risultati di ricerca a una località specifica. L'oggetto PlaceSearchPagination può essere utilizzato per recuperare altre pagine di risultati (null se questa è l'ultima pagina di risultati o se esiste una sola pagina di risultati).

Interfaccia PlaceDetailsRequest

interfaccia google.maps.places.PlaceDetailsRequest

Una query Place Details da inviare a PlacesService.

Proprietà
placeId	Tipo: string L'ID luogo del luogo per cui vengono richiesti i dettagli.
fields facoltativo	Tipo: Array<string> optional Campi da includere nella risposta dei dettagli, che verranno fatturati. Se non vengono specificati campi o se viene passato ['ALL'], verranno restituiti e fatturati tutti i campi disponibili (questa opzione non è consigliata per i deployment di produzione). Per un elenco dei campi, consulta PlaceResult. I campi nidificati possono essere specificati con percorsi con punti (ad esempio, "geometry.location").
language facoltativo	Tipo: string optional Un identificatore della lingua in cui devono essere restituiti i dettagli. Consulta l'elenco delle lingue supportate.
region facoltativo	Tipo: string optional Un codice regione della regione dell'utente. Ciò può influire sulle foto che potrebbero essere restituite e, eventualmente, su altri elementi. Il codice regione accetta un valore di due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk " (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").
sessionToken facoltativo	Tipo: AutocompleteSessionToken optional Riferimento univoco utilizzato per raggruppare la richiesta di dettagli con una sessione di completamento automatico.

Interfaccia FindPlaceFromPhoneNumberRequest

interfaccia google.maps.places.FindPlaceFromPhoneNumberRequest

Una richiesta di ricerca testuale di un luogo da inviare a PlacesService.findPlaceFromPhoneNumber.

Proprietà
fields	Tipo: Array<string> Campi da includere nella risposta, che verranno fatturati. Se viene passato ['ALL'], verranno restituiti e fatturati tutti i campi disponibili (questa opzione non è consigliata per i deployment di produzione). Per un elenco dei campi, consulta PlaceResult. I campi nidificati possono essere specificati con percorsi con punti (ad esempio, "geometry.location").
phoneNumber	Tipo: string Il numero di telefono del luogo da cercare. Il formato deve essere E.164.
language facoltativo	Tipo: string optional Un identificatore della lingua in cui devono essere restituiti i nomi e gli indirizzi, se possibile. Consulta l'elenco delle lingue supportate.
locationBias facoltativo	Tipo: LocationBias optional La preferenza utilizzata per la ricerca di un luogo. Il risultato sarà influenzato, ma non limitato, dal valore LocationBias specificato.

Interfaccia FindPlaceFromQueryRequest

interfaccia google.maps.places.FindPlaceFromQueryRequest

Una richiesta di ricerca testuale di un luogo da inviare a PlacesService.findPlaceFromQuery.

Proprietà
fields	Tipo: Array<string> Campi da includere nella risposta, che verranno fatturati. Se viene passato ['ALL'], verranno restituiti e fatturati tutti i campi disponibili (questa opzione non è consigliata per i deployment di produzione). Per un elenco dei campi, consulta PlaceResult. I campi nidificati possono essere specificati con percorsi con punti (ad esempio, "geometry.location").
query	Tipo: string La query della richiesta. Ad esempio, il nome o l'indirizzo di un luogo.
language facoltativo	Tipo: string optional Un identificatore della lingua in cui devono essere restituiti i nomi e gli indirizzi, se possibile. Consulta l'elenco delle lingue supportate.
locationBias facoltativo	Tipo: LocationBias optional La preferenza utilizzata per la ricerca di un luogo. Il risultato sarà influenzato, ma non limitato, dal valore LocationBias specificato.

Interfaccia PlaceSearchRequest

interfaccia google.maps.places.PlaceSearchRequest

Una query di ricerca di luoghi da inviare a PlacesService.

Proprietà
bounds facoltativo	Tipo: LatLngBounds|LatLngBoundsLiteral optional I limiti entro i quali cercare i luoghi. Se è impostato bounds, sia location che radius verranno ignorati.
keyword facoltativo	Tipo: string optional Un termine da confrontare con tutti i campi disponibili, inclusi, a titolo esemplificativo, nome, tipo e indirizzo, nonché recensioni dei clienti e altri contenuti di terze parti.
language facoltativo	Tipo: string optional Un identificatore della lingua in cui devono essere restituiti i nomi e gli indirizzi, se possibile. Consulta l'elenco delle lingue supportate.
location facoltativo	Tipo: LatLng|LatLngLiteral optional La località intorno alla quale cercare i luoghi.
maxPriceLevel facoltativo	Tipo: number optional Limita i risultati solo ai luoghi con il livello di prezzo specificato o inferiore. I valori validi sono compresi nell'intervallo da 0 (più economico) a 4 (più costoso) inclusi. Se specificato, deve essere maggiore o uguale a minPrice .
minPriceLevel facoltativo	Tipo: number optional Limita i risultati solo ai luoghi con il livello di prezzo specificato o superiore. I valori validi sono compresi nell'intervallo da 0 (più economico) a 4 (più costoso) inclusi. Deve essere inferiore o uguale a maxPrice, se specificato.
name facoltativo	Deprecato: utilizza keyword. Tipo: string optional Equivalente a keyword. I valori di questo campo vengono combinati con i valori del campo keyword e trasmessi come parte della stessa stringa di ricerca.
openNow facoltativo	Tipo: boolean optional Limita i risultati solo ai luoghi aperti in questo momento.
radius facoltativo	Tipo: number optional La distanza dalla località specificata entro cui cercare i luoghi, in metri. Il valore massimo consentito è 50.000.
rankBy facoltativo	Tipo: RankBy optional Valore predefinito: RankBy.PROMINENCE Specifica il metodo di ranking da utilizzare per la restituzione dei risultati. Tieni presente che quando rankBy è impostato su DISTANCE, devi specificare un location, ma non puoi specificare un radius o un bounds.
type facoltativo	Tipo: string optional Cerca luoghi del tipo specificato. Il tipo viene tradotto nella lingua locale della località target della richiesta e utilizzato come stringa di query. Se viene fornita anche una query, questa viene concatenata alla stringa del tipo localizzato. I risultati di un tipo diverso vengono eliminati dalla risposta. Utilizza questo campo per eseguire ricerche per categorie indipendenti dalla lingua e dalla regione. I tipi validi sono indicati qui.

Interfaccia TextSearchRequest

interfaccia google.maps.places.TextSearchRequest

Una richiesta di ricerca testuale da inviare a PlacesService.

Proprietà
bounds facoltativo	Tipo: LatLngBounds|LatLngBoundsLiteral optional Limiti utilizzati per influenzare i risultati durante la ricerca di luoghi (facoltativo). Se è impostato bounds, sia location che radius verranno ignorati. I risultati non saranno limitati a quelli all'interno di questi confini, ma i risultati al loro interno avranno un ranking più elevato.
language facoltativo	Tipo: string optional Un identificatore della lingua in cui devono essere restituiti i nomi e gli indirizzi, se possibile. Consulta l'elenco delle lingue supportate.
location facoltativo	Tipo: LatLng|LatLngLiteral optional Il centro dell'area utilizzato per influenzare i risultati durante la ricerca di luoghi.
query facoltativo	Tipo: string optional Il termine di query della richiesta. Ad esempio, il nome di un luogo ("Torre Eiffel"), una categoria seguita dal nome di una località ("pizza a New York") o il nome di un luogo seguito da un disambiguatore di località ("Starbucks a Sydney").
radius facoltativo	Tipo: number optional Il raggio dell'area utilizzato per influenzare i risultati durante la ricerca di luoghi, in metri.
region facoltativo	Tipo: string optional Un codice regione per influenzare i risultati. Il codice regione accetta un valore di due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD del Regno Unito è "uk " (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").
type facoltativo	Tipo: string optional Cerca luoghi del tipo specificato. Il tipo viene tradotto nella lingua locale della località target della richiesta e utilizzato come stringa di query. Se viene fornita anche una query, questa viene concatenata alla stringa del tipo localizzato. I risultati di un tipo diverso vengono eliminati dalla risposta. Utilizza questo campo per eseguire ricerche per categorie indipendenti dalla lingua e dalla regione. I tipi validi sono indicati qui.

Costanti RankBy

constants google.maps.places.RankBy
library "places"

Opzioni di ranking per una PlaceSearchRequest.

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

Costanti
DISTANCE	Classifica i risultati dei luoghi in base alla distanza dalla località.
PROMINENCE	Ordina i risultati dei luoghi in base alla loro evidenza.

LocationBias typedef

typedef google.maps.places.LocationBias

Un LocationBias rappresenta un confine o un suggerimento flessibile da utilizzare durante la ricerca di luoghi. I risultati potrebbero provenire da un'area diversa da quella specificata. Per utilizzare l'indirizzo IP dell'utente corrente come bias, è possibile specificare la stringa "IP_BIAS". Nota: se utilizzi un Circle, devi definire il centro e il raggio.

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

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

Un LocationRestriction rappresenta un confine rigido da utilizzare per la ricerca di luoghi.

LatLngBounds|LatLngBoundsLiteral

Costanti PlacesServiceStatus

constants google.maps.places.PlacesServiceStatus
library "places"

Lo stato restituito da PlacesService al completamento delle ricerche. Specifica questi valori in base al valore o utilizzando il nome della costante. Ad esempio, 'OK' o google.maps.places.PlacesServiceStatus.OK

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo PlacesServiceStatusString.

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

Costanti
INVALID_REQUEST	La richiesta non è valida.
NOT_FOUND	Il luogo a cui viene fatto riferimento non è stato trovato.
OK	La risposta contiene un risultato valido.
OVER_QUERY_LIMIT	L'applicazione ha superato la quota di richieste.
REQUEST_DENIED	L'applicazione non è autorizzata a utilizzare PlacesService.
UNKNOWN_ERROR	Non è stato possibile elaborare la richiesta PlacesService a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi.
ZERO_RESULTS	Nessun risultato trovato per questa richiesta.

Interfaccia PlaceSearchPagination

interfaccia google.maps.places.PlaceSearchPagination

Un oggetto utilizzato per recuperare pagine aggiuntive dei risultati di Places.

Proprietà
hasNextPage	Tipo: boolean Indica se sono disponibili altri risultati. true quando è presente una pagina di risultati aggiuntiva.

Metodi
nextPage	nextPage() Parametri: nessuno Valore restituito: void Recupera la pagina dei risultati successiva. Utilizza la stessa funzione di callback fornita alla prima richiesta di ricerca.

Interfaccia PlaceResult

interfaccia google.maps.places.PlaceResult

Definisce le informazioni su un luogo.

Proprietà
address_components facoltativo	Tipo: Array<GeocoderAddressComponent> optional La raccolta di componenti dell'indirizzo per la località di questo luogo. Disponibile solo con PlacesService.getDetails.
adr_address facoltativo	Tipo: string optional La rappresentazione dell'indirizzo del luogo nel microformato adr. Disponibile solo con PlacesService.getDetails.
aspects facoltativo	Tipo: Array<PlaceAspectRating> optional Gli aspetti valutati di questo luogo, in base alle recensioni degli utenti di Google e Zagat. Le valutazioni sono su una scala da 0 a 30.
business_status facoltativo	Tipo: BusinessStatus optional Un flag che indica lo stato operativo del luogo, se si tratta di un'attività (indica se il luogo è operativo o chiuso temporaneamente o definitivamente). Se non sono disponibili dati, il flag non è presente nelle risposte di ricerca o di dettaglio.
formatted_address facoltativo	Tipo: string optional L'indirizzo completo del luogo.
formatted_phone_number facoltativo	Tipo: string optional Il numero di telefono del luogo, formattato in base alla convenzione regionale del numero. Disponibile solo con PlacesService.getDetails.
geometry facoltativo	Tipo: PlaceGeometry optional Informazioni relative alla geometria del luogo.
html_attributions facoltativo	Tipo: Array<string> optional Testo dell'attribuzione da visualizzare per questo risultato di Place. I html_attributions disponibili vengono sempre restituiti indipendentemente dai fields richiesti e devono essere visualizzati.
icon facoltativo	Tipo: string optional URL di una risorsa immagine che può essere utilizzata per rappresentare la categoria di questo luogo.
icon_background_color facoltativo	Tipo: string optional Colore di sfondo da utilizzare con l'icona di un luogo. Vedi anche PlaceResult.icon_mask_base_uri.
icon_mask_base_uri facoltativo	Tipo: string optional Un URL troncato a una maschera di icona. Accedi a diversi tipi di icone aggiungendo un'estensione del file alla fine (ad es. .svg o .png).
international_phone_number facoltativo	Tipo: string optional Il numero di telefono del luogo in formato internazionale. Il formato internazionale include il codice paese ed è preceduto dal segno più (+). Disponibile solo con PlacesService.getDetails.
name facoltativo	Tipo: string optional Il nome del luogo. Nota: nel caso di luoghi inseriti dall'utente, si tratta del testo non elaborato, così come digitato dall'utente. Presta attenzione quando utilizzi questi dati, poiché gli utenti malintenzionati potrebbero tentare di utilizzarli come vettore per attacchi di code injection (vedi http://en.wikipedia.org/wiki/Code_injection).
opening_hours facoltativo	Tipo: PlaceOpeningHours optional Definisce l'orario di apertura o chiusura del luogo.
permanently_closed facoltativo	Deprecato: permanently_closed è deprecato da maggio 2020 e verrà disattivato a maggio 2021. Utilizza PlaceResult.business_status, poiché permanently_closed non distingue tra chiusure temporanee e permanenti. Tipo: boolean optional Un flag che indica se il luogo è chiuso, in modo definitivo o temporaneo. Se il luogo è operativo o se non sono disponibili dati, il flag non è presente nella risposta.
photos facoltativo	Tipo: Array<PlacePhoto> optional Foto di questo luogo. La raccolta conterrà fino a dieci oggetti PlacePhoto.
place_id facoltativo	Tipo: string optional Un identificatore univoco del luogo.
plus_code facoltativo	Tipo: PlacePlusCode optional Definisce i codici Open Location Code o "Plus Code" per il luogo.
price_level facoltativo	Tipo: number optional Il livello di prezzo del luogo, su una scala da 0 a 4. I livelli dei prezzi vengono interpretati come segue: 0: senza costi 1: economico 2: moderato 3: prezzo elevato 4: molto costoso
rating facoltativo	Tipo: number optional Una valutazione compresa tra 1,0 e 5,0, basata sulle recensioni degli utenti di questo luogo.
reviews facoltativo	Tipo: Array<PlaceReview> optional Un elenco di recensioni di questo luogo. Disponibile solo con PlacesService.getDetails.
types facoltativo	Tipo: Array<string> optional Un array di tipi per questo luogo (ad esempio ["political", "locality"] o ["restaurant", "establishment"]).
url facoltativo	Tipo: string optional URL della pagina Google ufficiale di questo luogo. Si tratta della pagina di proprietà di Google che contiene le migliori informazioni disponibili sul luogo. Disponibile solo con PlacesService.getDetails.
user_ratings_total facoltativo	Tipo: number optional Il numero di valutazioni degli utenti che hanno contribuito alla PlaceResult.rating di questo luogo.
utc_offset facoltativo	Deprecato: utc_offset è deprecato da novembre 2019. Usa invece il descrittore PlaceResult.utc_offset_minutes. Visita la pagina https://goo.gle/js-open-now Tipo: number optional L'offset rispetto all'ora UTC del fuso orario corrente del luogo, in minuti. Ad esempio, Sydney, in Australia, con l'ora legale è 11 ore avanti rispetto all'ora UTC, quindi utc_offset sarà 660. Per i fusi orari precedenti all'UTC, l'offset è negativo. Ad esempio, il utc_offset è -60 per Capo Verde. Disponibile solo con PlacesService.getDetails.
utc_offset_minutes facoltativo	Tipo: number optional L'offset rispetto all'ora UTC del fuso orario corrente del luogo, in minuti. Ad esempio, Sydney, in Australia, con l'ora legale è 11 ore avanti rispetto all'ora UTC, quindi utc_offset_minutes sarà 660. Per i fusi orari precedenti all'UTC, l'offset è negativo. Ad esempio, il utc_offset_minutes è -60 per Capo Verde. Disponibile solo con PlacesService.getDetails.
vicinity facoltativo	Tipo: string optional L'indirizzo semplificato del luogo, inclusi il nome della via, il numero civico e la località, ma non la provincia/lo stato, il codice postale o il paese. Ad esempio, l'ufficio di Google a Sydney, in Australia, ha un valore di vicinanza pari a "48 Pirrama Road, Pyrmont". Disponibile solo con PlacesService.getDetails.
website facoltativo	Tipo: string optional Il sito web autorevole per questo luogo, ad esempio la home page di un'attività. Disponibile solo con PlacesService.getDetails.

Interfaccia PlaceAspectRating

interfaccia google.maps.places.PlaceAspectRating

Deprecata: questa interfaccia non è più utilizzata.

Definisce le informazioni su un aspetto del luogo che gli utenti hanno recensito.

Proprietà
rating	Tipo: number La valutazione di questo aspetto. Per le singole recensioni, si tratta di un numero intero compreso tra 0 e 3. Per le valutazioni aggregate di un luogo, si tratta di un numero intero compreso tra 0 e 30.
type	Tipo: string Il tipo di aspetto. Ad esempio, "food", "decor", "service" o "overall".

Costanti BusinessStatus

constants google.maps.places.BusinessStatus
library "places"

Stato dell'attività per il luogo. Per saperne di più, consulta la documentazione del servizio web.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo BusinessStatusString.

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

Costanti
CLOSED_PERMANENTLY	L'attività è chiusa definitivamente. Per saperne di più, consulta la documentazione del servizio web.
CLOSED_TEMPORARILY	L'attività è chiusa temporaneamente. Per saperne di più, consulta la documentazione del servizio web.
FUTURE_OPENING	L'attività aprirà in futuro. Per saperne di più, consulta la documentazione del servizio web.
OPERATIONAL	L'attività è operativa, non necessariamente aperta al momento. Per saperne di più, consulta la documentazione del servizio web.

Interfaccia PlaceGeometry

interfaccia google.maps.places.PlaceGeometry

Definisce le informazioni sulla geometria di un luogo.

Proprietà
location facoltativo	Tipo: LatLng optional La posizione del luogo.
viewport facoltativo	Tipo: LatLngBounds optional L'area visibile preferita quando questo luogo viene visualizzato su una mappa. Questa proprietà sarà null se l'area visibile preferita per il luogo non è nota. Disponibile solo con PlacesService.getDetails.

Interfaccia PlaceOpeningHours

interfaccia google.maps.places.PlaceOpeningHours

Definisce le informazioni sull'orario di apertura di un luogo.

Proprietà
open_now facoltativo	Deprecato: open_now è deprecato da novembre 2019. Utilizza invece il metodo PlaceOpeningHours.isOpen da un risultato PlacesService.getDetails. Visita la pagina https://goo.gle/js-open-now Tipo: boolean optional Indica se il luogo è aperto al momento.
periods facoltativo	Tipo: Array<PlaceOpeningHoursPeriod> optional Periodi di apertura per ogni giorno della settimana, a partire dalla domenica, in ordine cronologico. I giorni in cui il luogo non è aperto non sono inclusi. Disponibile solo con PlacesService.getDetails.
weekday_text facoltativo	Tipo: Array<string> optional Un array di sette stringhe che rappresentano l'orario di apertura formattato per ogni giorno della settimana. Il servizio Places formatterà e localizzerà l'orario di apertura in modo appropriato per la lingua corrente. L'ordine degli elementi in questo array dipende dalla lingua. In alcune lingue la settimana inizia di lunedì, mentre in altre inizia di domenica. Disponibile solo con PlacesService.getDetails. Altre chiamate potrebbero restituire un array vuoto.

Metodi

isOpen

isOpen([date]) Parametri: date: Date optional Valore restituito: boolean|undefined Controlla se il luogo è aperto ora (se non viene passata alcuna data) o alla data specificata. Se questo luogo non ha PlaceResult.utc_offset_minutes o PlaceOpeningHours.periods, viene restituito undefined (PlaceOpeningHours.periods è disponibile solo tramite PlacesService.getDetails). Questo metodo non prende in considerazione gli orari eccezionali, come quelli dei giorni festivi.

Interfaccia PlaceOpeningHoursPeriod

interfaccia google.maps.places.PlaceOpeningHoursPeriod

Definisce informazioni strutturate sull'orario di apertura di un luogo. Nota: se un luogo è sempre aperto, la sezione close non sarà presente nella risposta. I client possono fare affidamento sul fatto che l'apertura continua sia rappresentata come un periodo open contenente day con valore 0 e time con valore "0000", senza close.

Proprietà
open	Tipo: PlaceOpeningHoursTime L'orario di apertura del luogo.
close facoltativo	Tipo: PlaceOpeningHoursTime optional L'orario di chiusura del luogo.

Interfaccia PlaceOpeningHoursTime

interfaccia google.maps.places.PlaceOpeningHoursTime

Definisce quando un luogo apre o chiude.

Proprietà
day	Tipo: number I giorni della settimana, come numero nell'intervallo [0, 6], a partire da domenica. Ad esempio, 2 indica martedì.
hours	Tipo: number Le ore di PlaceOpeningHoursTime.time come numero, nell'intervallo [0, 23]. Verranno riportate nel fuso orario del luogo.
minutes	Tipo: number I minuti di PlaceOpeningHoursTime.time come numero, nell'intervallo [0, 59]. Verranno indicati nel fuso orario del luogo.
time	Tipo: string L'ora del giorno nel formato 24 ore "hhmm". I valori sono compresi nell'intervallo ["0000", "2359"]. L'ora verrà indicata nel fuso orario del luogo.
nextDate facoltativo	Tipo: number optional Il timestamp (in millisecondi dall'epoca, adatto per l'utilizzo con new Date()) che rappresenta la prossima occorrenza di questo PlaceOpeningHoursTime. Viene calcolato in base al PlaceOpeningHoursTime.day della settimana, al PlaceOpeningHoursTime.time e al PlaceResult.utc_offset_minutes. Se PlaceResult.utc_offset_minutes è undefined, nextDate sarà undefined.

Interfaccia PlacePlusCode

interfaccia google.maps.places.PlacePlusCode

Definisce i codici Open Location Code o "Plus Code" per un luogo. I Plus Code possono essere utilizzati in sostituzione degli indirizzi nei luoghi in cui non esistono (dove gli edifici non sono numerati o le strade non hanno un nome).

Proprietà
global_code	Tipo: string Un Plus Code con un'area di 1/8000 di grado per 1/8000 di grado. Ad esempio, "8FVC9G8F+5W".
compound_code facoltativo	Tipo: string optional Un plus code con un'area di 1/8000 di grado per 1/8000 di grado in cui i primi quattro caratteri (il prefisso) vengono eliminati e sostituiti con una descrizione della località. Ad esempio, "9G8F+5W Zurich, Switzerland". Se non è possibile trovare una località adatta per abbreviare il codice, questo campo viene omesso.

Interfaccia PlacePhoto

interfaccia google.maps.places.PlacePhoto

Rappresenta un elemento foto di un luogo.

Proprietà
height	Tipo: number L'altezza della foto in pixel.
html_attributions	Tipo: Array<string> Testo dell'attribuzione da visualizzare per questa foto.
width	Tipo: number La larghezza della foto in pixel.

Metodi
getUrl	getUrl([opts]) Parametri: opts: PhotoOptions optional Valore restituito: string Restituisce l'URL dell'immagine corrispondente alle opzioni specificate.

Interfaccia PhotoOptions

interfaccia google.maps.places.PhotoOptions

Definisce le opzioni di richiesta di foto.

Proprietà
maxHeight facoltativo	Tipo: number optional L'altezza massima in pixel dell'immagine restituita.
maxWidth facoltativo	Tipo: number optional La larghezza massima in pixel dell'immagine restituita.

Interfaccia PlaceReview

interfaccia google.maps.places.PlaceReview

Rappresenta una singola recensione di un luogo.

Proprietà
author_name	Tipo: string Il nome del recensore.
language	Tipo: string Un codice lingua IETF che indica la lingua in cui è scritta la recensione. Tieni presente che questo codice include solo il tag della lingua principale, senza tag secondari che indicano il paese o la regione. Ad esempio, tutte le recensioni in inglese sono taggate come 'en' anziché "en-AU" o "en-UK".
profile_photo_url	Tipo: string Un URL all'immagine del profilo del recensore.
relative_time_description	Tipo: string Una stringa di tempo recente formattata, che esprime l'ora della recensione rispetto all'ora corrente in un formato appropriato per la lingua e il paese. Ad esempio "a month ago".
text	Tipo: string Il testo di una recensione.
time	Tipo: number Timestamp della recensione, espresso in secondi trascorsi da epoca.
aspects facoltativo	Ritirato: questo campo non è più disponibile. Tipo: Array<PlaceAspectRating> optional Gli aspetti valutati dalla recensione. Le valutazioni su una scala da 0 a 3.
author_url facoltativo	Tipo: string optional Un URL che rimanda al profilo del recensore. Questo valore sarà undefined quando il profilo del recensore non è disponibile.
rating facoltativo	Tipo: number optional La valutazione di questa recensione, un numero compreso tra 1,0 e 5,0 (inclusi).