Stay organized with collections Save and categorize content based on your preferences.
Datasets let you upload geospatial data from a local file or from Google Cloud Storage to the Google Maps Platform. You can then associate a dataset with one or more map styles in the Cloud console. After associating the dataset with a maps style, use the data-driven styling API to dynamically style your maps application.
You can also use a REST API to upload your geospatial data to a dataset. For more information, see Maps Datasets API
Configure rolesTo create and manage datasets in a Google Cloud project, you must hold either the Owner or Editor IAM role on the project.
Note: If you created the project, then you have the Owner role on the project. The IAM page of the Google Cloud console shows the project owners and editors.Alternatively, you can assign the following IAM roles to a user account or service account that you use to manage datasets:
Maps Platform Datasets Admin
role grants the user or services account read/write access to datasets in the project. This role lets the user perform all operations on a dataset.Maps Platform Datasets Viewer
role grants read-only access to datasets in the project. This role lets you perform a list, get, or download operation on a dataset.For more information, see Grant an IAM role by using the Google Cloud console.
Data source for a datasetAfter you create a dataset, upload the data to the dataset from
Google Cloud Storageor from a local file.
When uploading data from Cloud Storage, specify the file path to the resource containing the data in Cloud Storage. This path is in the form gs://GCS_BUCKET/FILE
.
The user making the request requires the Storage Object Viewer role, or any other role that includes the storage.objects.get
permission. For more information about managing access to Cloud Storage, see Overview of access control.
When creating a dataset:
When uploading data:
If your source data is complex or large, such as dense points, long linestrings or polygons (often source file sizes larger than 50 MB fall into this category), consider simplifying your data before uploading to achieve the best performance in a visual map.
Here are some best practices for preparing your data:
See additional guidance about datasets best practices in Visualize your data with Datasets and BigQuery.
GeoJSON requirementsMaps JavaScript API supports the current GeoJSON specification. Maps JavaScript API also support GeoJSON files that contain any of the following object types:
Maps JavaScript API does not support GeoJSON files that have data in a coordinate reference system (CRS) other than WGS84.
For more information on GeoJSON, see RFC 7946 compliant.
KML requirementsMaps JavaScript API has the following requirements:
The following KML features are not supported:
<styleUrl>
defined outside of the file.<NetworkLink>
<GroundOverlay>
<altitudeMode>
<LookAt>
For CSV files, the supported column names are listed below in order of priority:
latitude
, longitude
lat
, long
x
, y
wkt
(Well-Known Text)address
, city
, state
, zip
address
1600 Amphitheatre Parkway Mountain View, CA 94043
For example, your file contains columns named x
, y
, and wkt
. Because x
and y
have a higher priority, as determined by the order of supported column names in the list above, the values in the x
and y
columns are used and the wkt
column is ignored.
In addition:
xy
that contains both x and y coordinate data. The x and y coordinates must be in separate columns.lat
and long
columns, they can occur in any order.When uploading data to a dataset, you might experience one of the common errors described in this section.
GeoJSON errorsCommon GeoJSON errors include:
type
field, or the type
is not a string. The uploaded GeoJSON data file must contain a string field named type
as part of each Feature object and Geometry object definition.Common KML errors include:
Common CSV errors include:
latitude
, longitude
lat
, long
x
, y
wkt
address
, city
, state
, zip
address
1600 Amphitheatre Parkway Mountain View, CA 94043
x
and y
are your geometry columns, ensure that the units are longitude and latitude. Some public datasets use different coordinate systems under the headers x
and y
. If the wrong units are used, the dataset might import successfully, but the rendered data can show the dataset points in unexpected locations.To create a dataset:
Click Create. The Datasets page appears showing your new dataset. The status should be Processing.
If the data uploads successfully:
If there is an error in the upload:
After you create a dataset, you can view or modify the dataset:
Click the Import Data File button to upload new data to the dataset.
Uploading new data to the dataset creates a new version of the dataset. If the new data uploads successfully:
If there is an error in the upload:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-09 UTC."],[[["Google Maps Platform Datasets enable dynamic map styling by uploading custom geospatial data from local files or Google Cloud Storage."],["Datasets require specific user roles for management and support various file formats like GeoJSON, KML, and CSV with defined prerequisites for data structure and size."],["Data preparation is crucial for optimal performance, involving simplifying geometries, minimizing feature properties, and using simple data types."],["CSV, GeoJSON, and KML files have specific requirements for data structure and supported features to ensure successful data uploads."],["Creating, viewing, and modifying datasets can be managed through the Google Cloud console, providing tools for data upload, preview, and attribute examination."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4