Introduzione
L'API Places ti consente di cercare e recuperare informazioni per una varietà di tipi di luoghi utilizzando una stringa di testo o in base alla prossimità. 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 versioni ed eseguire la migrazione all'API Places (nuova).
| API Places (legacy) | API Places (Novità) | Note |
|---|---|---|
| Find Place (Legacy) | Text Search (New) | Non esiste una nuova versione di Find Place (Legacy). È stata sostituita da Ricerca testuale (New). |
| Nearby Search (Legacy) | Nearby Search (New) | Tutte le richieste che utilizzano l'API precedente e includono una query di testo devono utilizzare Ricerca testuale (nuova), perché Nearby Search (nuova) non supporta l'inserimento di testo. |
| Ricerca testuale (legacy) | Text Search (New) | |
| Place Details (Legacy) | Place Details (New) | |
| Place Photos (Legacy) | Place Photos (New) | |
| Place Autocomplete (Legacy) | Autocomplete (New) | |
| Query Autocomplete (Legacy) | Autocomplete (New) | Funzionalità aggiunte ad Autocomplete (New). |
Esegui la migrazione alle nuove API
Per eseguire la migrazione alle nuove API, consulta le seguenti guide alla migrazione:
- Esegui la migrazione a Nearby Search (New)
- Esegui la migrazione a Ricerca testuale (Nuovo)
- Esegui la migrazione a Place Details (New)
- Esegui la migrazione a Place Photos (New)
- Esegui la migrazione ad Autocomplete (New)
Funzionalità principali aggiunte all'API Places (nuova)
Questa sezione illustra le funzionalità principali aggiunte all'API Places (nuova).
Implementato sulla piattaforma standard di Google Cloud
L'API Places (nuova) è implementata nell'infrastruttura di servizi su Google Cloud. Questa implementazione offre una piattaforma più sicura e affidabile con opzioni di sicurezza avanzate come OAuth. Questo design standard delle API offre un livello di coerenza tra le API che migliora l'efficienza dello sviluppo con l'API Places (nuova).
Prestazioni migliorate
L'API Places (nuova) offre prestazioni migliorate, il che rende conveniente 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 Place Details (New), Nearby Search (New) e Ricerca testuale (New) utilizzi la maschera di campo per controllare l'elenco di campi da restituire nella risposta. Ti verranno addebitati solo i dati richiesti. L'utilizzo del mascheramento dei campi è una buona pratica di progettazione per garantire che non vengano richiesti dati non necessari, il che aiuta a evitare tempi di elaborazione e addebiti di fatturazione non necessari.
Dati di risposta coerenti per un luogo
Con le API legacy, le API Place Details (Legacy), Nearby Search (Legacy) e Ricerca testuale (Legacy) restituivano dati di risposta diversi per un luogo. L'API Places (nuova) 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, oltre a quelli esistenti, in una ricerca con Nearby Search (New) e Ricerca testuale (New). I nuovi tipi sono tutti inclusi nella Tabella A.
Dati dinamici sui luoghi
L'API Places (nuova) supporta i dati di risposta dinamici, 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.