aqi-arcgis-synchronizer

Lambda function that synchronize EPA AirWatch Air Quality Data to ArcGIS.

Site: https://www.arcgis.com/home/item.html?id=b9de53fbffe34feda37e04217541bee3

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

How it works?

In every xx minutes, this lambda function will call an API provided by EPA. This API provides the details of all environment monitoring sites with the latest health advice. This lambda function will dynamically add and remove the monitoring sites, the features of arcGIS layer.

Prerequisites

1. The app can be deploy as standalone NodeJS web app or as a AWS lambda function. To deploy to AWS Lambda, use Serverless
2. All API called to EPA required us to provide API key, therefore we need to firstly register and subscribe the product via https://portal.api.epa.vic.gov.au/.

Installing

npm install

Credentials and Registering your App

For this code to work, you need to add and register an app in ArcGIS Online, add the correct redirect URI (e.g. http://localhost:8080), and add the client ID and secret to /routes/routes.js.

• How to add an app in ArcGIS Online
• How to register an app in ArcGIS Online
• Make sure to set the correct redirect URI (e.g. http://localhost:8080)

Finally, update /routes/routes.js to contain your client ID and secret (and portal URL if not ArcGIS Online):

const client_id = 'xx';
const client_secret = 'xx';

Update the feature server URL

const featureServerUrl = 'xx';

Accessing EPA API using API Key

As mention above, all API called to EPA required us to provide API key, therefore we need to firstly register and subscribe to the product via https://portal.api.epa.vic.gov.au/.

Then, in /routes/routes.js assign that API key to the variable

const apiKey = 'xx';

Deploy to AWS Lambda

sls deploy

Running the Lambda function offline

sls offline start

Manually trigger AWS Lambda function

sls invoke -f app

To run as a NodeJS app

Comment out the Serverless handle and uncomment the local server part in /index.js

// module.exports.handler = serverless(app);

// USE THIS FOR LOCAL SERVER
var server = app.listen(3000, function() {
  console.log('app running on port.', server.address().port);
});

Authors

• Nasrul Muhaimin b Mohd Zain - Initial work

License

This project is licensed under the MIT License - see the LICENSE.md file for details