world-geojson
Advanced tools
This repository contains GeoJSON data for all the countries boundaries including boundaries for states of bigger countries (note that this repository is currently filling). Detalization is good for using this data on scales up to 1:10000000 / gmaps zoom 6-7 (it's the best quality in combination with free-to-use license). Data is created using geojson.io tool.
You can either download it or install in your project either via Composer or NPM:
Via Composer:
"require": {
"georgique/world-geojson": "^3.0"
}
Via NPM:
"dependencies": {
"world-geojson": "^3.0",
}
Help with integrating it with any other Package Manager is welcome.
JSON files can be read from the directory in which the package was downloaded.
Node.js applications can use the provided helper functions to synchronously load the JSON as a JavaScript object.
const geoJson = require('world-geojson') // or `import * as geoJson from 'world-geojson'`
geoJson.forCountry('Antigua & Barbuda'); // returns the contents of /countries/antigua_and_barbuda.json
geoJson.forState('Australia', 'New South Wales'); // returns the contents of /states/australia/new_south_wales.json
geoJson.forArea('U.S.A.', 'U.S. Virgin Islands'); // returns the contents of /areas/usa/us_virgin_islands.json
// Combine multiple GeoJSONs into one
const combined = geoJson.combineGeoJson([
{countryName: 'Antigua & Barbuda'},
{countryName: 'Australia', stateName: 'New South Wales'},
{countryName: 'U.S.A.', areaName: 'U.S. Virgin Islands'}
]);
Contries boundaries besides mainlands include all the geographically separated, but de jure dependent, associated and managed territories. Separated mainland and all the territories mentioned are added in release 2. Countries states are to be added in release 3. More about countries boundaries release here.
Besides bigger countries which are to be splitted into states, some smaller are also worth to be splitted into geographical areas. More about additional area boundaries release here.
Countries split into areas are:
This release is about gluing borders between all the countries so they perfectly align. Was / Is:
Also, NPM this package can now be installed via NPM
Countries which we are going to provide state boundaries for:
Note that some states boundaries are provided by OSM, however quality of that data is much lower. It's planned to replace them with handmade ones eventually.
This library is my personal mini-project which I enjoy doing and I am happy if that is useful for anyone else. If you want to thank me, feel free to buy me a cup of coffee through the GitHub Sponsor program.
FAQs
GeoJson for all the countries, areas (regions) and some states.
The npm package world-geojson receives a total of 76 weekly downloads. As such, world-geojson popularity was classified as not popular.
We found that world-geojson demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.