Introduzione
L'API Places consente di cercare e recuperare informazioni per una serie di tipi di luoghi utilizzando una stringa di testo o in base alla vicinanza. L'API Places (legacy) è la versione precedente dell'API Places (New).
La tabella seguente elenca le versioni corrispondenti di entrambe le API. Utilizza questa guida per comprendere le principali differenze tra le due API ed eseguire la migrazione all'API Places (New).
| API Places (legacy) | API Places (Novità) | Note |
|---|---|---|
| Find Place (legacy) | Ricerca di testo (novità) | Non è disponibile una nuova versione di Trova luogo (legacy). La ricerca di testo (nuova) l'ha sostituita. |
| Ricerca nelle vicinanze (legacy) | Ricerca nelle vicinanze (novità) | Tutte le richieste che utilizzano l'API precedente e che includono una query di testo devono utilizzare Ricerca di testo (nuova) perché Ricerca nelle vicinanze (nuova) non supporta l'input di testo. |
| Ricerca di testo (legacy) | Ricerca di testo (novità) | |
| Place Details (Legacy) | Place Details (New) | |
| Place Photos (legacy) | Place Photos (New) | |
| Place Autocomplete (legacy) | Completamento automatico (novità) | |
| Query Autocomplete (legacy) | Completamento automatico (novità) | Funzionalità aggiunte al completamento automatico (novità). |
Eseguire 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à)
- Esegui la migrazione alla ricerca testuale (novità)
- Eseguire la migrazione a Place Details (novità)
- Eseguire la migrazione a Place Photos (novità)
- Eseguire la migrazione al completamento automatico (novità)
Funzionalità chiave aggiunte all'API Places (New)
Questa sezione descrive le funzionalità chiave aggiunte all'API Places (New).
Implementato sulla piattaforma standard Google Cloud
L'API Places (New) è implementata nell'infrastruttura di servizio su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile con opzioni di sicurezza avanzate come OAuth. Questo design API standard offre un livello di coerenza tra le API che migliora l'efficienza dello sviluppo con l'API Places (New).
Prestazioni migliorate
La nuova API Places offre prestazioni migliorate, il che rende utile sostituire le app che utilizzano l'API Places esistente.
Prezzi semplificati
I prezzi sono semplificati con l'API Places (New), in modo da pagare solo per i dati che utilizzi. Il prezzo semplificato viene implementato utilizzando una maschera di campo.
Con Place Details (New), Nearby Search (New) e Text Search (New), utilizzi la maschera del campo per controllare l'elenco dei campi da restituire nella risposta. In questo modo, ti verranno addebitati solo i dati richiesti. L'utilizzo della maschera dei campi è una buona pratica di progettazione per assicurarsi di non richiedere dati non necessari, il che contribuisce a evitare tempi di elaborazione e addebiti non necessari.
Dati di risposta coerenti per un luogo
Con le API legacy, le API Place Details (legacy), Nearby Search (legacy) e Text Search (legacy) restituivano dati di risposta diversi per un luogo. L'API Places (New) standardizza la risposta in modo che tutte queste API restituiscano 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 elencato nella tabella A.
La nuova API include anche diversi nuovi tipi. Puoi utilizzare questi nuovi tipi, nonché quelli esistenti, in una ricerca con Ricerca nelle vicinanze (nuova) e Ricerca di testo (nuova). I nuovi tipi sono tutti inclusi nella Tabella A.
Dati luogo dinamici
L'API Places (nuova) supporta dati di risposta dinamici, come la disponibilità di una stazione di ricarica per veicoli elettrici o gli ultimi prezzi del carburante per una stazione di servizio. Utilizza questi campi di risposta per creare esperienze utente dinamiche.