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/