Create a map resource

Before you can display an interactive map, begin by creating a map resource. You can use the Amazon Location console, the AWS CLI, or the Amazon Location APIs to do this:

Important

If you're using Tangram styles in the following tutorial, note that they're only compatible with Amazon Location map resources configured with the VectorHereBerlin style.

Console

To create a map resource using the Amazon Location console

1. Open the Amazon Location console at https://console.aws.amazon.com/location/.

2. In the left navigation pane, choose Maps.

3. Choose Create map.

4. Fill out the following boxes:

   • Name – Enter a unique name. For example, ExampleMap. Maximum 100 characters. Valid entries include alphanumeric characters, hyphens, periods, and underscores.

   • Description – Enter an optional description.

5. In the available list, select a map.

6. Choose Add map.

API

To create a map resource using the Amazon Location APIs

Use the CreateMap action from the Amazon Location Maps APIs.

The following example is an API request to create a map resource called ExampleMap using the VectorEsriNavigation map style, and a request-based usage pricing plan.

Note

During the preview period, you will not incur Amazon Location Service charges for the use of the service. You may incur fees for the use of other AWS services. For additional information on pricing, see the Amazon Location service page.

POST /maps/v0/maps
Content-type: application/json

{
   "Configuration": { 
      "Style": "VectorEsriNavigation"
   },
   "Description": "Esri Dark Gray Canvas",
   "MapName": "ExampleMap",
   "PricingPlan": "RequestBasedUsage"
}

AWS CLI

To create a map resource using AWS CLI commands

Use the create-map command.

The following example is an AWS CLI to create a map resource called ExampleMap using the VectorEsriNavigation map style, and a request-based usage pricing plan.

Note

During the preview period, you will not incur Amazon Location Service charges for the use of the service. You may incur fees for the use of other AWS services. For additional information on pricing, see the Amazon Location service page.

aws location \
  create-map \
  --map-name "ExampleMap" \
  --configuration "Style=VectorEsriNavigation" \
  --pricing-plan "RequestBasedUsage"