A partire da ottobre 2026, l'API Places (Legacy) non potrà più essere abilitata per i nuovi progetti Google Cloud. I progetti esistenti rimangono completamente supportati. Per nuove funzionalità e prestazioni migliorate, esegui la migrazione all'API Places (nuova).
API Places (legacy): informazioni chiave
- Prodotto: API Places (legacy)
- Nota anche come: API Places (servizio web legacy), servizio web API Places (maps/api/place)
- Categoria: Luoghi
- Piattaforma: servizio web (REST)
- Esecuzione su: server (codice di backend)
- Fase di lancio: GA
- Ciclo di vita: legacy
- Sostituita da: API Places (nuova)
- Panoramica: Panoramica dell'API Places (Legacy)
API Places (legacy): quando utilizzarla
Utilizza l'API Places (Legacy) quando:
- Gestisci un progetto esistente in cui l'API Places (Legacy) è già abilitata e chiama gli endpoint
maps.googleapis.com/maps/api/place. - Per continuare a funzionare durante la migrazione, devi avere chiamate esistenti di Find Place, Nearby Search, Ricerca testuale, Details, Photos o Autocomplete (Legacy).
Non utilizzare l'API Places (Legacy) quando:
- Stai avviando un nuovo progetto Google Cloud. A partire da ottobre 2026, l'API Places (legacy) non potrà essere abilitata per i nuovi progetti. Utilizza l'API Places (novità).
- Hai bisogno di nuove funzionalità, autenticazione OAuth o maschere di campo per Nearby Search e Ricerca testuale, in modo da pagare solo per i campi richiesti. Utilizza l'API Places (novità).
- Nel nuovo codice è necessario Find Place (Legacy) o Query Autocomplete (Legacy). Ricerca testuale (nuova) e Autocomplete (nuovo) li sostituiscono. Utilizza l'API Places (novità).
API Places (Legacy): configurazione
- Servizio da attivare:
places-backend.googleapis.com - Autenticazione: chiave API
- Prezzi: Utilizzo e fatturazione dell'API Places (Legacy)
- Norme: Norme relative all'API Places (legacy)
API Places (legacy): errori comuni
- Problema: se una richiesta Place Details (Legacy) omette il parametro
fieldso non specifica campi, l'API restituisce tutti i campi e ti addebita il costo di tutti i campi. Correzione: imposta sempre il parametrofieldso esegui la migrazione a Place Details (New) con una maschera di campo. Consulta /maps/documentation/places/web-service/legacy/details. - Problema: Nearby Search (Legacy) e Ricerca testuale (Legacy) non supportano la specifica dei campi da restituire. Restituiscono sempre un insieme fisso di campi (un sottoinsieme di campi di Place Details) e attivano gli SKU Basic Data, Contact Data e Atmosphere Data. Correzione: esegui la migrazione a Nearby Search (New) o Ricerca testuale (New) con una maschera di campo oppure utilizza Trova luogo (Legacy) con il parametro
fieldsper richiedere e pagare solo i campi necessari. Consulta /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - Problema: un
photo_referencenon può essere memorizzato nella cache e può scadere, quindi i riferimenti archiviati smettono di funzionare. Correzione: ottieni un nuovophoto_referenceda una risposta di Place Details, Find Place, Nearby Search o Ricerca testuale prima di richiedere una foto. Consulta la pagina /maps/documentation/places/web-service/legacy/photos. - Problema: le chiamate all'API Places (Legacy) da un progetto in cui non è abilitata restituiscono
REQUEST_DENIEDcon il messaggio di errore "Stai chiamando un'API legacy, che non è abilitata per il tuo progetto…" (LegacyApiNotActivatedMapError). A partire da ottobre 2026, l'API Places (legacy) non potrà essere attivata per i nuovi progetti. Correzione: utilizza l'API Places (nuova) per i nuovi progetti ed esegui la migrazione delle app esistenti. Durante la migrazione, puoi richiedere l'attivazione a breve termine dell'API precedente tramite il modulo di feedback nella pagina precedente. Consulta /maps/legacy#LegacyApiNotActivatedMapError.
API Places (legacy): funzionalità legacy e deprecate
- Campo di risposta
permanently_closed: deprecato dal 26 maggio 2020. Sostituzione: campobusiness_status. Consulta la guida alla migrazione. - Campo di risposta
reference: deprecato dal 3 settembre 2019. Sostituzione: campoplace_id. Consulta la guida alla migrazione. - Parametro di richiesta di Nearby Search (Legacy)
name: deprecato. Sostituzione: parametrokeyword. Consulta la guida alla migrazione.