L'API d'ensembles de données Maps est actuellement en version preview (pré-DG). La prise en charge des fonctionnalités et produits pré-DG peut être limitée, et les modifications apportées à ces fonctionnalités ou produits peuvent ne pas être compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques au service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page a été traduite par l'API Cloud Translation.

Paramètres de requête obligatoires

Pour envoyer une requête à l'API Maps Datasets, vous devez inclure:

Le numéro ou l'ID de votre projet Google Cloud dans le En-tête X-Goog-User-Project de la requête. Cette valeur détermine projet utilisé pour la facturation et le calcul des quotas d'utilisation.

Remarque :Si vous utilisez un compte de service pour l'authentification, vous pouvez omettre l'en-tête X-Goog-User-Project. Pour en savoir plus sur des comptes de service, consultez Authentification chez Google.
Un jeton OAuth dans l'en-tête Authorization de la requête Pour plus sur l'utilisation d'OAuth avec l'API Maps Datasets, consultez Utiliser OAuth.
Un numéro ou un ID de projet Google Cloud dans l'URL de la requête. Cette valeur spécifie le projet contenant l'ensemble de données. Bien que ce projet soit généralement identique au projet spécifié dans l'en-tête X-Goog-User-Project, il ne doit pas nécessairement être identique.
ID de l'ensemble de données dans l'URL de la requête. Chaque fois que vous effectuez une action un ensemble de données spécifique, vous transmettez son ID dans l'URL de la requête.

Par exemple, pour supprimer un ensemble de données:

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

Obtenir le numéro du projet

Pour obtenir le PROJECT_NUMBER_OR_ID de votre projet Google Cloud:

Accédez à l'onglet Page Vue d'ensemble dans la console Cloud.
Si vous y êtes invité, sélectionnez votre projet.
Le numéro du projet et l'ID du projet apparaissent dans la section Informations sur le projet. de l'écran "Overview" (Aperçu).

Obtenir un jeton OAuth

Pour l'authentification, votre requête API doit contenir un jeton OAuth dans En-tête Authorization. Pour en savoir plus, consultez Utiliser OAuth.

Par exemple, utilisez la commande gcloud suivante pour générer le jeton:

gcloud auth application-default print-access-token

Vous pouvez inclure la commande gcloud directement dans l'en-tête Authorization dans une cURL pour générer un nouveau jeton pour chaque requête, comme illustré dans l'exemple ci-dessus.

Vous pouvez également définir une variable d'environnement contenant le jeton, puis transmettez la variable d'environnement dans la requête:

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