Introduzione
L'API Places (legacy) supporta Ricerca testuale (legacy). Se hai familiarità con Ricerca testuale (legacy), Ricerca testuale (nuovo) apporta le seguenti modifiche:
- Ricerca testuale (Nuova) utilizza richieste HTTP POST. Passa i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta HTTP POST. Al contrario, con Ricerca testuale (legacy), passi i parametri URL utilizzando una richiesta GET HTTP.
- La mascheratura dei campi è obbligatoria. Devi specificare quali campi vuoi che vengano restituiti nella risposta. Non esiste un elenco predefinito di campi restituiti. Se ometti questo elenco, i metodi restituiscono un errore. Per ulteriori informazioni, vedi FieldMask.
- La Ricerca testuale (Nuova) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
- In Ricerca testuale (nuova) è supportato solo il formato JSON come formato di risposta.
Ricerca testuale (legacy) ti consente di specificare le coordinate di latitudine e longitudine nella stringa di query. Ad esempio:
query=37.4239,-122.0925. Questa opzione non è supportata nella Ricerca testuale (nuova).Utilizza la geocodifica inversa per cercare in base alle coordinate e restituire un indirizzo oppure la Nearby Search (New) per trovare luoghi intorno a una determinata posizione.
- Il formato della risposta JSON per la Ricerca testuale (nuova) è cambiato rispetto a quello delle API legacy. Per maggiori dettagli, vedi Eseguire la migrazione della risposta dell'API Places.
La tabella seguente elenca i parametri di Ricerca testuale (legacy) che sono stati rinominati o modificati per Ricerca testuale (nuovo) oppure i parametri non più supportati.
| Parametro corrente | Nuovo parametro | Note |
|---|---|---|
evOptions |
Nuovo parametro. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
Obbligatorio in tutte le richieste. |
radius |
locationBias |
Specifica il raggio quando definisci un locationBias. |
region |
regionCode |
|
type |
includedType |
Accetta un solo valore. |
strictTypeFiltering |
Nuovo parametro. |
Esempio di richiesta
La seguente richiesta GET di esempio utilizza la Ricerca testuale (legacy). In questo esempio, richiedi una risposta JSON 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 (nuova), invii una richiesta POST e passi tutti i parametri nel corpo della richiesta JSON o nelle intestazioni come parte della richiesta POST. Questo esempio utilizza anche una maschera di campo, in modo che la risposta includa solo il nome visualizzato e l'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'