L'API Places supporta Ricerca testuale. Se hai familiarità con le applicazioni Ricerca testuale, nuova versione di Ricerca testuale apporta le seguenti modifiche:
- La nuova ricerca testuale utilizza richieste POST HTTP. Superato nel corpo della richiesta o nelle intestazioni come parte di una richiesta POST HTTP. Al contrario, con la ricerca testuale esistente, Parametri URL che utilizzano una richiesta HTTP GET.
- Il mascheramento dei campi è obbligatorio. Devi specificare quali campi devono essere restituiti nella risposta. Non esiste un elenco predefinito dei campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore. Per ulteriori informazioni, vedi FieldMask.
- La nuova ricerca testuale supporta entrambe le chiavi API e OAuth come meccanismo di autenticazione.
- Nel nuovo formato di risposta è supportato solo JSON Ricerca testuale.
La ricerca testuale esistente ti consente di specificare latitudine e longitudine nella stringa di query. Ad esempio:
query=37.4239,-122.0925. Questa opzione non è supportata nella nuova ricerca testuale.Utilizza le funzionalità di Inverti geocodifica per cercare coordinate e restituire un indirizzo oppure Ricerca nelle vicinanze (novità) per trovare luoghi nelle vicinanze di una determinata località.
- Il formato della risposta JSON per la ricerca testuale (novità) L'API è cambiata rispetto al formato delle API esistenti. Per ulteriori dettagli, vedi Esegui la migrazione della risposta dell'API Places.
Nella tabella seguente sono elencati i parametri nell'elenco Ricerca testuale che è stata rinominata o modificata per una nuova ricerca testuale o parametri che non sono più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
evOptions |
Nuovo parametro. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
Non supportati. | |
query |
textQuery |
Obbligatorio in tutte le richieste. |
radius |
locationBias |
Specifica il raggio quando definisci un locationBias. |
region |
regionCode |
|
type |
includedType |
Prende un solo valore. |
strictTypeFiltering |
Nuovo parametro. |
Esempio di richiesta
La richiesta GET di esempio seguente utilizza il modello Ricerca testuale. In questo esempio, richiedi un file JSON risposta contenente informazioni su "Cibo vegetariano piccante a Sydney, Australia" e trasmetti tutti i parametri come parametri URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
Con la ricerca testuale (novità), effettui una richiesta POST e passare tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte della richiesta richiesta. Questo esempio utilizza anche una maschera di campo in modo che la risposta includa solo nome visualizzato e indirizzo formattato del luogo:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'