L'API Maps Datasets è attualmente in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina è stata tradotta dall'API Cloud Translation.

Parametri di richiesta obbligatori

Per effettuare qualsiasi richiesta all'API Maps Datasets, devi includere:

Il numero o l'ID del tuo progetto Google Cloud nella Intestazione X-Goog-User-Project della richiesta. Questo valore determina progetto utilizzato per il calcolo della fatturazione e delle quote di utilizzo.

Nota: se utilizzi un account di servizio per l'autenticazione, puoi omettere l'intestazione X-Goog-User-Project. Per ulteriori informazioni gli account di servizio, vedi Autenticazione in Google.
Un token OAuth nell'intestazione Authorization della richiesta. Per maggiori informazioni informazioni sull'utilizzo di OAuth con l'API Maps Datasets, consulta Utilizzare OAuth.
Un numero di progetto Google Cloud o un ID nell'URL della richiesta. Questo valore specifica il progetto contenente il set di dati. Sebbene questo progetto sia di solito uguale al progetto specificato nell'intestazione X-Goog-User-Project, non è necessario che siano uguali.
L'ID del set di dati nell'URL della richiesta. Ogni volta che esegui un'azione su una un set di dati specifico, passi l'ID del set di dati come parte dell'URL della richiesta.

Ad esempio, per eliminare un set di dati:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Recupera il numero del progetto

Per ottenere PROJECT_NUMBER_OR_ID del tuo progetto Google Cloud:

Vai alla sezione del progetto Pagina Panoramica nella console Cloud.
Se richiesto, seleziona il progetto.
Il numero di progetto e l'ID del progetto vengono visualizzati nella sezione Informazioni sul progetto della schermata Panoramica.

Ottenere un token OAuth

Per l'autenticazione, la richiesta API deve contenere un token OAuth nella Intestazione Authorization. Per saperne di più, consulta l'articolo Utilizzare OAuth.

Ad esempio, utilizza il seguente comando gcloud per generare il token:

gcloud auth application-default print-access-token

Puoi includere il comando gcloud direttamente nell'intestazione Authorization in una cURL per generare un nuovo token su ogni richiesta, come mostrato nell'esempio in alto.

In alternativa, puoi impostare una variabile di ambiente contenente il token e quindi passa la variabile di ambiente come parte della richiesta:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID