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.