Esegui la migrazione a Ricerca nelle vicinanze (novità)

Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

L'API Places supporta Nearby Search (legacy). Se hai familiarità con la ricerca nelle vicinanze (legacy), la ricerca nelle vicinanze (nuova) apporta le seguenti modifiche:

  • Ricerca nelle vicinanze (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 la ricerca nelle vicinanze (legacy), trasmetti i parametri URL utilizzando una richiesta HTTP GET.
  • La mascheratura dei campi è obbligatoria. Devi specificare i campi che vuoi 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.
  • Nearby Search (New) supporta sia le chiavi API sia i token OAuth come meccanismo di autenticazione.
  • Solo JSON è supportato come formato di risposta in Ricerca nelle vicinanze (nuova).
  • Tutte le richieste che includono una query di testo ora devono utilizzare Ricerca di testo (nuova) perché la ricerca nelle vicinanze (nuova) non supporta l'input di testo.
  • Il formato della risposta JSON per Ricerca nelle vicinanze (nuova) è cambiato rispetto al formato delle API legacy. Per maggiori dettagli, vedi Eseguire la migrazione della risposta dell'API Places.

La tabella seguente elenca i parametri di Ricerca nelle vicinanze (legacy) che sono stati rinominati o modificati per Ricerca nelle vicinanze (nuova) oppure i parametri non più supportati.

Parametro corrente Nuovo parametro Note
keyword Non supportati. Utilizza Ricerca di testo (nuova) invece.
language languageCode
location locationRestriction Obbligatorio.
maxprice/minprice Non supportati.
maxResultCount Nuovo parametro.
opennow Non supportati.
pagetoken Non supportati.
radius Utilizza subito locationRestriction.
rankby rankPreference
regionCode Nuovo parametro.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		I nuovi parametri accettano anche più valori di tipo. L'API precedente accetta un solo valore.

Esempio di richiesta

La seguente richiesta GET di esempio utilizza la ricerca nelle vicinanze (legacy). In questo esempio, richiedi una risposta JSON contenente informazioni sui luoghi di tipo restaurant e trasmetti tutti i parametri 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 ricerca nelle vicinanze (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 '{
  "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