Places Service

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.
PlacesService
PlacesService(attrContainer)
Parametri: 
Crea una nuova istanza di PlacesService che esegue il rendering delle attribuzioni nel contenitore specificato.
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.
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.
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.
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.
bounds 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.
name optional
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.
bounds 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.
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|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

google.maps.places.LocationRestriction typedef

LocationRestriction rappresenta un limite rigoroso da utilizzare durante la ricerca di luoghi.

LatLngBounds|LatLngBoundsLiteral

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.
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.
hasNextPage
Tipo:  boolean
Indica se sono disponibili altri risultati. true quando è presente una pagina dei risultati aggiuntiva.