Hide
Google Maps Engine API (Deprecated)

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. Assets.parents
  3. Assets.permissions
  4. Layers
  5. Layers.parents
  6. Layers.permissions
  7. Maps
  8. Maps.permissions
  9. Projects
  10. Projects.icons
  11. RasterCollections
  12. RasterCollections.parents
  13. RasterCollections.permissions
  14. RasterCollections.rasters
  15. Rasters
  16. Rasters.files
  17. Rasters.parents
  18. Rasters.permissions
  19. Tables
  20. Tables.features
  21. Tables.files
  22. Tables.parents
  23. Tables.permissions

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.

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.

Assets.permissions

For Assets.permissions 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/permissions Return all of the permissions for the specified asset.

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
cancelProcessing POST  /layers/id/cancelProcessing Cancel processing on a layer asset.
create POST  /layers Create a layer asset.
delete DELETE  /layers/id Delete a layer.
get GET  /layers/id Return metadata for a particular layer.
getPublished GET  /layers/id/published Return the published metadata for a particular layer.
list GET  /layers Return all layers readable by the current user.
listPublished GET  /layers/published Return all published layers readable by the current user.
patch PATCH  /layers/id Mutate a layer asset.
process POST  /layers/id/process Process a layer asset.
publish POST  /layers/id/publish Publish a layer asset.
unpublish POST  /layers/id/unpublish Unpublish a layer 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.

Layers.permissions

For Layers.permissions 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  /layers/id/permissions/batchDelete

Remove permission entries from an already existing asset.

batchUpdate POST  /layers/id/permissions/batchUpdate

Add or update permission entries to an already existing asset.

An asset can hold up to 20 different permission entries. Each batchInsert request is atomic.

list GET  /layers/id/permissions Return all of the permissions for the specified 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
create POST  /maps Create a map asset.
delete DELETE  /maps/id Delete a map.
get GET  /maps/id Return metadata for a particular map.
getPublished GET  /maps/id/published Return the published metadata for a particular map.
list GET  /maps Return all maps readable by the current user.
listPublished GET  /maps/published Return all published maps readable by the current user.
patch PATCH  /maps/id Mutate a map asset.
publish POST  /maps/id/publish Publish a map asset.
unpublish POST  /maps/id/unpublish Unpublish a map asset.

Maps.permissions

For Maps.permissions 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  /maps/id/permissions/batchDelete

Remove permission entries from an already existing asset.

batchUpdate POST  /maps/id/permissions/batchUpdate

Add or update permission entries to an already existing asset.

An asset can hold up to 20 different permission entries. Each batchInsert request is atomic.

list GET  /maps/id/permissions Return all of the permissions for the specified asset.

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.

Projects.icons

For Projects.icons 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
https://www.googleapis.com/upload/mapsengine/v1/projects/projectId/icons
Create an icon.
get GET  /projects/projectId/icons/id Return an icon or its associated metadata
list GET  /projects/projectId/icons Return all icons in the current project

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
cancelProcessing POST  /rasterCollections/id/cancelProcessing Cancel processing on a raster collection asset.
create POST  /rasterCollections Create a raster collection asset.
delete DELETE  /rasterCollections/id Delete a raster collection.
get GET  /rasterCollections/id Return metadata for a particular raster collection.
list GET  /rasterCollections Return all raster collections readable by the current user.
patch PATCH  /rasterCollections/id Mutate a raster collection asset.
process POST  /rasterCollections/id/process Process a raster collection asset.

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.

RasterCollections.permissions

For RasterCollections.permissions 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  /rasterCollections/id/permissions/batchDelete

Remove permission entries from an already existing asset.

batchUpdate POST  /rasterCollections/id/permissions/batchUpdate

Add or update permission entries to an already existing asset.

An asset can hold up to 20 different permission entries. Each batchInsert request is atomic.

list GET  /rasterCollections/id/permissions Return all of the permissions for the specified asset.

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
batchDelete POST  /rasterCollections/id/rasters/batchDelete

Remove rasters from an existing raster collection.

Up to 50 rasters can be included in a single batchDelete request. Each batchDelete request is atomic.

batchInsert POST  /rasterCollections/id/rasters/batchInsert

Add rasters to an existing raster collection. Rasters must be successfully processed in order to be added to a raster collection.

Up to 50 rasters can be included in a single batchInsert request. Each batchInsert request is atomic.

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
delete DELETE  /rasters/id Delete a raster.
get GET  /rasters/id Return metadata for a single raster.
list GET  /rasters Return all rasters readable by the current user.

Required query parameters: projectId

patch PATCH  /rasters/id Mutate a raster asset.
process POST  /rasters/id/process Process a raster asset.
upload POST  /rasters/upload Create a skeleton raster asset for upload.

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

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.

Rasters.permissions

For Rasters.permissions 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  /rasters/id/permissions/batchDelete

Remove permission entries from an already existing asset.

batchUpdate POST  /rasters/id/permissions/batchUpdate

Add or update permission entries to an already existing asset.

An asset can hold up to 20 different permission entries. Each batchInsert request is atomic.

list GET  /rasters/id/permissions Return all of the permissions for the specified asset.

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.
delete DELETE  /tables/id Delete a table.
get GET  /tables/id Return metadata for a particular table, including the schema.
list GET  /tables Return all tables readable by the current user.
patch PATCH  /tables/id Mutate a table asset.
process POST  /tables/id/process Process a table asset.
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.

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

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.

Tables.permissions

For Tables.permissions 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/permissions/batchDelete

Remove permission entries from an already existing asset.

batchUpdate POST  /tables/id/permissions/batchUpdate

Add or update permission entries to an already existing asset.

An asset can hold up to 20 different permission entries. Each batchInsert request is atomic.

list GET  /tables/id/permissions Return all of the permissions for the specified asset.