Panoramica dell'API Places (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

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 seguente tabella 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). È stata sostituita dalla ricerca di testo (nuova).
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 (nuovo).

Eseguire la migrazione alle nuove API

Per eseguire la migrazione alle nuove API, consulta le seguenti guide alla migrazione:

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 in Table 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.