In this guide, you will learn the basics of visualizing a CARTO layer with the Amazon Location service. There are no previous requirements to complete this guide, but a basic knowledge of web development would be helpful.
After completing this guide, you will have your first Amazon Location map with a CARTO dataset!
Basic setup
There are two main steps for visualizing a CARTO layer: first you need to create a map resource in your AWS account followed by the creation of a web application that uses a rendering library to visualize the map with the corresponding CARTO layer.
For this guide, we have already created a map resource called “Rivers” in our AWS account. If you want to create your own map resource, you can follow the instructions from the Amazon Developer Guide.
In this documentation we use the term “CARTO 3” or “Maps API v3” to refer to the latest version of the CARTO platform launched on October 2021, and “CARTO 2” to refer to the previous version. We provide examples for both versions and we add notes when there are differences in the way you need to work with each of them. Note that each platform version has its own set of account credentials.
By providing your own CARTO map id you can load in any maps you have created in CARTO Builder, with all of the styling preconfigured.
async function initializeMap() {
...
const cartoMapId = 'ff6ac53f-741a-49fb-b615-d040bc5a96b8';
const {layers} = await deck.carto.fetchMap({cartoMapId});
const deckOverlay = new deck.MapboxOverlay({layers});
}
Finally we need to add the layer to the map:
async function initializeMap() {
...
map.addControl(deckOverlay);
}
