Google Maps Engine API

API Reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

Resource types

  1. Assets
  2. Layers
  3. Maps
  4. Projects
  5. RasterCollections
  6. RasterCollections.rasters
  7. Rasters
  8. Tables
  9. Tables.features
  10. Rasters.files
  11. Tables.files
  12. Assets.parents
  13. Layers.parents
  14. RasterCollections.parents
  15. Rasters.parents
  16. Tables.parents

Assets

For Assets Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
get GET  /assets/id Return metadata for a particular asset.
list GET  /assets Return all assets readable by the current user.

Layers

For Layers Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
create POST  /layers Create a layer asset.
get GET  /layers/id Return metadata for a particular layer.
list GET  /layers Return all layers readable by the current user.
process POST  /layers/id/process Process a layer asset.
publish POST  /layers/id/publish Publish a layer asset.

Maps

For Maps Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
get GET  /maps/id Return metadata for a particular map.
list GET  /maps Return all maps readable by the current user.

Projects

For Projects Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /projects Return all projects readable by the current user.

RasterCollections

For RasterCollections Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
create POST  /rasterCollections Create a raster collection asset.
get GET  /rasterCollections/id Return metadata for a particular raster collection.
list GET  /rasterCollections Return all raster collections readable by the current user.

RasterCollections.rasters

For RasterCollections.rasters Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /rasterCollections/id/rasters Return all rasters within a raster collection.

Rasters

For Rasters Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
get GET  /rasters/id Return metadata for a single raster.
upload POST  /rasters/upload Create a skeleton raster asset for upload.

Tables

For Tables Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
create POST  /tables Create a table asset.
get GET  /tables/id Return metadata for a particular table, including the schema.
list GET  /tables Return all tables readable by the current user.
upload POST  /tables/upload Create a placeholder table asset to which table files can be uploaded.

Once the placeholder has been created, files are uploaded to the https://www.googleapis.com/upload/mapsengine/v1/tables/table_id/files endpoint.

See Table Upload in the Developer's Guide or Table.files: insert in the reference documentation for more information.

Tables.features

For Tables.features Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
batchDelete POST  /tables/id/features/batchDelete Delete all features matching the given IDs.
batchInsert POST  /tables/id/features/batchInsert

Append features to an existing table.

A single batchInsert request can create:

  • Up to 50 features.
  • A combined total of 10 000 vertices.

Feature limits are documented in the Supported data formats and limits article of the Google Maps Engine help center. Note that free and paid accounts have different limits.

For more information about inserting features, read Creating features in the Google Maps Engine developer's guide.

batchPatch POST  /tables/id/features/batchPatch

Update the supplied features.

A single batchPatch request can update:

  • Up to 50 features.
  • A combined total of 10 000 vertices.

Feature limits are documented in the Supported data formats and limits article of the Google Maps Engine help center. Note that free and paid accounts have different limits.

Feature updates use HTTP PATCH semantics:

  • A supplied value replaces an existing value (if any) in that field.
  • Omitted fields remain unchanged.
  • Complex values in geometries and properties must be replaced as atomic units. For example, providing just the coordinates of a geometry is not allowed; the complete geometry, including type, must be supplied.
  • Setting a property's value to null deletes that property.

For more information about updating features, read Updating features in the Google Maps Engine developer's guide.

get GET  /tables/tableId/features/id Return a single feature, given its ID.
list GET  /tables/id/features Return all features readable by the current user.

Rasters.files

For Rasters.files Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
insert POST
https://www.googleapis.com/upload/mapsengine/v1/rasters/id/files
Upload a file to a raster asset.

Required query parameters: filename

Tables.files

For Tables.files Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
insert POST
https://www.googleapis.com/upload/mapsengine/v1/tables/id/files
Upload a file to a placeholder table asset. See Table Upload in the Developer's Guide for more information.

Supported file types are listed in the Supported data formats and limits article of the Google Maps Engine help center.

Required query parameters: filename

Assets.parents

For Assets.parents Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /assets/id/parents Return all parent ids of the specified asset.

Layers.parents

For Layers.parents Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /layers/id/parents Return all parent ids of the specified layer.

RasterCollections.parents

For RasterCollections.parents Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /rasterCollections/id/parents Return all parent ids of the specified raster collection.

Rasters.parents

For Rasters.parents Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /rasters/id/parents Return all parent ids of the specified rasters.

Tables.parents

For Tables.parents Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/mapsengine/v1, unless otherwise noted
list GET  /tables/id/parents Return all parent ids of the specified table.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.