POST

/maps/v0/maps

http://geo.{region}.amazonaws.com/maps/v0/maps

Creates a map resource in your Amazon Web Services account, which provides map tiles of different styles sourced from global location data providers. <note> If your application is tracking or routing assets you use in your business, such as delivery vehicles or employees, you must not use Esri as your geolocation provider. See section 82 of the <a href="http://aws.amazon.com/service-terms">Amazon Web Services service terms</a> for more details. </note>

Access Token Required: API Key

Body Params

Tagsobject

Applies one or more tags to the map resource. A tag is a key-value pair helps manage, identify, search, and filter your resources by labelling them. Format: <code>"key" : "value"</code> Restrictions: <ul> <li> Maximum 50 tags per resource </li> <li> Each resource tag must be unique with a maximum of one value. </li> <li> Maximum key length: 128 Unicode characters in UTF-8 </li> <li> Maximum value length: 256 Unicode characters in UTF-8 </li> <li> Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @. </li> <li> Cannot use "aws:" as a prefix for a key. </li> </ul>

MapNamestringrequired

The name for the map resource. Requirements: <ul> <li> Must contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_). </li> <li> Must be a unique map resource name. </li> <li> No spaces allowed. For example, <code>ExampleMap</code>. </li> </ul>

Descriptionstring

An optional description for the map resource.

PricingPlanstring

No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.

Configurationobjectrequired

Specifies the map tile style selected from an available provider.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://geo.{region}.amazonaws.com/maps/v0/maps' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}