Panoramica dell'API Places (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

L'API Places consente di cercare e recuperare informazioni per una varietà di tipi di luoghi utilizzando una stringa di testo o in base alla vicinanza. L'API Places (legacy) è la versione precedente dell'API Places (novità).

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 (novità).

API Places (legacy) API Places (novità) Note
Trova luogo (legacy) Ricerca testuale (novità) Non esiste una nuova versione di Trova luogo (legacy). È stata sostituita da Ricerca testuale (novità).
Nearby Search (legacy) Nearby Search (novità) Tutte le richieste che utilizzano l'API legacy e includono una query di testo devono utilizzare Ricerca testuale (novità) perché Nearby Search (novità) non supporta l'input di testo.
Ricerca testuale (legacy) Ricerca testuale (novità)
Place Details (legacy) Place Details (novità)
Place Photos (legacy) Place Photos (novità)
Place Autocomplete (legacy) Autocomplete (novità)
Query Autocomplete (legacy) Autocomplete (novità) Funzionalità aggiunte a Autocomplete (novità).

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 (novità)

Questa sezione illustra le funzionalità chiave aggiunte all'API Places (novità).

Implementazione sulla piattaforma standard di Google Cloud

L'API Places (novità) è 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 (novità).

Prestazioni migliorate

L'API Places (novità) offre prestazioni migliorate, il che rende utile sostituire le app che utilizzano l'API Places esistente.

Prezzo semplificato

I prezzi sono semplificati con l'API Places (novità), in modo che tu paghi solo per i dati che utilizzi. I prezzi semplificati vengono implementati utilizzando una maschera di campo.

Con Place Details (novità), Nearby Search (novità) e Ricerca testuale (novità) utilizzi la maschera di campo per controllare l'elenco dei campi da restituire nella risposta. Ti verranno addebitati solo i dati richiesti. L'utilizzo della maschera di campo è una buona pratica di progettazione per assicurarti di non richiedere 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 (novità) 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 elencato in Tabella A.

La nuova API include anche diversi nuovi tipi. Puoi utilizzare questi nuovi tipi e i tipi esistenti in una ricerca con Nearby Search (novità) e Ricerca testuale (novità). I nuovi tipi sono tutti inclusi in Tabella A.

Dati dinamici sui luoghi

L'API Places (novità) supporta i dati di risposta dinamici, come la disponibilità di una stazione di ricarica EV o gli ultimi prezzi del carburante per una stazione di servizio. Utilizza questi campi di risposta per creare esperienze utente dinamiche.