Getting Started with ez-opendata

ez-opendata is a set of ez (easy) to use javascript functions to call open-data sources such as openstreetmap, wikipedia or wikimedia. It is tiny and has no dependencies.

It can work for javascript and/or typescript projects on the browser or with nodejs.

ez-opendata is the foundation for picsaroundme.

You can sponsor me at GitHub Sponsors. Or know more about me here.

Install

npm install --save ez-opendata

If you just want to give it a quick try on your typescript project, just copy and paste index.ts in your project and rename it ez-opendata.ts.

Examples

Openstreetmap

Demo here: https://tbo47.github.io/poi/ or https://jsfiddle.net/tbo47/qsuy92ht/

const cafeAndRestaurants = await openstreetmapGetPOIs('14.67,-17.46,14.71,-17.41', [
    ['amenity', 'cafe'],
    ['amenity', 'restaurant'],
])

Use openstreetmap nominatim to fetch coordonates of a place. Demo https://jsfiddle.net/tbo47/xv0g3s59/

const res = await openstreetmapGeocoding('20 rue du Faubourg Saint-Antoine, 75012 Paris')
const { lat, lng } = res.at(0)

Wikimedia Commons

Demo here: https://tbo47.github.io/wikimedia/ or https://jsfiddle.net/tbo47/hyrn2vc0/

const northEast = { lat: 14.71, lng: -17.41 }
const southWest = { lat: 14.67, lng: -17.47 }
const images = await wikimediaQuery(northEast, southWest)

Get a custom thumb image. Demo here: https://jsfiddle.net/tbo47/6b7j2ohy/

const pageId = 21900832
const height = 100
const with = 100
const { thumburl } = await wikimediaGetThumb(pageid, height, width)

Wikipedia

Query wikipedia REST endpoint.

Demo here: https://tbo47.github.io/wikipedia/ or https://jsfiddle.net/tbo47/csfjyd4x/13/

const articles = wikipediaQuery(14.7, -17.4) // latitude longitude

Wikidata

Query wikidata REST endpoint.

https://tbo47.github.io/wikidata/ or https://jsfiddle.net/tbo47/1z2kbuaf/