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 Nearby Search (Legacy), il Nearby Search (New) apporta le seguenti modifiche:

  • Nearby Search (New) utilizza le richieste HTTP POST. Passa i parametri nel corpo della richiesta o nelle intestazioni come parte di una richiesta HTTP POST richiesta. Al contrario, con Nearby Search (Legacy), passi i parametri URL utilizzando una richiesta HTTP GET.
  • La maschera di campo è obbligatoria. Devi specificare i campi che 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, consulta FieldMask.
  • Nearby Search (New) supporta sia le chiavi API sia i OAuth come meccanismo di autenticazione.
  • In Nearby Search (New) è supportato solo il formato JSON come formato di risposta.
  • Tutte le richieste che includono una query di testo ora devono utilizzare Text Search (New) perché Nearby Search (New) non supporta l'input di testo.
  • Il formato di risposta JSON per Nearby Search (New) è cambiato rispetto al formato delle API legacy. Per maggiori dettagli, consulta Migrare la risposta dell'API Places.

La tabella seguente elenca i parametri di Nearby Search (Legacy) che sono stati rinominati o modificati per Nearby Search (New) o i parametri non più supportati.

Parametro attuale Nuovo parametro Note
keyword Non supportati. Utilizza Text Search (New) invece.
language languageCode
location locationRestriction Obbligatorio.
maxprice/minprice Non supportati.
maxResultCount Nuovo parametro.
opennow Non supportati.
pagetoken Non supportati.
radius Ora utilizza locationRestriction.
rankby rankPreference
regionCode Nuovo parametro.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		I nuovi parametri accettano anche più valori di tipo. L'API legacy accetta un solo valore.

Esempio di richiesta

La seguente richiesta GET di esempio utilizza Nearby Search (Legacy). In questo esempio, richiedi una risposta JSON contenente informazioni sui luoghi di tipo restaurant e passi 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 Nearby Search (New), 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