L'API Places supporta Ricerca nelle vicinanze. Se hai familiarità con la funzionalità di ricerca nelle vicinanze esistente, nuova versione di Nearby Search apporta le seguenti modifiche:
- La nuova Ricerca nelle vicinanze utilizza richieste POST HTTP. Trasmettere parametri nel corpo della richiesta o nelle intestazioni come parte di un POST HTTP richiesta. Al contrario, con la funzionalità di ricerca nelle vicinanze esistente, puoi passare i parametri URL utilizzando 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 nelle vicinanze supporta Chiavi API e OAuth come meccanismo di autenticazione.
- Nel nuovo formato di risposta è supportato solo JSON Ricerca nelle vicinanze.
- Tutte le richieste che includono una query di testo ora dovrebbero utilizzare Ricerca testuale (novità) perché Ricerca nelle vicinanze (nuova) non supporta l'input di testo.
- Formato di risposta JSON per Nearby Search (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 nelle vicinanze che è stata rinominata o modificata per nuova ricerca nelle vicinanze o parametri che non sono più supportati.
| Parametro attuale | Nuovo parametro | Note |
|---|---|---|
keyword |
Non supportati. Utilizza le funzionalità di Ricerca testuale (novità) . | |
language |
languageCode |
|
location |
locationRestriction |
Obbligatorio. |
maxprice/minprice |
|
Non supportati. |
maxResultCount |
Nuovo parametro. | |
opennow |
|
Non supportati. |
pagetoken |
Non supportati. | |
radius |
|
Utilizza locationRestriction ora. |
rankby |
rankPreference |
|
regionCode |
Nuovo parametro. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
I nuovi parametri accettano anche più valori di tipo. L'API esistente accetta un solo valore. |
Esempio di richiesta
La richiesta GET di esempio seguente utilizza il modello
Ricerca nelle vicinanze. In questo esempio, richiedi un file JSON
risposta contenente informazioni sui luoghi di tipo restaurant e supera tutti
come parametri URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Con la funzione Nearby Search (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 '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-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:searchNearby