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 esegue il rendering delle 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, 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. |
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 un PlaceResult più dettagliato per ogni luogo inviando una richiesta Places Details passando il PlaceResult.place_id per il luogo desiderato. 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). |
textSearch |
textSearch(request, callback) Parametri:
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 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
google.maps.places.PlaceDetailsRequest
interfaccia
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 con puntini (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 Un codice della regione dell'utente. Ciò può influire sulle foto che possono essere restituite e su altri elementi. 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 notevoli. Ad esempio, il TLD di primo livello 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, per i quali verrà addebitato un costo. 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" ). |
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 bias utilizzato per la ricerca di un luogo. Il risultato sarà orientato verso, ma non limitato a, il LocationBias specificato. |
Interfaccia FindPlaceFromQueryRequest
google.maps.places.FindPlaceFromQueryRequest
interfaccia
Una richiesta di ricerca di luoghi da testo da inviare a PlacesService.findPlaceFromQuery
.
Proprietà | |
---|---|
fields |
Tipo:
Array<string> Campi da includere nella risposta, per i quali verrà addebitato un costo. 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 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 bias utilizzato per la ricerca di un luogo. Il risultato sarà orientato verso, ma non limitato a, il LocationBias specificato. |
Interfaccia PlaceSearchRequest
google.maps.places.PlaceSearchRequest
interfaccia
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 inferiore 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 Valore predefinito:
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 un 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
google.maps.places.TextSearchRequest
interfaccia
Una richiesta di ricerca di testo da inviare a PlacesService
.
Proprietà | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Limiti utilizzati per orientare i risultati quando cerchi luoghi (facoltativo). Sia location che radius verranno ignorati se è impostato bounds . 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 si cercano 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 da un elemento di disambiguazione 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 notevoli. Ad esempio, il TLD di primo livello 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 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. |
Costanti RankBy
google.maps.places.RankBy
costanti
Opzioni di ranking per una richiesta PlaceSearchRequest.
Accedi chiamando const {RankBy} = await google.maps.importLibrary("places")
. Consulta la sezione 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 restrizione di località rappresenta un confine rigoroso da utilizzare quando cerchi 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 a cui si fa 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 |
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
google.maps.places.PlaceSearchPagination
interfaccia
Un oggetto utilizzato per recuperare pagine aggiuntive 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:nessuno
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. Le valutazioni sono su una scala da 0 a 30. |
business_status optional |
Tipo:
BusinessStatus optional Un indicatore che indica lo stato di operatività del 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 di icone. 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 codice paese ed è preceduto dal segno più (+). Disponibile solo con PlacesService.getDetails . |
name optional |
Tipo:
string optional Il nome del luogo. Nota: nel caso dei luoghi inseriti dall'utente, si tratta del testo non elaborato, così come digitato dall'utente. Fai attenzione quando utilizzi questi dati, in quanto utenti malintenzionati potrebbero tentare di utilizzarli come vettore per attacchi di Iniezione di codice (vedi http://it.wikipedia.org/wiki/Iniezione_di_codice). |
opening_hours optional |
Tipo:
PlaceOpeningHours optional Definisce quando il luogo apre o chiude. |
|
Tipo:
boolean optional Un indicatore 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 la visualizzazione 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 che coprono ogni giorno della settimana, a partire da 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. 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:
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 la modalità sempre aperta sia rappresentata da un periodo open
contenente day
con valore 0
e time
con valore "0000"
e nessun close
.
Proprietà | |
---|---|
open |
Tipo:
PlaceOpeningHoursTime L'orario di apertura del luogo. |
close optional |
Tipo:
PlaceOpeningHoursTime optional L'orario di chiusura del 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 del giorno PlaceOpeningHoursTime.time come numero, nell'intervallo [0 , 23 ]. Questo valore 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 giorno PlaceOpeningHoursTime.day della settimana, dal giorno PlaceOpeningHoursTime.time e dal giorno PlaceResult.utc_offset_minutes . Se PlaceResult.utc_offset_minutes è undefined , nextDate sarà undefined . |
Interfaccia PlacePlusCode
google.maps.places.PlacePlusCode
interfaccia
Definisce i codici posizione aperti o "plus code" per un luogo. I Plus Code possono essere utilizzati al posto degli indirizzi civici 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 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 prefisso) 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 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 del recensore. |
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. Il valore sarà undefined quando il profilo del recensore non è disponibile. |
rating optional |
Tipo:
number optional La valutazione di questa recensione, un numero compreso tra 1,0 e 5,0 (inclusi). |