An open API service indexing awesome lists of open source software.

https://github.com/giscience/ohsome-js-utils

This library contains JavaScript functions to help clients to use the Ohsome-Api for analyzing historical OpenStreetMap data.
https://github.com/giscience/ohsome-js-utils

Last synced: 5 months ago
JSON representation

This library contains JavaScript functions to help clients to use the Ohsome-Api for analyzing historical OpenStreetMap data.

Awesome Lists containing this project

README

          

[![status: experimental](https://github.com/GIScience/badges/raw/master/status/experimental.svg)](https://github.com/GIScience/badges#experimental)

Why is it experimental?
It not yet fully supports all response types that the [ohsome API](https://api.ohsome.org/v1/swagger-ui.html) can return.
So currently it mainly supports the functionality needed in the [ohsome Dashboard](https://dashboard.ohsome.org) app.

# Info
This library contains JavaScript functions to help clients to use the Ohsome-Api for analyzing historical OpenStreetMap data.

Functionality includes

+ parsing and validation of request params
+ type-guards, functions to access result values, conversion functions to create CSV output from JSON results

# Usage

## Installation
```shell
$> npm install @giscience/ohsome-js-utils
```

You can use this library in different ways.

## 1. UMD single file bundle for browsers or nodejs scripts
```html

```
```javascript
// nodejs
var OhsomeJsUtils = require( '@giscience/ohsome-js-utils' );
```

## 2. ES2020 modules
```javascript
import * as OhsomeJsUtils from '@giscience/ohsome-js-utils'
// or
import { OhsomeApi } from '@giscience/ohsome-js-utils'
```