Classe PlacesService
google.maps.places.PlacesService
corso
Contiene metodi relativi alla ricerca di luoghi e al recupero dei dettagli di un luogo.
Accedi chiamando const {PlacesService} = await google.maps.importLibrary("places")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costruttore | |
---|---|
PlacesService |
PlacesService(attrContainer) Parametri:
Crea una nuova istanza di PlacesService che mostra le attribuzioni nel contenitore specificato. |
Metodi | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parametri:
Valore restituito: nessuno
Recupera un elenco di luoghi in base a un numero di telefono. Nella maggior parte dei casi, nell'elenco dei risultati dovrebbe essere presente un solo elemento, ma se la richiesta è ambigua, è possibile che vengano restituiti più risultati. I PlaceResult passati al callback sono sottoinsiemi di un PlaceResult completo. L'app può ottenere un PlaceResult più dettagliato per ogni luogo chiamando PlacesService.getDetails e passando il PlaceResult.place_id per la località desiderata. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parametri:
Valore restituito: nessuno
Recupera un elenco di luoghi in base a una stringa di query. Nella maggior parte dei casi dovrebbe essere presente un solo elemento nell'elenco dei risultati, ma se la richiesta è ambigua potrebbe essere restituito più di un risultato. I PlaceResult passati al callback sono sottoinsiemi di un PlaceResult completo. L'app può ottenere un PlaceResult più dettagliato per ogni luogo chiamando PlacesService.getDetails e passando il PlaceResult.place_id per la località desiderata. |
getDetails |
getDetails(request, callback) Parametri:
Valore restituito: nessuno
Recupera i dettagli del luogo identificato dal placeId specificato. |
nearbySearch |
nearbySearch(request, callback) Parametri:
Valore restituito: nessuno
Recupera un elenco di luoghi nelle vicinanze di una determinata località, in base alla parola chiave o al tipo. La località deve sempre essere specificata, passando un parametro LatLngBounds o location e radius . I PlaceResult passati al callback sono sottoinsiemi del PlaceResult completo. La tua app può ottenere una PlaceResult più dettagliata per ogni luogo inviando una richiesta Place Details con la trasmissione del PlaceResult.place_id per il luogo desiderato. L'oggetto PlaceSearchPagination può essere utilizzato per recuperare altre pagine di risultati (nullo se questa è l'ultima pagina di risultati o se è presente una sola pagina di risultati). |
textSearch |
textSearch(request, callback) Parametri:
Valore restituito: nessuno
Recupera un elenco di luoghi in base a una stringa di query (ad esempio, "pizza a Roma" o "negozi di scarpe vicino a Roma"). I parametri posizione sono facoltativi; quando la posizione è specificata, i risultati sono orientati solo 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 determinata località. L'oggetto PlaceSearchPagination può essere utilizzato per recuperare altre pagine di risultati (null se si tratta dell'ultima pagina di risultati o se esiste una sola pagina di risultati). |
Interfaccia PlaceDetailsRequest
Interfaccia google.maps.places.PlaceDetailsRequest
Una query sui dettagli dei luoghi da inviare a PlacesService
.
Proprietà | |
---|---|
placeId |
Tipo:
string L'ID luogo per cui vengono richiesti i dettagli. |
fields optional |
Tipo:
Array<string> optional Campi da includere nella risposta ai dettagli, per i quali verrà addebitato un importo. Se non vengono specificati campi o viene passato ['ALL'] , verranno restituiti e fatturati tutti i campi disponibili (questa operazione non è consigliata per i deployment di produzione). Per un elenco dei campi, consulta PlaceResult . I campi nidificati possono essere specificati con percorsi di punti (ad esempio, "geometry.location" ). |
language optional |
Tipo:
string optional Un identificatore della lingua in cui devono essere restituiti i dettagli. Consulta l'elenco delle lingue supportate. |
region optional |
Tipo:
string optional Il codice della regione dell'utente. Ciò può influire sulle foto che possono essere restituite ed eventualmente su altri aspetti. Il codice regione accetta un valore di due caratteri di ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk" ( .co.uk ), mentre il codice ISO 3166-1 è "gb" (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord"). |
sessionToken optional |
Tipo:
AutocompleteSessionToken optional Riferimento univoco utilizzato per raggruppare la richiesta di dettagli con una sessione di completamento automatico. |
Interfaccia FindPlaceFromPhoneNumberRequest
google.maps.places.FindPlaceFromPhoneNumberRequest
interfaccia
Una richiesta di ricerca di luoghi da testo da inviare a PlacesService.findPlaceFromPhoneNumber
.
Proprietà | |
---|---|
fields |
Tipo:
Array<string> Campi da includere nella risposta, che verranno addebitati. Se viene trasmesso ['ALL'] , tutti i campi disponibili verranno restituiti e fatturati (questa operazione non è consigliata per i deployment di produzione). Per un elenco dei campi, consulta PlaceResult . I campi nidificati possono essere specificati con percorsi di punti (ad esempio, "geometry.location" ). |
phoneNumber |
Tipo:
string Il numero di telefono del luogo da cercare. Il formato deve essere E.164. |
language optional |
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 optional |
Tipo:
LocationBias optional La differenziazione utilizzata per la ricerca di luogo. Il risultato sarà orientato verso, ma non limitato a, il LocationBias specificato. |
Interfaccia FindPlaceFromQueryRequest
Interfaccia google.maps.places.FindPlaceFromQueryRequest
Un campo Trova luogo da una richiesta di ricerca testuale da inviare a PlacesService.findPlaceFromQuery
.
Proprietà | |
---|---|
fields |
Tipo:
Array<string> Campi da includere nella risposta, che verranno addebitati. Se viene passato ['ALL'] , verranno restituiti e fatturati tutti i campi disponibili (questa operazione non è consigliata per i deployment di produzione). Per un elenco dei campi, consulta PlaceResult . I campi nidificati possono essere specificati con percorsi con puntini (ad esempio "geometry.location" ). |
query |
Tipo:
string La query della richiesta. Ad esempio, il nome o l'indirizzo di un luogo. |
language optional |
Tipo:
string optional Un identificatore di lingua per la lingua in cui devono essere restituiti nomi e indirizzi, se possibile. Consulta l'elenco delle lingue supportate. |
locationBias optional |
Tipo:
LocationBias optional La differenziazione utilizzata per la ricerca di luogo. Il risultato sarà orientato verso, ma non limitato a, il LocationBias specificato. |
Interfaccia PlaceSearchRequest
Interfaccia google.maps.places.PlaceSearchRequest
Una query di ricerca di luoghi da inviare a PlacesService
.
Proprietà | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional I limiti entro i quali cercare i luoghi. Sia location che radius verranno ignorati se è impostato bounds . |
keyword optional |
Tipo:
string optional Un termine da associare a tutti i campi disponibili, inclusi, a titolo esemplificativo, nome, tipo e indirizzo, nonché recensioni dei clienti e altri contenuti di terze parti. |
language optional |
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 optional |
Tipo:
LatLng|LatLngLiteral optional La posizione intorno alla quale cercare i luoghi. |
maxPriceLevel optional |
Tipo:
number optional Limita i risultati solo ai luoghi con il livello di prezzo specificato o inferiore. I valori validi sono compresi tra 0 (il più conveniente) e 4 (il più costoso), inclusi. Deve essere maggiore o uguale a minPrice , se specificato. |
minPriceLevel optional |
Tipo:
number optional Limita i risultati solo ai luoghi con il livello di prezzo specificato o superiore. I valori validi sono compresi tra 0 (il più conveniente) e 4 (il più costoso), inclusi. Deve essere minore o uguale a maxPrice , se specificato. |
|
Tipo:
string optional Equivalente a keyword . I valori in questo campo vengono combinati con i valori nel campo keyword e trasmessi come parte della stessa stringa di ricerca. |
openNow optional |
Tipo:
boolean optional Limita i risultati solo ai luoghi aperti in questo momento. |
radius optional |
Tipo:
number optional La distanza dalla località specificata entro la quale cercare i luoghi, in metri. Il valore massimo consentito è 50.000. |
rankBy optional |
Tipo:
RankBy optional Predefinita:
RankBy.PROMINENCE Specifica il metodo di ranking da utilizzare per restituire i risultati. Tieni presente che quando rankBy è impostato su DISTANCE , devi specificare un location , ma non puoi specificare un radius o bounds . |
type optional |
Tipo:
string optional Cerca luoghi del tipo specificato. Il tipo viene tradotto nella lingua locale della località di destinazione della richiesta e utilizzato come stringa di query. Se viene fornita anche una query, questa viene concatenata alla stringa del tipo localizzata. I risultati di un tipo diverso vengono eliminati dalla risposta. Utilizza questo campo per eseguire ricerche di categorie indipendenti da lingua e regione. I tipi validi sono riportati qui. |
Interfaccia TextSearchRequest
Interfaccia google.maps.places.TextSearchRequest
Una richiesta di ricerca di testo da inviare a PlacesService
.
Proprietà | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Limiti utilizzati per orientare i risultati quando si cercano luoghi (facoltativo). Se bounds è impostato, location e radius verranno ignorati. I risultati non saranno limitati a quelli all'interno di questi limiti, ma i risultati al loro interno avranno un ranking più alto. |
language optional |
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 optional |
Tipo:
LatLng|LatLngLiteral optional Il centro dell'area utilizzata per orientare i risultati quando cerchi luoghi. |
query optional |
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 dal disambiguatore della località ("Starbucks a Sydney"). |
radius optional |
Tipo:
number optional Il raggio dell'area utilizzata per orientare i risultati quando cerchi luoghi, in metri. |
region optional |
Tipo:
string optional Un codice regione da utilizzare come riferimento per i risultati. Il codice regione accetta un valore di due caratteri di ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk" ( .co.uk ), mentre il codice ISO 3166-1 è "gb" (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord"). |
type optional |
Tipo:
string optional Cerca luoghi del tipo specificato. Il tipo viene tradotto nella lingua locale della località di destinazione della richiesta e utilizzato come stringa di query. Se viene fornita anche una query, questa è concatenata alla stringa di tipo localizzato. I risultati di un tipo diverso vengono eliminati dalla risposta. Utilizza questo campo per eseguire ricerche di categorie indipendenti da lingua e regione. I tipi validi sono riportati qui. |
costanti RankBy
Costanti
google.maps.places.RankBy
Opzioni di ranking per una richiesta PlaceSearchRequest.
Accedi chiamando const {RankBy} = await google.maps.importLibrary("places")
. Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
DISTANCE |
Classifica i risultati relativi ai luoghi in base alla distanza dalla località. |
PROMINENCE |
Classifica i risultati in base alla loro evidenza. |
LocationBias typedef
google.maps.places.LocationBias
typedef
Un LocationBias rappresenta un confine o un suggerimento flessibile da utilizzare durante la ricerca di luoghi. I risultati potrebbero provenire dall'esterno dell'area specificata. Per utilizzare l'indirizzo IP dell'utente corrente come bias, è possibile specificare la stringa "IP_BIAS"
. Nota: se utilizzi un Circle
, il centro e il raggio devono essere definiti.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
Una LocationRestriction rappresenta un confine rigoroso da utilizzare durante la ricerca di luoghi.
Costanti PlacesServiceStatus
google.maps.places.PlacesServiceStatus
costanti
Lo stato restituito dal PlacesService
al termine delle ricerche. Specificali in base al valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.places.PlacesServiceStatus.OK
Accedi chiamando const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
INVALID_REQUEST |
Questa richiesta non è valida. |
NOT_FOUND |
Il luogo indicato 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 |
Impossibile elaborare la richiesta PlacesService a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi. |
ZERO_RESULTS |
Nessun risultato è stato trovato per questa richiesta. |
Interfaccia PlaceSearchPagination
Interfaccia google.maps.places.PlaceSearchPagination
Un oggetto utilizzato per recuperare altre pagine di risultati di Places.
Proprietà | |
---|---|
hasNextPage |
Tipo:
boolean Indica se sono disponibili altri risultati. true se è presente un'altra pagina di risultati. |
Metodi | |
---|---|
nextPage |
nextPage() Parametri: nessuno
Valore restituito:
void Recupera la pagina di risultati successiva. Utilizza la stessa funzione di callback fornita alla prima richiesta di ricerca. |
Interfaccia PlaceResult
google.maps.places.PlaceResult
interfaccia
Definisce le informazioni su un luogo.
Proprietà | |
---|---|
address_components optional |
Tipo:
Array<GeocoderAddressComponent> optional La raccolta dei componenti dell'indirizzo per la posizione di questo luogo. Disponibile solo con PlacesService.getDetails . |
adr_address optional |
Tipo:
string optional La rappresentazione dell'indirizzo del luogo nel microformato adr. Disponibile solo con PlacesService.getDetails . |
aspects optional |
Tipo:
Array<PlaceAspectRating> optional Gli aspetti valutati di questo luogo, in base alle recensioni degli utenti di Google e Zagat. I voti sono su una scala da 0 a 30. |
business_status optional |
Tipo:
BusinessStatus optional Una bandiera che indica lo stato di attività di un luogo, se si tratta di un'attività (indica se il luogo è operativo o chiuso temporaneamente o definitivamente). Se non sono disponibili dati, l'indicatore non è presente nelle risposte di ricerca o dei dettagli. |
formatted_address optional |
Tipo:
string optional L'indirizzo completo del luogo. |
formatted_phone_number optional |
Tipo:
string optional Il numero di telefono del luogo, formattato in base alla convenzione regionale del numero. Disponibile solo con PlacesService.getDetails . |
geometry optional |
Tipo:
PlaceGeometry optional Le informazioni relative alla geometria del luogo. |
html_attributions optional |
Tipo:
Array<string> optional Testo dell'attribuzione da visualizzare per questo risultato Luogo. I html_attributions disponibili vengono sempre restituiti, indipendentemente da quali fields sono stati richiesti, e devono essere visualizzati. |
icon optional |
Tipo:
string optional URL di una risorsa immagine che può essere utilizzata per rappresentare la categoria di questo luogo. |
icon_background_color optional |
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 optional |
Tipo:
string optional Un URL troncato a una maschera icona. Accedi a diversi tipi di icone aggiungendo un'estensione di file alla fine (ad es. .svg o .png ). |
international_phone_number optional |
Tipo:
string optional Il numero di telefono del luogo in formato internazionale. Il formato internazionale include il prefisso internazionale ed è preceduto dal segno più (+). Disponibile solo con PlacesService.getDetails . |
name optional |
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 usarli come vettore per attacchi di iniezione di codice (vedi http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
Tipo:
PlaceOpeningHours optional Definisce quando il luogo apre o chiude. |
|
Tipo:
boolean optional Un flag che indica se il luogo è chiuso, definitivamente o temporaneamente. Se il luogo è operativo o se non sono disponibili dati, l'indicatore non è presente nella risposta. |
photos optional |
Tipo:
Array<PlacePhoto> optional Foto di questo luogo. La raccolta conterrà fino a dieci oggetti PlacePhoto . |
place_id optional |
Tipo:
string optional Un identificatore univoco per il luogo. |
plus_code optional |
Tipo:
PlacePlusCode optional Definisce i codici posizione aperti o "plus code" per il luogo. |
price_level optional |
Tipo:
number optional Il livello di prezzo del luogo, su una scala da 0 a 4. I livelli di prezzo vengono interpretati come segue:
|
rating optional |
Tipo:
number optional Una valutazione compresa tra 1,0 e 5,0 in base alle recensioni degli utenti di questo luogo. |
reviews optional |
Tipo:
Array<PlaceReview> optional Un elenco di recensioni di questo luogo. Disponibile solo con PlacesService.getDetails . |
types optional |
Tipo:
Array<string> optional Un array di tipi per questo luogo (ad esempio ["political", "locality"] o ["restaurant", "establishment"] ). |
url optional |
Tipo:
string optional URL della pagina ufficiale di Google per questo luogo. Questa è la pagina di proprietà di Google che contiene le migliori informazioni disponibili sul luogo. Disponibile solo con PlacesService.getDetails . |
user_ratings_total optional |
Tipo:
number optional Il numero di valutazioni degli utenti che hanno contribuito al PlaceResult.rating di questo luogo. |
|
Tipo:
number optional La differenza rispetto a UTC del fuso orario corrente del luogo, in minuti. Ad esempio, Sydney, in Australia, durante l'ora legale è 11 ore avanti rispetto al fuso orario UTC, quindi utc_offset sarà 660 . Per i fusi orari che precedono UTC, l'offset è negativo. Ad esempio, utc_offset è -60 per Capo Verde. Disponibile solo con PlacesService.getDetails . |
utc_offset_minutes optional |
Tipo:
number optional La differenza rispetto a UTC del fuso orario corrente del luogo, in minuti. Ad esempio, Sydney, in Australia, durante l'ora legale è 11 ore avanti rispetto al fuso orario UTC, quindi utc_offset_minutes sarà 660 . Per i fusi orari che precedono UTC, l'offset è negativo. Ad esempio, utc_offset_minutes è -60 per Capo Verde. Disponibile solo con PlacesService.getDetails . |
vicinity optional |
Tipo:
string optional L'indirizzo semplificato del luogo, inclusi il nome della via, il numero civico e la località, ma non la provincia/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 optional |
Tipo:
string optional Il sito web autorevole di questo luogo, ad esempio la home page di un'attività. Disponibile solo con PlacesService.getDetails . |
Interfaccia PlaceAspectRating
google.maps.places.PlaceAspectRating
interfaccia
Definisce le informazioni su un aspetto del luogo recensito dagli utenti.
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
google.maps.places.BusinessStatus
costanti
Lo stato di funzionamento del luogo, se si tratta di un'attività, restituito in un PlaceResult (indica se il luogo è operativo o chiuso temporaneamente o definitivamente). Specifica questi valori in base al valore o al nome della costante (ad esempio 'OPERATIONAL'
o google.maps.places.BusinessStatus.OPERATIONAL
).
Accedi chiamando const {BusinessStatus} = await google.maps.importLibrary("places")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
CLOSED_PERMANENTLY |
L'attività è chiusa definitivamente. |
CLOSED_TEMPORARILY |
L'attività è temporaneamente chiusa. |
OPERATIONAL |
L'attività funziona normalmente. |
Interfaccia PlaceGeometry
google.maps.places.PlaceGeometry
interfaccia
Definisce le informazioni sulla geometria di un luogo.
Proprietà | |
---|---|
location optional |
Tipo:
LatLng optional La posizione del luogo. |
viewport optional |
Tipo:
LatLngBounds optional L'area visibile preferita per la visualizzazione di questo luogo su una mappa. Questa proprietà sarà null se l'area visibile preferita per il luogo non è nota. Disponibile solo con PlacesService.getDetails . |
Interfaccia PlaceOpeningHours
google.maps.places.PlaceOpeningHours
interfaccia
Definisce le informazioni sugli orari di apertura di un luogo.
Proprietà | |
---|---|
|
Tipo:
boolean optional Indica se il luogo è aperto al momento. |
periods optional |
Tipo:
Array<PlaceOpeningHoursPeriod> optional Periodi di apertura relativi a 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 optional |
Tipo:
Array<string> optional Un array di sette stringhe che rappresentano gli orari di apertura formattati per ogni giorno della settimana. Il servizio Places formatta e localizza gli orari di apertura in modo appropriato per la lingua corrente. L'ordine degli elementi in questa matrice dipende dalla lingua. Alcune lingue iniziano la settimana di lunedì, mentre altre iniziano la domenica. Disponibile solo con PlacesService.getDetails . Altre chiamate potrebbero restituire un array vuoto. |
Metodi | |
---|---|
isOpen |
isOpen([date]) Parametri:
Valore restituito:
boolean|undefined Controlla se il luogo è aperto ora (se non è stata specificata una data) o alla data indicata. 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 orari eccezionali, come quelli delle festività. |
Interfaccia PlaceOpeningHoursPeriod
google.maps.places.PlaceOpeningHoursPeriod
interfaccia
Definisce informazioni strutturate sugli orari di apertura di un luogo. Nota: se un luogo è sempre aperto, la sezione close
non sarà presente nella risposta. I clienti possono fare affidamento sul fatto che lo stato sempre aperto sia rappresentato come un periodo open
contenente day
con valore 0
e time
con valore "0000"
e nessun close
.
Proprietà | |
---|---|
open |
Tipo:
PlaceOpeningHoursTime L'orario di apertura di questo luogo. |
close optional |
Tipo:
PlaceOpeningHoursTime optional L'orario di chiusura di questo luogo. |
Interfaccia PlaceOpeningHoursTime
google.maps.places.PlaceOpeningHoursTime
interfaccia
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 significa martedì. |
hours |
Tipo:
number Le ore di PlaceOpeningHoursTime.time in formato numero, nell'intervallo [0 , 23 ]. Questo verrà riportato nel fuso orario del luogo. |
minutes |
Tipo:
number I minuti del PlaceOpeningHoursTime.time come numero, nell'intervallo [0 , 59 ]. Il valore verrà riportato nel fuso orario del luogo. |
time |
Tipo:
string L'ora del giorno nel formato 24 ore "hhmm". I valori devono essere compresi nell'intervallo [ "0000" , "2359" ]. L'ora verrà registrata nel fuso orario del luogo. |
nextDate optional |
Tipo:
number optional Il timestamp (in millisecondi dall'epoca, adatto per l'utilizzo con new Date() ) che rappresenta la successiva occorrenza di questo valore PlaceOpeningHoursTime. Si calcola dal PlaceOpeningHoursTime.day della settimana, dal PlaceOpeningHoursTime.time e dal PlaceResult.utc_offset_minutes . Se il valore di PlaceResult.utc_offset_minutes è undefined , il valore di nextDate sarà undefined . |
Interfaccia PlacePlusCode
Interfaccia google.maps.places.PlacePlusCode
Definisce i codici posizione aperti o "plus code" per un luogo. I plus code possono essere utilizzati in sostituzione degli indirizzi stradali in luoghi in cui non sono presenti (ovvero, in cui gli edifici non sono numerati o le strade non sono denominate).
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 optional |
Tipo:
string optional Un codice Plus con un'area di 1/8000 di grado per 1/8000 di grado in cui i primi quattro caratteri (il codice area) vengono omessi 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
google.maps.places.PlacePhoto
interfaccia
Rappresenta un elemento fotografico 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:
Valore restituito:
string Restituisce l'URL dell'immagine corrispondente alle opzioni specificate. |
Interfaccia PhotoOptions
google.maps.places.PhotoOptions
interfaccia
Definisce le opzioni di richiesta di foto.
Proprietà | |
---|---|
maxHeight optional |
Tipo:
number optional L'altezza massima in pixel dell'immagine restituita. |
maxWidth optional |
Tipo:
number optional La larghezza massima in pixel dell'immagine restituita. |
Interfaccia PlaceReview
google.maps.places.PlaceReview
interfaccia
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 alcun tag secondario che indichi il paese o la regione. Ad esempio, tutte le recensioni in inglese sono contrassegnate come 'en' anziché "en-AU" o "en-UK". |
profile_photo_url |
Tipo:
string Un URL che rimanda all'immagine del profilo dell'utente di aggiornamento. |
relative_time_description |
Tipo:
string Una stringa di ora recente formattata, che esprime l'ora della recensione rispetto all'ora corrente in una forma appropriata per la lingua e il paese. Ad esempio "a month ago" . |
text |
Tipo:
string Il testo di una recensione. |
time |
Tipo:
number Timestamp della revisione, espresso in secondi dall'epoca. |
|
Tipo:
Array<PlaceAspectRating> optional Gli aspetti valutati dalla recensione. Le valutazioni su una scala da 0 a 3. |
author_url optional |
Tipo:
string optional Un URL che rimanda al profilo del recensore. Se il profilo del recensore non è disponibile, sarà undefined . |
rating optional |
Tipo:
number optional La valutazione di questa recensione, un numero compreso tra 1,0 e 5,0 (inclusi). |