Place

Classe Place

google.maps.places.Place classe

Accedi chiamando const {Place} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
Place
Place(options)
Parametri: 
searchByText
searchByText(request)
Parametri: 
Valore restituito:  Promise<{places:Array<Place>}>
Ricerca di luoghi basata su query di testo.
accessibilityOptions
Tipo:  AccessibilityOptions optional
Opzioni di accessibilità di questo luogo. undefined se i dati delle opzioni di accessibilità non sono stati richiesti dal server.
addressComponents
Tipo:  Array<AddressComponent> optional
La raccolta di componenti dell'indirizzo per la posizione di questo luogo. Oggetto vuoto se non esistono dati relativi agli indirizzi noti. undefined se i dati dell'indirizzo non sono stati chiamati dal server.
adrFormatAddress
Tipo:  string optional
La rappresentazione dell'indirizzo del luogo nel microformato adr.
attributions
Tipo:  Array<Attribution> optional
Testo dell'attribuzione da visualizzare per questo risultato relativo a questo luogo.
businessStatus
Tipo:  BusinessStatus optional
Lo stato operativo della sede. null in assenza di stato noto. undefined se i dati di stato non sono stati caricati dal server.
displayName
Tipo:  string optional
Il nome visualizzato del luogo. null se non è presente alcun nome. undefined se i dati del nome non sono stati caricati dal server.
editorialSummary
Tipo:  string optional
Il riassunto editoriale di questo luogo. null in assenza di un riassunto editoriale. undefined se questo campo non è ancora stato richiesto.
editorialSummaryLanguageCode
Tipo:  string optional
La lingua del riassunto editoriale di questo luogo. null in assenza di un riassunto editoriale. undefined se questo campo non è ancora stato richiesto.
formattedAddress
Tipo:  string optional
L'indirizzo completo delle sedi.
googleMapsURI
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.
hasCurbsidePickup
Tipo:  boolean optional
Indica se un luogo offre il servizio di ritiro all'esterno. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
hasDelivery
Tipo:  boolean optional
Se in un luogo è disponibile la consegna a domicilio. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
hasDineIn
Tipo:  boolean optional
Indica se un luogo ha consumato sul posto. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
hasTakeout
Tipo:  boolean optional
Indica se in un luogo è disponibile il servizio da asporto. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
iconBackgroundColor
Tipo:  string optional
Il codice colore esadecimale predefinito per la categoria del luogo.
id
Tipo:  string
L'ID luogo univoco.
internationalPhoneNumber
Tipo:  string optional
Il numero di telefono del luogo in formato internazionale. Il formato internazionale include il codice paese ed è preceduto dal segno più (+).
isReservable
Tipo:  boolean optional
Indica se un luogo è prenotabile. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
location
Tipo:  LatLng optional
La posizione del luogo.
nationalPhoneNumber
Tipo:  string optional
Il numero di telefono del luogo, formattato in base alla convenzione regionale del numero.
photos
Tipo:  Array<Photo> optional
Foto di questo luogo. La raccolta conterrà fino a dieci oggetti Photo.
plusCode
Tipo:  PlusCode optional
priceLevel
Tipo:  PriceLevel optional
Il livello dei prezzi del luogo. Questa proprietà può restituire uno dei seguenti valori
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Tipo:  number optional
Una valutazione compresa tra 1,0 e 5,0, basata sulle recensioni degli utenti su questo luogo.
regularOpeningHours
Tipo:  OpeningHours optional
requestedLanguage
Tipo:  string optional
La lingua richiesta per questo luogo.
requestedRegion
Tipo:  string optional
La regione richiesta per questo luogo.
reviews
Tipo:  Array<Review> optional
Un elenco di recensioni per questo luogo.
servesBeer
Tipo:  boolean optional
Se un locale serve birra. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
servesBreakfast
Tipo:  boolean optional
Indica se un luogo serve la colazione. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
servesBrunch
Tipo:  boolean optional
Indica se un locale serve il brunch. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
servesDinner
Tipo:  boolean optional
Indica se la cena viene servita in un luogo. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
servesLunch
Tipo:  boolean optional
Indica se il pranzo serve il pranzo. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
servesVegetarianFood
Tipo:  boolean optional
Se un luogo serve cibo vegetariano. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
servesWine
Tipo:  boolean optional
Indica se un luogo serve vino. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto. Restituisce 'undefined' se questo campo non è ancora stato richiesto.
svgIconMaskURI
Tipo:  string optional
URI della risorsa maschera dell'immagine svg che può essere utilizzata per rappresentare la categoria di un luogo.
types
Tipo:  Array<string> optional
Un array di tipi di questo luogo (ad esempio, ["political", "locality"] o ["restaurant", "establishment"]).
userRatingCount
Tipo:  number optional
Il numero di valutazioni degli utenti che hanno contribuito a Place.rating di questo luogo.
utcOffsetMinutes
Tipo:  number optional
La differenza in minuti rispetto al fuso orario UTC del fuso orario attuale del luogo. Ad esempio, il fuso orario della costa orientale dell'Austria (GMT+10) nell'ora legale è 11 ore avanti rispetto a UTC, quindi il valore di utc_offset_minutes sarà 660. Per i fusi orari successivi al fuso orario UTC, l'offset è negativo. Ad esempio, utc_offset_minutes è -60 per Capo Verde.
viewport
Tipo:  LatLngBounds optional
L'area visibile preferita quando questo luogo viene mostrato su una mappa.
websiteURI
Tipo:  string optional
Il sito web autorevole del luogo, ad esempio la home page di un'attività.
openingHours
Tipo:  OpeningHours optional
fetchFields
fetchFields(options)
Parametri: 
Valore restituito:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
Parametri: 
  • date:  Date optional
