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
• Create a project
• 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.

Create a project

Configure a project, which is a container for storing HERE platform resources that are essential for building an app or a service.

1. Sign in to the HERE platform using your HERE account.
2. In the Launcher pane, click Projects Manager.
3. On the Projects Manager page, click Create new project.
4. Enter the following project details:
   1. In the Name field, enter a name for your project. Project names do not have to be unique.
   2. In the Project ID field, enter a unique project identifier. You cannot modify this parameter after you create a project.
   3. Optional: To provide a meaningful description for the new project, fill in the Description field.

      Note

      Follow the on-screen instructions for naming conventions, character length, and allowed characters.

   4. Confirm your settings by clicking Save.
      Result: A new project automatically opens with the settings that you entered.
5. In the project that you just created, on the Resources tab, select Services, and then click Link a Service.
6. In the Link a service window, search for the HERE Raster Tile service, and then click Link.
7. Confirm your settings by clicking Done.

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. From the Launcher pane, select Access Manager.
5. On the Access Manager page, click the Apps tab.
6. On the Apps tab, click Register new app.
7. 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, define the scope of the new app:
      • To allow your app to access all location service APIs, select No project.
      • To restrict your application to access only the location service APIs that a specific project includes, select that project from the list.
   4. Optional: If you restricted the application scope to a single project, to track and report on this app's resource usage by project when using API keys, select Allow access only in this project. For more information, see Manage projects.
   5. Click Register. The HERE platform creates a new app with a unique app ID.
8. 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 raster 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 raster 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 pre-rendered 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.