Get started

Gain hands-on experience of working with the HERE Raster Tile API by configuring the HERE platform to process your first request.

• Get a HERE account
• Get an API key
• Obtain a tile
• Next steps

Get a HERE account

Obtain access to the HERE platform through the organization admin's invitation or by creating a free trial account.

Perform one of the following actions:

• If your company has already established a HERE platform organization, contact your organization admin who can invite you to join the organization.
• If your company has not established a HERE platform organization yet, request a free trial. For more information, see the HERE platform pricing.

Get an API key

Register an app and create a unique API key for authenticating your requests to the HERE platform.

1. From the Launcher pane, select Access Manager.
2. On the Access Manager page, click the Apps tab.
3. On the Apps tab, click Register new app.
4. In the Register new app window, provide the details for the new app:
   1. In the Name field, enter your app name.
   2. Optional: To provide a meaningful description for your new app, fill in the Description field.
   3. In the Default access to a project field, select No project.
   4. Click Register. The HERE platform creates a new app with a unique app ID.
5. On your app page, generate up to two API keys:
   1. On the Credentials tab, select API Keys and, then click Create API Key. The HERE platform displays the API key that you created with the enabled status.
   2. Optional: To add an extra API key, click Create API key.

The following figure provides a visual summary for generating API keys:

Obtain a tile

Request a raster map tile, which is a pre-rendered image of a specific area of a map.

1. Choose any location on which to center the tile, and then note down the location latitude and longitude coordinates.

2. Convert the latitude and longitude into column and row vector tile grid coordinates. For more information, see Mercator Projection.

3. Build a GET request to obtain the tile that centers on the coordinates of the location that you chose.

   Consider the following request example for a vector tile that centers on Cape Town:

      curl "https://maps.hereapi.com/v3/base/mc/9/282/307/png?apiKey={API_KEY}"
   

   where:

   • base is the layer available for the raster tile
   • 9 is the zoom level
   • 282 is the column grid coordinate
   • 307 is the row grid coordinate

   For more information, see API Reference.

   Note

   The sample request uses the API key for authentication. For more information on OAuth token authentication, see the Identity & Access Management Developer Guide.

4. Send the request. For example, you can use the Postman tool.

   Result: A successful server response with code 200 includes a prerendered raster tile image for the map grid coordinates that you requested, as shown in the following example:

   

Next steps

• For examples to help you adjust map data to your specific needs, see the Tutorials section of this guide.
• For the terms and conditions covering this documentation, see the HERE Documentation License.