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), la Nearby Search (nuova) apporta le seguenti modifiche:

  • Nearby Search (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 Nearby Search (legacy), trasmetti i parametri URL utilizzando una richiesta GET HTTP.
  • La mascheratura dei campi è 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 token OAuth come meccanismo di autenticazione.
  • Solo JSON è supportato come formato di risposta in Nearby Search (nuova).
  • Tutte le richieste che includono una query di testo ora devono utilizzare Ricerca testuale (Nuova) perché Nearby Search (Nuova) non supporta l'input di testo.
  • Il formato della risposta JSON per Nearby Search (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 Nearby Search (legacy) che sono stati rinominati o modificati per Nearby Search (nuovo) oppure i parametri non più supportati.

Parametro corrente Nuovo parametro Note
keyword Non supportati. Utilizza Ricerca testuale (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 Nearby Search (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