Classe PlacesService
lezione google.maps.places.PlacesService
Contiene metodi relativi alla ricerca di luoghi e al recupero di dettagli su un luogo.
Carica utilizzando il parametro URL &libraries=places
. Consulta la sezione Librerie nell'API Maps JavaScript.
Quando usi v=beta
, puoi accedervi chiamando const {PlacesService} = await google.map.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 container specificato. |
Metodi | |
---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request, callback) Parametri:
Valore di restituzione: nessuno
Recupera un elenco di luoghi in base a un numero di telefono. Nella maggior parte dei casi, dovrebbe essere presente un solo elemento nell'elenco dei risultati, ma se la richiesta è ambigua, è possibile che venga restituito più di un risultato. I PlaceResult trasferiti 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 il PlaceResult.place_id per il luogo desiderato. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parametri:
Valore di restituzione: 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, è possibile che venga restituito più di un risultato. I PlaceResult trasferiti 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 il PlaceResult.place_id per il luogo desiderato. |
getDetails |
getDetails(request, callback) Parametri:
Valore di restituzione: nessuno
Recupera i dettagli sul luogo identificato dall' placeId specificato. |
nearbySearch |
nearbySearch(request, callback) Parametri:
Valore di restituzione: nessuno
Recupera un elenco di luoghi vicino a una determinata località, in base al tipo o alla parola chiave. La località deve essere sempre specificata, trasmettendo un parametro LatLngBounds oppure location e radius . I PlaceResult trasferiti al callback sono sottoinsiemi di PlaceResult completi. La tua app può ottenere un PlaceResult più dettagliato per ogni luogo inviando una richiesta Dettagli luogo che supera la 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 dei risultati o se c'è solo una pagina dei risultati). |
textSearch |
textSearch(request, callback) Parametri:
Valore di restituzione: nessuno
Recupera un elenco di luoghi in base a una stringa di query (ad esempio, "pizza a New York" o "negozi di calzature vicino Ottawa"). I parametri della posizione sono facoltativi; quando la posizione viene specificata, i risultati sono orientati solo ai risultati nelle vicinanze anziché in base ai luoghi all'interno dell'area. Utilizza textSearch se vuoi cercare luoghi utilizzando una stringa arbitraria e se 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 dei risultati o se c'è solo una pagina dei risultati). |
Interfaccia di PlaceDetailsRequest
google.maps.places.PlaceDetailsRequest
interfaccia
Una query sui dettagli del luogo da inviare a PlacesService
.
Proprietà | |
---|---|
placeId |
Tipo:
string L'ID del luogo per il quale vengono richiesti i dettagli. |
fields optional |
Tipo:
Array<string> optional Campi da includere nella risposta dei dettagli, che saranno fatturati. Se non vengono specificati campi o viene passato ['ALL'] , verranno restituiti e fatturati tutti i campi disponibili (opzione sconsigliata 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 Identificatore della lingua della 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. Questa operazione può influire sulle foto che potrebbero essere restituite e su altri elementi. Il codice regione accetta un valore di due caratteri ccTLD ("primo livello dominio"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune notevoli eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk" ( .co.uk ) mentre il codice ISO 3166-1 è "gb" (tecnicamente per l'entità del "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
Un luogo trovato nella richiesta di ricerca testuale da inviare a PlacesService.findPlaceFromPhoneNumber
.
Proprietà | |
---|---|
fields |
Tipo:
Array<string> Campi da includere nella risposta, che saranno fatturati. Se viene passato ['ALL'] , verranno restituiti e fatturati tutti i campi disponibili (opzione sconsigliata 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 di lingua per la lingua in cui devono essere restituiti i nomi e gli indirizzi, quando possibile. Consulta l'elenco delle lingue supportate. |
locationBias optional |
Tipo:
LocationBias optional Il bias utilizzato durante la ricerca di luogo. Il risultato sarà mostrato in merito a, ma non limitato, al LocationBias specificato. |
Interfaccia di FindPlaceFromQueryRequest
google.maps.places.FindPlaceFromQueryRequest
interfaccia
Un luogo trovato nella richiesta di ricerca testuale da inviare a PlacesService.findPlaceFromQuery
.
Proprietà | |
---|---|
fields |
Tipo:
Array<string> Campi da includere nella risposta, che saranno fatturati. Se viene passato ['ALL'] , verranno restituiti e fatturati tutti i campi disponibili (opzione sconsigliata 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" ). |
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 i nomi e gli indirizzi, quando possibile. Consulta l'elenco delle lingue supportate. |
locationBias optional |
Tipo:
LocationBias optional Il bias utilizzato durante la ricerca di luogo. Il risultato sarà mostrato in merito a, ma non limitato, al LocationBias specificato. |
Interfaccia di PlaceSearchRequest
google.maps.places.PlaceSearchRequest
interfaccia
Una query di ricerca luogo da inviare a PlacesService
.
Proprietà | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional I limiti entro i quali cercare i luoghi. Sia location sia radius verranno ignorati se è impostato bounds . |
keyword optional |
Tipo:
string optional Un termine da abbinare 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 di lingua per la lingua in cui devono essere restituiti i nomi e gli indirizzi, quando possibile. Consulta l'elenco delle lingue supportate. |
location optional |
Tipo:
LatLng|LatLngLiteral optional La posizione in cui cercare Luoghi. |
maxPriceLevel optional |
Tipo:
number optional Consente di limitare i risultati solo a quei luoghi al livello di prezzo specificato o a un livello inferiore. I valori validi sono compresi nell'intervallo da 0 (più conveniente) a 4 (più costoso), compresi. Deve essere maggiore o uguale a minPrice , se specificato. |
minPriceLevel optional |
Tipo:
number optional Limita i risultati solo a quei luoghi al livello di prezzo specificato o superiore. I valori validi sono compresi nell'intervallo da 0 (più conveniente) a 4 (più costoso), compresi. Deve essere minore o uguale a maxPrice , se specificato. |
|
Tipo:
string optional Equivalente a keyword . I valori in questo campo vengono combinati con quelli nel campo keyword e trasmessi come parte della stessa stringa di ricerca. |
openNow optional |
Tipo:
boolean optional Consente di limitare i risultati solo ai luoghi aperti al momento. |
radius optional |
Tipo:
number optional La distanza in metri dalla località specificata in cui cercare Luoghi. Il valore massimo consentito è 50.000. |
rankBy optional |
Tipo:
RankBy optional 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à target della richiesta e viene utilizzato come stringa di query. Se viene fornita anche una query, questa viene concatenata con la stringa di 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. |
Interfaccia TextSearchRequest
google.maps.places.TextSearchRequest
interfaccia
Richiesta di ricerca del testo da inviare al PlacesService
.
Proprietà | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Limiti utilizzati per differenziare i risultati durante la ricerca di Luoghi (facoltativo). Sia location sia radius verranno ignorati se è impostato bounds . I risultati non saranno limitati a quelli che rientrano in questi limiti, ma i risultati al suo interno avranno un ranking più elevato. |
language optional |
Tipo:
string optional Un identificatore di lingua per la lingua in cui devono essere restituiti i nomi e gli indirizzi, quando possibile. Consulta l'elenco delle lingue supportate. |
location optional |
Tipo:
LatLng|LatLngLiteral optional Il centro dell'area utilizzata per bias e 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 un luogo ("pizza a New York") o dal nome di un luogo disambiguator ("Starbucks a Sydney"). |
radius optional |
Tipo:
number optional Il raggio dell'area utilizzata per bias e risultati durante la ricerca di luoghi, in metri. |
region optional |
Tipo:
string optional Un codice regione di cui eseguire il bias. Il codice regione accetta un valore di due caratteri ccTLD ("primo livello dominio"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune notevoli eccezioni. Ad esempio, il ccTLD del Regno Unito è "uk" ( .co.uk ) mentre il codice ISO 3166-1 è "gb" (tecnicamente per l'entità del "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 viene utilizzato come stringa di query. Se viene fornita anche una query, questa viene concatenata con la stringa di 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. |
Costanti RankBy
google.maps.places.RankBy
costanti
Opzioni di ranking per PlaceRequestRequest.
Carica utilizzando il parametro URL &libraries=places
. Consulta la sezione Librerie nell'API Maps JavaScript.
Quando usi v=beta
, puoi accedervi chiamando const {RankBy} = await google.map.importLibrary("places")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
DISTANCE |
I ranking posizionano i risultati in base alla distanza dalla località. |
PROMINENCE |
I ranking mettono i risultati in evidenza. |
def. LocationBias
google.maps.places.LocationBias
typedef
Un LocationBias rappresenta un confine soft o un suggerimento da utilizzare per la ricerca di Places. 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 una Circle
, devi definire il centro e il raggio.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
Una limitazione di località rappresenta un limite rigido da utilizzare durante la ricerca di luoghi.
costanti di PlacesServiceStatus
google.maps.places.PlacesServiceStatus
costanti
Lo stato restituito da PlacesService
al termine delle ricerche. Specificale in base al valore o utilizzando il nome della costante. Ad esempio, 'OK'
o google.maps.places.PlacesServiceStatus.OK
.
Carica utilizzando il parametro URL &libraries=places
. Consulta la sezione Librerie nell'API Maps JavaScript.
Quando usi v=beta
, puoi accedervi chiamando const {PlacesServiceStatus} = await google.map.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 il PlacesService . |
UNKNOWN_ERROR |
Impossibile elaborare la richiesta PlacesService a causa di un errore del server. Se riprovi, la richiesta potrebbe avere esito positivo. |
ZERO_RESULTS |
Nessun risultato trovato per questa richiesta. |
Interfaccia di PlaceSearchPagination
google.maps.places.PlaceSearchPagination
interfaccia
Un oggetto utilizzato per recuperare altre pagine di risultati di Places.
Proprietà | |
---|---|
hasNextPage |
Tipo:
boolean Indica se sono disponibili ulteriori risultati. true quando è presente un'altra pagina di risultati. |
Metodi | |
---|---|
nextPage |
nextPage() Parametri: nessuno
Valore di restituzione: nessuno
Recupera la pagina successiva dei risultati. Utilizza la stessa funzione di callback fornita alla prima richiesta di ricerca. |
Interfaccia di 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 markup di adr. Disponibile solo con PlacesService.getDetails . |
aspects optional |
Tipo:
Array<PlaceAspectRating> optional Gli aspetti valutati di questo luogo in base alle recensioni degli utenti su Google e Zagat. Le valutazioni sono su una scala da 0 a 30. |
business_status optional |
Tipo:
BusinessStatus optional Un flag che indica lo stato operativo del luogo, se è un'attività commerciale (indica se il luogo è operativo o è chiuso temporaneamente o definitivamente). Se non ci sono dati disponibili, il flag non è presente nella ricerca o nelle risposte 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 di questo luogo. Gli elementi html_attributions disponibili vengono sempre restituiti indipendentemente da ciò che fields è stato richiesto 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 dell'icona. Accedi a diversi tipi di icone aggiungendo un'estensione del file alla fine (ad esempio, .svg o .png ). |
international_phone_number optional |
Tipo:
string optional Il numero di telefono di Place 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 in cui un utente abbia inserito un luogo, questo sarà il testo non elaborato digitato dall'utente. Presta attenzione quando utilizzi questi dati, poiché gli utenti malintenzionati potrebbero provare a utilizzarli come vettore per gli attacchi di iniezione di codice (visita la pagina http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
Tipo:
PlaceOpeningHours optional Definisce quando si apre o si chiude il luogo. |
|
Tipo:
boolean optional Un flag che indica se il luogo è chiuso, definitivamente o temporaneamente. 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 del luogo. |
plus_code optional |
Tipo:
PlacePlusCode optional Definisce i codici di posizione aperti o i "plus code" per il luogo. |
price_level optional |
Tipo:
number optional Il livello del prezzo del luogo, su una scala da 0 a 4. I livelli di prezzo sono interpretati come segue:
|
rating optional |
Tipo:
number optional Una valutazione compresa tra 1,0 e 5,0, basata sulle recensioni degli utenti di questo luogo. |
reviews optional |
Tipo:
Array<PlaceReview> optional Un elenco di recensioni sul 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 su questo luogo. Disponibile solo con PlacesService.getDetails . |
user_ratings_total optional |
Tipo:
number optional Il numero di valutazioni degli utenti che hanno contribuito a PlaceResult.rating di questo luogo. |
|
Tipo:
number optional La differenza in secondi rispetto al fuso orario corrente del luogo. Ad esempio, Sydney, in Australia, quando è in vigore l'ora legale, è 11 ore avanti rispetto all'UTC, quindi utc_offset sarà 660 . Per i fusi orari dietro 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 in secondi rispetto al fuso orario corrente del luogo. Ad esempio, Sydney, in Australia, quando è in vigore l'ora legale, è 11 ore avanti rispetto all'UTC, quindi utc_offset_minutes sarà 660 . Per i fusi orari dietro 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 per il luogo, inclusi nome, 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 prossimità pari a "48 Pirrama Road, Pyrmont" . Disponibile solo con PlacesService.getDetails . |
website optional |
Tipo:
string optional Il sito web autorevole per questo luogo, ad esempio la home page di un'attività. Disponibile solo con PlacesService.getDetails . |
Interfaccia di PlacePlaceRating
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, questo è un numero intero da 0 a 30. |
type |
Tipo:
string Il tipo di formato. Ad esempio, "food" , "decor" , "service" o "overall" . |
costanti di BusinessStatus
google.maps.places.BusinessStatus
costanti
Lo stato operativo del luogo, se è un'attività, viene restituito in un PlaceResult (indica se il luogo è operativo o è chiuso temporaneamente o definitivamente). Specificali in base al valore o al nome della costante (esempio: 'OPERATIONAL'
o google.maps.places.BusinessStatus.OPERATIONAL
).
Carica utilizzando il parametro URL &libraries=places
. Consulta la sezione Librerie nell'API Maps JavaScript.
Quando usi v=beta
, puoi accedervi chiamando const {BusinessStatus} = await google.map.importLibrary("places")
. Consulta la sezione Librerie nell'API Maps JavaScript.
Costanti | |
---|---|
CLOSED_PERMANENTLY |
L'attività è chiusa definitivamente. |
CLOSED_TEMPORARILY |
L'attività è chiusa temporaneamente. |
OPERATIONAL |
L'attività opera normalmente. |
Interfaccia di 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 La visualizzazione preferita per la visualizzazione di questo luogo sulla mappa. Questa proprietà sarà null se l'area visibile preferita per il luogo non è nota. Disponibile solo con PlacesService.getDetails . |
Interfaccia di PlaceOpeningHours
google.maps.places.PlaceOpeningHours
interfaccia
Definisce 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 l'orario di apertura formattato per ogni giorno della settimana. Il servizio Places formatta e localizza correttamente l'orario di apertura per la lingua corrente. L'ordine degli elementi in questo array dipende dalla lingua. Alcune lingue iniziano la settimana di lunedì, mentre altre la domenica. Disponibile solo con PlacesService.getDetails . Le altre chiamate potrebbero restituire un array vuoto. |
Metodi | |
---|---|
isOpen |
isOpen([date]) Parametri:
Valore restituito:
boolean|undefined Controlla se il luogo è aperto ora (quando non è trascorsa nessuna 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 orari eccezionali, come gli orari per le festività. |
Interfaccia di 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 sempre aperta come un periodo open
contenente day
con valore 0
e time
con valore "0000"
e nessun valore close
.
Proprietà | |
---|---|
open |
Tipo:
PlaceOpeningHoursTime L'orario di apertura del luogo. |
close optional |
Tipo:
PlaceOpeningHoursTime optional L'orario di chiusura del Luogo. |
Interfaccia di PlaceOpeningHoursTime
google.maps.places.PlaceOpeningHoursTime
interfaccia
Definisce quando si apre o si chiude un luogo.
Proprietà | |
---|---|
day |
Tipo:
number I giorni della settimana, sotto forma di numero nell'intervallo [ 0 , 6 ], che inizia di domenica. Ad esempio, 2 significa martedì. |
hours |
Tipo:
number Gli orari della PlaceOpeningHoursTime.time sotto forma di numero, nell'intervallo [0 , 23 ]. Il numero sarà registrato nel fuso orario del luogo. |
minutes |
Tipo:
number I minuti di PlaceOpeningHoursTime.time sotto forma di numero, nell'intervallo [0 , 59 ]. Il valore viene registrato nel fuso orario del luogo. |
time |
Tipo:
string L'ora del giorno nel formato "hhmm" (24 ore). I valori sono compresi nell'intervallo [ "0000" , "2359" ]. L'ora sarà indicata nel fuso orario del luogo. |
nextDate optional |
Tipo:
number optional Il timestamp (in millisecondi dall'epoca, idoneo per l'uso con new Date() ) che rappresenta la successiva occorrenza di questo PlaceOpeningHoursTime. Viene calcolato in base alla PlaceOpeningHoursTime.day della settimana, al PlaceOpeningHoursTime.time e al PlaceResult.utc_offset_minutes . Se PlaceResult.utc_offset_minutes è undefined , nextDate sarà undefined . |
Interfaccia di PlacePlusCode
google.maps.places.PlacePlusCode
interfaccia
Definisce i codici di posizione aperti o i "plus code" di un luogo. È possibile utilizzare i Plus Code per sostituire gli indirizzi in luoghi in cui non esistono (gli edifici non sono numerati o le strade non hanno un nome).
Proprietà | |
---|---|
global_code |
Tipo:
string Un plus code con 1/8000 di grado per 1/8000 di area di grado. Ad esempio, "8FVC9G8F+5W" . |
compound_code optional |
Tipo:
string optional Un plus code con un 1/8000 di grado per 1/8000 di un'area 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 è presente una località adatta per accorciare il codice, questo campo viene omesso. |
Interfaccia di PlaceFoto
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 di 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 di FotoOptions
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 di 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 l'area geografica. Ad esempio, tutte le recensioni in inglese presentano il tag 'en' anziché "en-AU" o "en-UK". |
profile_photo_url |
Tipo:
string Un URL che indirizza all'immagine del profilo del responsabile della revisione. |
relative_time_description |
Tipo:
string Una stringa formattata di recente, che indica il tempo di revisione in relazione al fuso orario 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. |
|
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. Questo sarà undefined quando il profilo del recensore non sarà disponibile. |
rating optional |
Tipo:
number optional La valutazione di questa recensione, un numero compreso tra 1,0 e 5,0 (inclusi). |