Valore restituito:  Promise<Date optional>
Calcola la data che rappresenta l'ora di apertura successiva. Il valore restituisce un valore non definito se i dati non sono sufficienti per calcolare il risultato o se questo luogo non è operativo.
BetaisOpen
isOpen([date])
Parametri: 
  • date:  Date optional il valore predefinito è adesso.
Valore restituito:  Promise<boolean optional>
Controlla se il luogo è aperto nell'orario specificato. Restituisce undefined se i dati noti per la sede non sono sufficienti per calcolarlo, ad esempio se gli orari di apertura non sono registrati.
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object un oggetto JSON con tutte le proprietà Place richieste.

Interfaccia PlaceOptions

Interfaccia google.maps.places.PlaceOptions

Opzioni per la creazione di un luogo.
id
Tipo:  string
L'ID luogo univoco.
requestedLanguage optional
Tipo:  string optional
Un identificatore della lingua in cui devono essere restituiti i dettagli. Consulta l'elenco delle lingue supportate.
requestedRegion optional
Tipo:  string optional
Un codice regione della regione dell'utente. Questo può influire sulle foto che possono essere restituite e probabilmente su altri elementi. Il codice regione accetta un ccTLD ("dominio di primo livello") a due caratteri. La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. 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").

AccessibilityOptions

google.maps.places.AccessibilityOptions classe

Accedi chiamando const {AccessibilityOptions} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
hasWheelchairAccessibleEntrance
Tipo:  boolean optional
Indica se un luogo dispone di un ingresso accessibile in sedia a rotelle. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto.
hasWheelchairAccessibleParking
Tipo:  boolean optional
Indica se un luogo dispone di parcheggio accessibile in sedia a rotelle. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto.
hasWheelchairAccessibleRestroom
Tipo:  boolean optional
Indica se un luogo dispone di bagni accessibili in sedia a rotelle. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto.
hasWheelchairAccessibleSeating
Tipo:  boolean optional
Indica se un luogo offre tavoli accessibili in sedia a rotelle. Restituisce "true" o "false" se il valore è noto. Restituisce "null" se il valore è sconosciuto.

AddressComponent

google.maps.places.AddressComponent classe

Accedi chiamando const {AddressComponent} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
longText
Tipo:  string optional
Il testo completo del componente indirizzo.
shortText
Tipo:  string optional
Il breve testo abbreviato del componente indirizzo specificato.
types
Tipo:  Array<string>
Un array di stringhe che indicano il tipo di questo componente dell'indirizzo. Un elenco dei tipi validi è disponibile qui.

