Request your first tile

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

Obtain access to the HERE platform through your organization administrator's invitation or get started for free.

• 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 hasn’t established a HERE platform organization yet, you can get started for free. 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 Create new app.

4. In the Create new app window, provide the details for the new app:

   1. In the App name field, enter your app name.
   2. Optional: In the App description field, provide a meaningful description of your app.
   3. Click Create app. 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 the process of 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 raster tile grid coordinates. For more information, see Understand tile coordinates.

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:

   HTTP

   GET https://maps.hereapi.com/v3/base/mc/7/69/49/png?apiKey={YOUR_API_KEY}

   where:

   • base is the layer available for the raster tile
   • 7 is the zoom level
   • 69 is the column grid coordinate
   • 49 is the row grid coordinate

   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 pre-rendered raster tile image for the map grid coordinates that you requested, as shown in the following example:

   

Next steps

• For information on how to customize tile appearance, see the API Reference and other sections of this guide.
• For information how to integrate raster tiles with web SDKs for map rendering, see Integrate raster maps with frameworks.