Riferimento rapido all'API Places (legacy)

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

API Places (legacy): errori comuni

  • Problema: se una richiesta Place Details (Legacy) omette il parametro fields o non specifica campi, l'API restituisce tutti i campi e ti addebita il costo di tutti i campi. Correzione: imposta sempre il parametro fields o 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 fields per richiedere e pagare solo i campi necessari. Consulta /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku.
  • Problema: un photo_reference non può essere memorizzato nella cache e può scadere, quindi i riferimenti archiviati smettono di funzionare. Correzione: ottieni un nuovo photo_reference da 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_DENIED con 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: campo business_status. Consulta la guida alla migrazione.
  • Campo di risposta reference: deprecato dal 3 settembre 2019. Sostituzione: campo place_id. Consulta la guida alla migrazione.
  • Parametro di richiesta di Nearby Search (Legacy) name: deprecato. Sostituzione: parametro keyword. Consulta la guida alla migrazione.