Classe Attribution

google.maps.places.Attribution classe

Accedi chiamando const {Attribution} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
provider
Tipo:  string optional
Testo dell'attribuzione da visualizzare per questo risultato relativo a questo luogo.
providerURI
Tipo:  string optional

Interfaccia FetchFieldsRequest

Interfaccia google.maps.places.FetchFieldsRequest

Opzioni per il recupero dei campi Luogo.
fields
Tipo:  Array<string>
Elenco dei campi da recuperare.

lezione OpeningHours

google.maps.places.OpeningHours classe

Accedi chiamando const {OpeningHours} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
periods
I periodi di apertura coprono ogni giorno della settimana, a partire dalla domenica, in ordine cronologico. Non sono inclusi i giorni in cui il luogo non è aperto.
weekdayDescriptions
Tipo:  Array<string>
Un array di sette stringhe che rappresentano l'orario di apertura formattato di ogni giorno della settimana. Il servizio Places formatta e localizza gli orari di apertura in base alla lingua corrente. L'ordine degli elementi in questo array dipende dalla lingua. Alcune lingue iniziano la settimana di lunedì, altre di domenica.

Classe OpeningHoursPeriod

google.maps.places.OpeningHoursPeriod classe

Accedi chiamando const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
close
Tipo:  OpeningHoursPoint optional
L'orario di chiusura di questo luogo.
open
L'orario di apertura del luogo.

Classe OpeningHoursPoint

google.maps.places.OpeningHoursPoint classe

Accedi chiamando const {OpeningHoursPoint} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
day
Tipo:  number
Il giorno della settimana, sotto forma di numero compreso nell'intervallo [0, 6], a partire da domenica. Ad esempio, 2 significa martedì.
hour
Tipo:  number
L'ora di OpeningHoursPoint.time in formato numerico, compresa nell'intervallo [0, 23]. Verrà riportato nel fuso orario del luogo.
minute
Tipo:  number
Il minuto di OpeningHoursPoint.time sotto forma di numero, compreso nell'intervallo [0, 59]. Verrà riportato nel fuso orario del luogo.

Corso di foto

google.maps.places.Photo classe

Accedi chiamando const {Photo} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
authorAttributions
Testo dell'attribuzione da visualizzare per questa foto.
heightPx
Tipo:  number
L'altezza della foto in pixel.
widthPx
Tipo:  number
La larghezza della foto in pixel.
getURI
getURI([options])
Parametri: 
Valore restituito:  string
Restituisce l'URL dell'immagine corrispondente alle opzioni specificate.

Classe AuthorAttribution

google.maps.places.AuthorAttribution classe

Accedi chiamando const {AuthorAttribution} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
displayName
Tipo:  string
Nome dell'autore per questo risultato.
photoURI
Tipo:  string optional
URI della foto dell'autore per questo risultato. Questa opzione potrebbe non essere sempre disponibile.
uri
Tipo:  string optional
URI del profilo dell'autore per questo risultato.

PlusCode

google.maps.places.PlusCode classe

Accedi chiamando const {PlusCode} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
compoundCode
Tipo:  string optional
Un plus code con 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 Zurigo, Svizzera".
globalCode
Tipo:  string optional
Un plus code con 1/8000° di grado per 1/8000° di area di laurea. Ad esempio, "8FVC9G8F+5W".

Rivedi il corso

google.maps.places.Review classe

Accedi chiamando const {Review} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
authorAttribution
Tipo:  AuthorAttribution optional
Il recensore.
publishTime
Tipo:  Date optional
rating
Tipo:  number optional
La valutazione di questa recensione, un numero compreso tra 1,0 e 5,0 (incluso).
relativePublishTimeDescription
Tipo:  string optional
Una stringa formattata con l'ora recente, che esprime la data e l'ora della revisione relative all'ora corrente in un formato appropriato per la lingua e il paese. Ad esempio""un mese fa".
text
Tipo:  string optional
Il testo di una recensione.
textLanguageCode
Tipo:  string optional
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 con il tag 'en' anziché "en-AU" o "en-UK".

