L'API Places ti consente di cercare e recuperare informazioni su vari tipi di luoghi utilizzando una stringa di testo o in base alla vicinanza. L'API Places è la versione precedente dell'API Places (nuova).
La tabella seguente elenca le versioni corrispondenti di entrambe le API. Consulta questa guida per comprendere le principali differenze tra le due API e eseguire la migrazione all'API Places (nuova).
| API Places (legacy) | API Places (Novità) | Note |
|---|---|---|
| Trova posto (legacy) | Ricerca di testo (novità) | Non è disponibile una nuova versione di Trova posto. La ricerca di testo (nuova) lo ha sostituito. |
| Ricerca nelle vicinanze (legacy) | Ricerca nelle vicinanze (novità) | Tutte le richieste che utilizzano l'API precedente e includono una query di testo devono utilizzare Ricerca di testi (nuova) perché la Ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
| Ricerca di testo (legacy) | Ricerca di testo (novità) | |
| Dettagli dei luoghi (legacy) | Place Details (versione nuova) | |
| Foto in un luogo (legacy) | Inserisci foto (nuova) | |
| Completamento automatico dei luoghi (legacy) | Completamento automatico (novità) | |
| Completamento automatico delle query (legacy) | Completamento automatico (novità) | Funzionalità aggiunte al completamento automatico (novità). |
Esegui la migrazione alle nuove API
Per eseguire la migrazione alle nuove API, consulta le seguenti guide alla migrazione:
- Eseguire la migrazione alla Ricerca nelle vicinanze (novità)
- Eseguire la migrazione alla ricerca di testo (novità)
- Eseguire la migrazione a Place Details (novità)
- Eseguire la migrazione a Foto Ricordo (nuova)
- Eseguire la migrazione a Completamento automatico (novità)
Funzionalità principali aggiunte all'API Places (novità)
Questa sezione illustra le funzionalità principali aggiunte all'API Places (novità).
Implementato sulla piattaforma standard di Google Cloud
L'API Places (nuova) è implementata nell'infrastruttura del servizio su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile con opzioni di sicurezza avanzate come OAuth. Questo design dell'API standard offre un livello di coerenza tra le API che migliora l'efficienza dello sviluppo con la nuova API Places.
Prestazioni migliorate
L'API Places (nuova) offre un rendimento migliore, quindi vale la pena sostituire le app che utilizzano l'API Places esistente.
Prezzi semplificati
I prezzi sono semplificati con l'API Places (nuova) in modo da pagare solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando una maschera di campo.
Con i comandi Dettagli dei luoghi (novità), Ricerca nelle vicinanze (novità) e Ricerca di testo (novità), puoi utilizzare la maschera dei campi per controllare l'elenco dei campi da restituire nella risposta. Ti verranno addebitati solo i dati richiesti. L'utilizzo della maschera dei campi è una buona prassi di progettazione per assicurarti di non richiedere dati non necessari, il che consente di evitare tempi di elaborazione e addebiti in fatturazione non necessari.
Dati coerenti sulle risposte per un luogo
Con le API esistenti, le API Place Details, Nearby Search e Text Search restituivano dati di risposta diversi per un luogo. L'API Places (nuova) standardizza la risposta in modo che queste API restituiscano tutte gli stessi dati per un luogo.
Tipi di luoghi espansi
La risposta dell'API ora può contenere il tipo principale di un luogo. Ogni luogo può avere un singolo valore di tipo specificato come tipo principale del luogo, come indicato nella Tabella A.
La nuova API include anche diversi nuovi tipi. Puoi utilizzare questi nuovi tipi e quelli esistenti in una ricerca con Ricerca nelle vicinanze (novità) e Ricerca di testo (novità). I nuovi tipi sono tutti inclusi nella Tabella A.
Dati sui luoghi dinamici
L'API Places (nuova) supporta i dati di risposta dinamica, come la disponibilità di una stazione di ricarica EV o i prezzi più recenti del carburante per una stazione di servizio. Utilizza questi campi di risposta per creare esperienze utente dinamiche.