PlacesService class
google.maps.places.PlacesService
classe
Contiene metodi correlati alla ricerca di luoghi e al recupero dei dettagli di un luogo.
Accesso chiamando il numero const {PlacesService} = await google.maps.importLibrary("places")
.
Consulta 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 potrebbero essere restituiti più risultati. I PlaceResult passati al callback sono sottoinsiemi di un PlaceResult completo. La tua app può ottenere un PlaceResult più dettagliato per ogni luogo chiamando PlacesService.getDetails e passando PlaceResult.place_id per il luogo desiderato. |
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 potrebbero essere restituiti più risultati. I PlaceResult passati al callback sono sottoinsiemi di un PlaceResult completo. La tua app può ottenere un PlaceResult più dettagliato per ogni luogo chiamando PlacesService.getDetails e passando PlaceResult.place_id per il luogo desiderato. |
getDetails |
getDetails(request, callback) Parametri:
Valore restituito:nessuno
Recupera i dettagli sul luogo identificato dal placeId specificato. |
nearbySearch |
nearbySearch(request, callback) Parametri:
Valore restituito:nessuno
Recupera un elenco di luoghi vicini a una determinata posizione, in base alla parola chiave o al tipo. La località deve essere sempre specificata, passando un LatLngBounds o i parametri 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 Place Details che passa l'PlaceResult.place_id per il luogo desiderato. L'oggetto PlaceSearchPagination può essere utilizzato per recuperare pagine aggiuntive di risultati (null 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 New York" o "negozi di scarpe vicino a Ottawa"). I parametri di località sono facoltativi; quando la località è specificata, i risultati sono orientati solo verso quelli nelle vicinanze anziché limitati ai luoghi all'interno dell'area. Utilizza textSearch quando vuoi cercare luoghi utilizzando una stringa arbitraria e nei casi in cui potresti non voler limitare i risultati di ricerca a una località specifica. L'oggetto PlaceSearchPagination può essere utilizzato per recuperare pagine aggiuntive di risultati (null se questa è l'ultima pagina di risultati o se è presente una sola pagina di risultati). |
Interfaccia PlaceDetailsRequest
google.maps.places.PlaceDetailsRequest
interfaccia
Una query Place Details da inviare a PlacesService
.
Proprietà | |
---|---|
placeId |
Tipo:
string L'ID luogo del luogo per il quale vengono richiesti i dettagli. |
fields optional |
Tipo:
Array<string> optional Campi da includere nella risposta dei dettagli, per i quali verrà addebitato un costo. Se non vengono specificati campi o viene passato ['ALL'] , verranno restituiti e fatturati tutti i campi disponibili (questa operazione non è consigliata per le implementazioni di produzione). Per un elenco dei campi, vedi PlaceResult . I campi nidificati possono essere specificati con percorsi con punti (ad esempio "geometry.location" ). |
language optional |
Tipo:
string optional Un identificatore di lingua per la lingua in cui devono essere restituiti i dettagli. Consulta l'elenco delle lingue supportate. |
region optional |
Tipo:
string optional Un codice regione della regione dell'utente. Ciò può influire sulle foto che potrebbero essere restituite e, possibilmente, su altre cose. Il codice regione accetta un valore di due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD nazionale 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 optional |
Tipo:
AutocompleteSessionToken optional Riferimento univoco utilizzato per raggruppare la richiesta di dettagli con una sessione Autocomplete. |
Interfaccia FindPlaceFromPhoneNumberRequest
google.maps.places.FindPlaceFromPhoneNumberRequest
interfaccia
Una richiesta di ricerca di un luogo 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 le implementazioni di produzione). Per un elenco dei campi, vedi 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 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 Il bias utilizzato durante la ricerca del luogo. Il risultato sarà orientato verso, ma non limitato a, LocationBias specificato. |
Interfaccia FindPlaceFromQueryRequest
google.maps.places.FindPlaceFromQueryRequest
interfaccia
Una richiesta di ricerca di un luogo 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 le implementazioni di produzione). Per un elenco dei campi, vedi 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 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 Il bias utilizzato durante la ricerca del luogo. Il risultato sarà orientato verso, ma non limitato a, 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. Se bounds è impostato, sia location che radius verranno ignorati. |
keyword optional |
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 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. |
location optional |
Tipo:
LatLng|LatLngLiteral optional La posizione intorno alla quale cercare i luoghi. |
maxPriceLevel optional |
Tipo:
number optional Limita i risultati ai soli 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. Se specificato, deve essere maggiore o uguale a minPrice . |
minPriceLevel optional |
Tipo:
number optional Limita i risultati ai soli 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. Se specificato, deve essere inferiore o uguale a maxPrice . |
|
Tipo:
string optional Equivalente a keyword . I valori in questo campo vengono combinati con i valori nel campo keyword e passati come parte della stessa stringa di ricerca. |
openNow optional |
Tipo:
boolean optional Limita i risultati ai soli luoghi aperti in questo momento. |
radius optional |
Tipo:
number optional La distanza dalla posizione specificata entro la quale cercare i luoghi, in metri. Il valore massimo consentito è 50.000. |
rankBy optional |
Tipo:
RankBy optional Predefinito:
RankBy.PROMINENCE Specifica il metodo di classificazione 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à target 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 categoriche indipendenti dalla lingua e dalla regione. I tipi validi sono indicati qui. |
TextSearchRequest interfaccia
google.maps.places.TextSearchRequest
interfaccia
Una richiesta di ricerca testuale da inviare a PlacesService
.
Proprietà | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Confini utilizzati per orientare i risultati durante la ricerca di luoghi (facoltativo). Se bounds è impostato, sia location che radius verranno ignorati. I risultati non saranno limitati a quelli all'interno di questi limiti, ma quelli al loro interno avranno un ranking più alto. |
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. |
location optional |
Tipo:
LatLng|LatLngLiteral optional Il centro dell'area utilizzata per orientare i risultati durante la ricerca di 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 disambiguatore di località ("Starbucks a Sydney"). |
radius optional |
Tipo:
number optional Il raggio dell'area utilizzata per orientare i risultati durante la ricerca di luoghi, in metri. |
region optional |
Tipo:
string optional Un codice regione per orientare i risultati. Il codice regione accetta un valore di due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD nazionale 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 optional |
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 localizzata. I risultati di un tipo diverso vengono eliminati dalla risposta. Utilizza questo campo per eseguire ricerche categoriche indipendenti dalla lingua e dalla regione. I tipi validi sono indicati qui. |
RankBy costanti
google.maps.places.RankBy
costanti
Opzioni di classificazione per una PlaceSearchRequest.
Accesso chiamando il numero const {RankBy} = await google.maps.importLibrary("places")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
DISTANCE |
Classifica i risultati dei luoghi in base alla distanza dalla posizione. |
PROMINENCE |
Classifica i risultati dei luoghi in base alla loro evidenza. |
LocationBias typedef
google.maps.places.LocationBias
typedef
Un LocationBias rappresenta un limite o un suggerimento da utilizzare durante la ricerca di luoghi. I risultati potrebbero provenire da aree esterne a quella specificata. Per utilizzare l'indirizzo IP dell'utente corrente come bias, è possibile specificare la stringa "IP_BIAS"
. Nota: se utilizzi un Circle
, devono essere definiti il centro e il raggio.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
LocationRestriction rappresenta un limite rigoroso da utilizzare durante la ricerca di luoghi.
Costanti PlacesServiceStatus
google.maps.places.PlacesServiceStatus
costanti
Lo stato restituito da PlacesService
al termine delle ricerche. Specificali per valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.places.PlacesServiceStatus.OK
Accesso chiamando il numero const {PlacesServiceStatus} = await google.maps.importLibrary("places")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
INVALID_REQUEST |
Questa 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 |
La richiesta PlacesService non può essere elaborata a causa di un errore del server. Se riprovi, la richiesta potrebbe andare a buon fine. |
ZERO_RESULTS |
Nessun risultato 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 quando è presente una pagina dei risultati aggiuntiva. |
Metodi | |
---|---|
nextPage |
nextPage() Parametri: nessuno
Valore restituito:
void Recupera la pagina successiva dei risultati. 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 punteggi sono su una scala da 0 a 30. |
business_status optional |
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 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 Informazioni relative alla geometria del luogo. |
html_attributions optional |
Tipo:
Array<string> optional Testo di attribuzione da visualizzare per questo risultato di Place. I html_attributions disponibili vengono sempre restituiti indipendentemente dai fields 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 di una maschera dell'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 codice paese 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, in quanto gli utenti malintenzionati potrebbero tentare di utilizzarli 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, in modo definitivo o temporaneo. Se il luogo è operativo o se non sono disponibili dati, il flag 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 di 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 e 5, basata sulle recensioni degli utenti di questo luogo. |
reviews optional |
Tipo:
Array<PlaceReview> optional Un elenco delle 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 Google ufficiale di 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 al fuso orario UTC del fuso orario attuale 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 precedenti all'UTC, l'offset è negativo. Ad esempio, il utc_offset è -60 per Capo Verde. Disponibile solo con PlacesService.getDetails . |
utc_offset_minutes optional |
Tipo:
number optional La differenza rispetto al fuso orario UTC del fuso orario attuale 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 precedenti all'UTC, l'offset è negativo. Ad esempio, il utc_offset_minutes è -60 per Capo Verde. Disponibile solo con PlacesService.getDetails . |
vicinity optional |
Tipo:
string optional L'indirizzo semplificato del luogo, inclusi nome della via, numero civico e località, ma non provincia/stato, codice postale o paese. Ad esempio, la sede 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 operativo del luogo, se si tratta di un'attività, restituito in un PlaceResult (indica se il luogo è operativo o chiuso temporaneamente o definitivamente). Specificali per valore o per nome della costante (ad esempio, 'OPERATIONAL'
o google.maps.places.BusinessStatus.OPERATIONAL
).
Accesso chiamando il numero const {BusinessStatus} = await google.maps.importLibrary("places")
.
Consulta Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
CLOSED_PERMANENTLY |
L'attività è chiusa definitivamente. |
CLOSED_TEMPORARILY |
L'attività è chiusa temporaneamente. |
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 il viewport preferito per il luogo non è noto. Disponibile solo con PlacesService.getDetails . |
Interfaccia PlaceOpeningHours
google.maps.places.PlaceOpeningHours
interfaccia
Definisce le informazioni sull'orario 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 l'orario di apertura formattato per ogni giorno della settimana. Il servizio Places formatta e localizza l'orario di apertura in modo appropriato per la lingua corrente. L'ordine degli elementi in questo array dipende dalla lingua. Alcune lingue iniziano la settimana di lunedì, mentre altre 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 (quando non è stata indicata alcuna data) o nella 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 orari eccezionali, come gli orari festivi. |
Interfaccia PlaceOpeningHoursPeriod
google.maps.places.PlaceOpeningHoursPeriod
interfaccia
Definisce le 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 sulla rappresentazione di sempre aperto come 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 PlaceOpeningHoursTime.time come numero, nell'intervallo [0 , 23 ]. Verranno indicate nel fuso orario del luogo. |
minutes |
Tipo:
number I minuti delle PlaceOpeningHoursTime.time come numero, nell'intervallo [0 , 59 ]. Verranno riportati nel fuso orario del luogo. |
time |
Tipo:
string L'ora del giorno nel formato "hhmm" a 24 ore. I valori sono compresi nell'intervallo [ "0000" , "2359" ]. L'ora verrà indicata nel fuso orario del luogo. |
nextDate optional |
Tipo:
number optional Il timestamp (in millisecondi dall'epoca, adatto all'uso 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 , allora nextDate sarà undefined . |
Interfaccia PlacePlusCode
google.maps.places.PlacePlusCode
interfaccia
Definisce i codici di posizione aperti o "plus code" per un luogo. I Plus Code possono essere utilizzati in sostituzione degli indirizzi stradali 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 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 viene trovata 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 questa 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 taggate come 'en' anziché "en-AU" o "en-UK". |
profile_photo_url |
Tipo:
string Un URL che rimanda all'immagine del profilo dell'autore della recensione. |
relative_time_description |
Tipo:
string Una stringa di tempo recente formattato, che esprime l'ora della recensione rispetto all'ora attuale 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. |
|
Tipo:
Array<PlaceAspectRating> optional Gli aspetti valutati dalla recensione. I rating su una scala da 0 a 3. |
author_url optional |
Tipo:
string optional Un URL al profilo del recensore. Questo 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). |