Costanti PriceLevel

google.maps.places.PriceLevel costanti

Enum del livello di prezzo per gli oggetti Place.

Accedi chiamando const {PriceLevel} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

Interfaccia SearchByTextRequest

Interfaccia google.maps.places.SearchByTextRequest

Interfaccia di richiesta per Place.searchByText.
fields
Tipo:  Array<string>
Campi da includere nella risposta, che verranno addebitati. Se viene passato ['*'], verranno restituiti tutti i campi disponibili e verranno addebitati i relativi costi (questa operazione è sconsigliata per i deployment di produzione). Per un elenco dei campi, vedi PlaceResult. I campi nidificati possono essere specificati con percorsi con punti (ad esempio, "geometry.location").
includedType optional
Tipo:  string optional
Il tipo di luogo richiesto. Elenco completo dei tipi supportati: https://developers.google.com/maps/documentation/places/web-service/place-types. È supportato un solo tipo incluso. Vedi SearchByTextRequest.useStrictTypeFiltering
isOpenNow optional
Tipo:  boolean optional
Predefinita: false
Utilizzato per limitare la ricerca ai luoghi attualmente aperti.
language optional
Tipo:  string optional
I dettagli del luogo verranno visualizzati nella lingua preferita, se disponibile. Per impostazione predefinita, viene utilizzata la lingua preferita del browser. Elenco aggiornato delle lingue supportate: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
La regione in cui cercare. Questa località funge da bias, il che significa che potrebbero essere restituiti i risultati relativi a una determinata località. Non possono essere impostati insieme a locationRestriction.
locationRestriction optional
La regione in cui cercare. Questa località è una limitazione, il che significa che i risultati al di fuori della località non verranno restituiti. Non possono essere impostati insieme a locationBias.
maxResultCount optional
Tipo:  number optional
Numero massimo di risultati da restituire. Il valore deve essere compreso tra 1 e 20 inclusi.
minRating optional
Tipo:  number optional
Filtra i risultati la cui valutazione media degli utenti è strettamente inferiore a questo limite. Un valore valido deve essere un numero in virgola mobile compreso tra 0 e 5 (inclusi) a una cadenza di 0,5, ovvero [0, 0,5, 1,0, ... , 5,0] inclusi. La classificazione dell'input verrà arrotondata per eccesso allo 0,5(max) più vicino. Ad esempio, una valutazione pari a 0,6 eliminerà tutti i risultati con una valutazione inferiore a 1,0.
priceLevels optional
Tipo:  Array<PriceLevel> optional
Utilizzato per limitare la ricerca ai luoghi contrassegnati come determinati livelli di prezzo. È possibile scegliere qualsiasi combinazione di livelli di prezzo. Il valore predefinito è tutti i livelli di prezzo.
query optional
Tipo:  string optional
BetarankBy optional
rankPreference optional
Predefinita: SearchByTextRankPreference.DISTANCE
Come verranno classificati i risultati nella risposta.
region optional
Tipo:  string optional
Il codice paese/regione Unicode (CLDR) della località da cui proviene la richiesta. Questo parametro viene utilizzato per visualizzare i dettagli del luogo, come il nome del luogo specifico per la regione, se disponibile. Il parametro può influire sui risultati in base alla legge vigente. Per ulteriori informazioni, vedi https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Tieni presente che i codici regione a 3 cifre non sono attualmente supportati.
textQuery optional
Tipo:  string optional
Obbligatorio. La query di testo per la ricerca testuale.
useStrictTypeFiltering optional
Tipo:  boolean optional
Predefinita: false
Utilizzato per impostare il filtro del tipo di livello massimo per SearchByTextRequest.includedType. Se impostato su true, verranno restituiti solo i risultati dello stesso tipo.

Costanti SearchByTextRankPreference

google.maps.places.SearchByTextRankPreference costanti

Enum di RankPreference per SearchByTextRequest.

Accedi chiamando const {SearchByTextRankPreference} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
DISTANCE Classifica i risultati in base alla distanza.
RELEVANCE Classifica i risultati in base alla pertinenza.