Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les ensembles de données sont des conteneurs pour les données que vous souhaitez utiliser dans vos applications Google Maps Platform dans le cadre du style basé sur les données.
L'API Maps Datasets vous permet de créer et de gérer des ensembles de données à l'aide d'une API REST.
Par exemple, avec le style basé sur les données pour les ensembles de données, vous pouvez importer vos propres données géospatiales dans un ensemble de données, appliquer un style personnalisé aux éléments de données et afficher ces éléments de données sur des cartes. Vous pouvez créer des visualisations de données basées sur des géométries (points, polylignes et polygones) et configurer les éléments géographiques de données pour qu'ils répondent aux événements de clic.
La création d'un ensemble de données se fait en deux étapes :
Envoyez une requête pour créer l'ensemble de données.
Envoyez une requête pour importer des données dans l'ensemble de données depuis votre ordinateur ou Google Cloud Storage. Les données que vous importez doivent être représentées par un fichier CSV, GeoJSON ou KML.
Pour en savoir plus sur l'utilisation des ensembles de données dans le style basé sur les données, consultez les ressources suivantes :
L'API Maps Datasets propose les méthodes suivantes :
Créer un ensemble de données : utilisez le point de terminaison create pour créer un ensemble de données.
Importer des données : utilisez le point de terminaison upload pour importer des données dans votre ensemble de données.
Lister les ensembles de données : utilisez le point de terminaison list pour récupérer la liste de tous les ensembles de données.
Obtenir un ensemble de données : utilisez le point de terminaison get pour récupérer des informations sur un ensemble de données spécifique.
Obtenir les erreurs d'ensemble de données : utilisez le point de terminaison fetchDatasetErrors pour récupérer des informations sur les erreurs d'un ensemble de données.
Mettre à jour un ensemble de données : utilisez le point de terminaison patch pour mettre à jour les informations concernant un ensemble de données spécifique.
Télécharger l'ensemble de données : utilisez le point de terminaison download pour télécharger les données d'un ensemble de données.
Supprimer un ensemble de données : utilisez le point de terminaison delete pour supprimer un ensemble de données.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe Maps Datasets API allows you to create and manage datasets for use with data-driven styling in Google Maps Platform applications, enabling custom visualizations of geospatial data.\u003c/p\u003e\n"],["\u003cp\u003eDatasets can be populated with data from CSV, GeoJSON, or KML files, supporting point, polyline, and polygon geometries for data features.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the API to create, upload data to, list, retrieve information about, update, download data from, and delete datasets.\u003c/p\u003e\n"],["\u003cp\u003eThere is no charge for using the Maps Datasets API.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, you'll need to set up your Google Cloud project and follow the provided instructions for dataset creation and management.\u003c/p\u003e\n"]]],["The Maps Datasets API facilitates the creation and management of datasets for data-driven styling in Google Maps Platform apps. Users can create a dataset via a REST API, then upload geospatial data (CSV, GeoJSON, or KML) from their desktop or Google Cloud Storage. Datasets can be listed, retrieved, updated, downloaded, or deleted using specific API endpoints. The process involves project setup, dataset creation and data upload, and then status retrieval. Using the Maps Datasets API has no charge.\n"],null,["# Maps Datasets API overview\n\nDatasets are containers for data that you want to use in your\nGoogle Maps Platform apps as part of **data-driven styling**.\nMaps Datasets API lets you create and manage datasets using a REST API.\n| **Note:** There is no charge for using the Maps Datasets API.\n\nFor example, with data-driven styling for datasets, you upload your own\ngeospatial data to a dataset, apply custom styling to the data features, and\ndisplay those data features on maps. You can create data visualizations based on\npoint, polyline, and polygon geometries, and make data features respond to click\nevents.\n\nCreating a dataset is a two step process:\n\n1. Make a request to create the dataset.\n\n2. Make a request to upload data to the dataset from your desktop or Google\n Cloud Storage. Your upload data must be represented by a CSV, GeoJSON, or\n KML file.\n\nFor more on using datasets as part of data-driven styling, see:\n\n- [Maps JavaScript API](/maps/documentation/javascript/dds-datasets/overview).\n- [Maps SDK for Android](/maps/documentation/android-sdk/dds-datasets/overview)\n- [Maps SDK for iOS](/maps/documentation/ios-sdk/dds-datasets/overview)\n\nHow the Maps Datasets API works\n-------------------------------\n\nThe Maps Datasets API has the following methods:\n\n- **Create dataset** : Use the\n [create](/maps/documentation/datasets/reference/rest/v1/projects.datasets/create) endpoint\n to create a dataset.\n\n- **Upload data** : Use the [upload](/maps/documentation/datasets/reference/rest/v1/media/upload) endpoint\n to upload data to your dataset.\n\n- **List datasets** : Use the [list](/maps/documentation/datasets/reference/rest/v1/projects.datasets/list)\n endpoint to fetch a list of all datasets.\n\n- **Get dataset** : Use the [get](/maps/documentation/datasets/reference/rest/v1/projects.datasets/get)\n endpoint to retrieve information about a specific dataset.\n\n- **Get dataset errors** : Use the\n [fetchDatasetErrors](/maps/documentation/datasets/reference/rest/v1/projects.datasets/fetchDatasetErrors)\n endpoint to retrieve error information about a dataset.\n\n- **Update dataset** : Use the [patch](/maps/documentation/datasets/reference/rest/v1/projects.datasets/patch)\n endpoint to update information about a specific dataset.\n\n- **Download dataset** : Use the [download](/maps/documentation/datasets/reference/rest/v1/media/download)\n endpoint to download the data from a dataset.\n\n- **Delete dataset** : Use the [delete](/maps/documentation/datasets/reference/rest/v1/projects.datasets/delete)\n endpoint to delete a dataset.\n\nHow to use the Maps Datasets API\n--------------------------------\n\n|---|-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/datasets/cloud-setup) and complete the instructions that follow. |\n| 2 | **Create a dataset and upload your data** | See [Create a dataset](/maps/documentation/datasets/create). |\n| 3 | **Get dataset information and status** | See [Get a dataset](/maps/documentation/datasets/get). |\n\nWhat's next\n-----------\n\n- [Set up your Google Cloud project](/maps/documentation/datasets/cloud-setup)\n- [Use OAuth](/maps/documentation/datasets/oauth-token)"]]
