Creating a Node.js Application for HERE API with OAuth 2.0 Authentication

This guide outlines the creation of a Node.js application that interacts with HERE APIs using OAuth 2.0 for authentication. The example focuses on obtaining an OAuth token from HERE and using it to make a request to the HERE Geocoder API.

Prerequisites
-------------

Node.js installed on your machine.
A HERE platform account with credentials.properties file containing access key ID and secret.

Setting Up Your Project
-----------------------

1. Initialize a new Node.js project:

Create a new directory for your project and initialize it with npm.

 mkdir here-api-projectcd here-api-projectnpm init -y 

Install Dependencies:

Install axios for making HTTP requests and crypto for generating signatures.

 npm install axios 

Note: crypto is a built-in Node.js module, so no installation is required.

Application Structure
---------------------

Your application will consist of several functions responsible for different tasks:

generateOAuthSignature: Generates an OAuth signature required for the authentication request.
getOAuthToken: Retrieves an OAuth token from HERE.
queryGeocoderAPI: Makes a request to the HERE Geocoder API using the obtained OAuth token.
main: Orchestrates the flow by first obtaining a token, then querying the Geocoder API.

Code Explanation
----------------

### Generating OAuth Signature

The generateOAuthSignature function in the attached index.js file creates the signature required for the OAuth token request. It constructs a parameter string, creates a base string, and then generates a HMAC-SHA256 signature.

 function generateOAuthSignature(url, method, params, consumerKey, accessSecret) { const parameterString = Object.keys(params).sort().map(key => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`).join('&'); const baseString = `${method}&${encodeURIComponent(url)}&${encodeURIComponent(parameterString)}`; const signingKey = `${accessSecret}&`; const signature = crypto.createHmac('sha256', signingKey).update(baseString).digest('base64'); return encodeURIComponent(signature);} 

### Obtaining an OAuth Token

The getOAuthToken function requests an OAuth token from HERE using your credentials and the signature generated by generateOAuthSignature.

 async function getOAuthToken() { const params = { oauth_consumer_key: oauthConsumerKey, oauth_nonce: Date.now().toString(), oauth_signature_method: 'HMAC-SHA256', oauth_timestamp: Math.floor(Date.now() / 1000).toString(), oauth_version: '1.0', grant_type: 'client_credentials', }; const encodedSignature = generateOAuthSignature(oauthTokenUrl, 'POST', params, oauthConsumerKey, accessKeySecret); const authHeader = `OAuth oauth_consumer_key="${params.oauth_consumer_key}",oauth_nonce="${params.oauth_nonce}",oauth_signature="${encodedSignature}",oauth_signature_method="${params.oauth_signature_method}",oauth_timestamp="${params.oauth_timestamp}",oauth_version="${params.oauth_version}"`; try { const response = await axios.post(oauthTokenUrl, 'grant_type=client_credentials', { headers: { 'Content-Type': 'application/x-www-form-urlencoded', 'Authorization': authHeader } }); return response.data.access_token; } catch (error) { console.error('Error obtaining OAuth token:', error); throw error; }}` 

### Querying the Geocoder API

Once you have an OAuth token, you can use it to authenticate requests to HERE APIs. The queryGeocoderAPI function demonstrates querying the HERE Geocoder API with the obtained token.

 async function queryGeocoderAPI(query, accessToken) { try { const response = await axios.get(geocodeUrl, { params: { q: query }, headers: { Authorization: `Bearer ${accessToken}` } }); const items = response.data.items; if (items.length > 0) { const item = items[0]; // Taking the first result for simplicity console.log('Title:', item.title); console.log('ID:', item.id); console.log('Result Type:', item.resultType); console.log('Address:', JSON.stringify(item.address, null, 2)); // Pretty-print the address object console.log('Position:', JSON.stringify(item.position, null, 2)); // Pretty-print the position object console.log('MapView:', JSON.stringify(item.mapView, null, 2)); // Pretty-print the mapView object console.log('Scoring:', JSON.stringify(item.scoring, null, 2)); // Pretty-print the scoring object } else { console.log('No results found.'); } } catch (error) { console.error('Error querying Geocoder API:', error); }}` 

### Main Function

The main function orchestrates the process of obtaining an OAuth token and then using it to make a request to the HERE Geocoder API.

 async function main() { try { const accessToken = await getOAuthToken(); console.log('Obtained Access Token:', accessToken); await queryGeocoderAPI('5th Avenue New York', accessToken); } catch (error) { console.error('An error occurred:', error); }}`main(); 

Running Your Application
------------------------

To run your application, use the following command in your terminal:

 node index.js 

Ensure you replace 'your-access-key-id' and 'your-access-key-secret' with your actual HERE credentials. Please download the full attached project source for running on your local machine.