Esegui la migrazione a Ricerca nelle vicinanze (novità)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Trasmetti i parametri nel corpo della richiesta o nelle intestazioni nell'ambito 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 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.
- 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 Nearby Search (New)
è 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 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
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Migrate to Nearby Search (New)\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nIntroduction\n------------\n\nPlaces API supports\n[Nearby Search (Legacy)](/maps/documentation/places/web-service/search-nearby).\nIf you are familiar with Nearby Search (Legacy), the [Nearby Search (New)](/maps/documentation/places/web-service/nearby-search) makes the following\nchanges:\n\n- Nearby Search (New) uses HTTP POST requests. Pass parameters in the request body or in headers as part of an HTTP POST request. In contrast, with Nearby Search (Legacy), you pass URL parameters using an HTTP GET request.\n- Field masking is required. You must specify which fields you want returned in the response. There is no default list of returned fields. If you omit this list, the methods return an error. For more information, see [FieldMask](/maps/documentation/places/web-service/nearby-search#fieldmask).\n- Nearby Search (New) supports both [API keys](/maps/documentation/places/web-service/get-api-key) and [OAuth](/maps/documentation/places/web-service/oauth-token) tokens as the authentication mechanism.\n- Only JSON is supported as a response format in Nearby Search (New).\n- All requests that include a text query should now use [Text Search (New)](/maps/documentation/places/web-service/text-search) because Nearby Search (New) does not support text input.\n- The JSON response format for Nearby Search (New) has changed from the format of the legacy APIs. For more details, see [Migrate the Places API response](/maps/documentation/places/web-service/migrate-response).\n\nThe following table lists parameters in Nearby Search (Legacy) that have been\nrenamed or modified for Nearby Search (New), or parameters that are no\nlonger supported.\n\n| Current parameter | New parameter | Notes |\n|---------------------|-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------|\n| `keyword` | | Not supported. Use [Text Search (New)](/maps/documentation/places/web-service/text-search) instead. |\n| `language` | `languageCode` | |\n| `location` | `locationRestriction` | Required. |\n| `maxprice/minprice` | | Not supported. |\n| | `maxResultCount` | New parameter. |\n| `opennow` | | Not supported. |\n| `pagetoken` | | Not supported. |\n| `radius` | | Use `locationRestriction` now. |\n| `rankby` | `rankPreference` | |\n| | `regionCode` | New parameter. |\n| `type` | `includedTypes` `excludedTypes` `includedPrimaryTypes` `excludedPrimaryTypes` | The new parameters also accept multiple type values. The legacy API only accepts a single value. |\n\nExample request\n---------------\n\nThe following example GET request uses the Nearby Search (Legacy). In this\nexample, you request a JSON response containing information about places of type\n`restaurant` and pass all parameters as URL parameters: \n\n```curl\ncurl -L -X GET \\\n'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'\n```\n\nWith Nearby Search (New), you make a POST request and pass all\nparameters in the JSON request body or in headers as part of the POST request.\nThis example also uses a field mask so the response only includes the display\nname and formatted address of the place: \n\n```curl\ncurl -X POST -d '{\n \"includedTypes\": [\"restaurant\"],\n \"locationRestriction\": {\n \"circle\": {\n \"center\": {\n \"latitude\": 37.7937,\n \"longitude\": -122.3965},\n \"radius\": 500.0\n }\n }\n}' \\\n-H 'Content-Type: application/json' -H \"X-Goog-Api-Key: API_KEY\" \\\n-H \"X-Goog-FieldMask: places.displayName,places.formattedAddress\" \\\nhttps://places.googleapis.com/v1/places:searchNearby\n```"]]
