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.

ez-opendata is the foundation for picsaroundme.

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

You can sponsor this library at GitHub Sponsors.

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"],
  ]
);

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/