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