-
Notifications
You must be signed in to change notification settings - Fork 885
Regional Features
The NSI project has a collection of .geojson
features corresponding to the internal or administrative borders of several countries for use with the locationSet
property. These features represent a country's subdivisions, which can be referred to as either "states", "provinces", "regions", "counties", "districts", etc. The features use the local area's ISO 3166-2 naming conventions for their file names and id
values.
Below is a simplified, non-exhaustive list of available ISO 3166-2 compatible features within the NSI, which all require the .geojson
extension when referenced. The table also lists a couple of exceptions where the .geojson
extension is not needed; these subdivisions are built-in to the country-coder project and thus can be referenced directly without the .geojson
file extension. For a full list of available features, please browse the NSI's features folder.
Location | Features | ISO Standard | Examples | Exceptions |
---|---|---|---|---|
Australia | States within Australia | ISO 3166-2:AU | Queensland (au-qld.geojson) Victoria (au-vic.geojson) |
Tazmania (au-tas) |
Austria | States of Austria | ISO 3166-2:AT | Vienna (at-9.geojson) Carinthia (at-2.geojson) |
None |
Canada | Canadian Provinces | ISO 3166-2:CA | Alberta (ca-ab.geojson) Quebec (ca-qc.geojson) |
None |
France | Regions within France | ISO 3166-2:FR | Île-de-France (fr-idf.geojson) Provence-Alpes-Côte-d’Azur (fr-pac.geojson) |
None |
Germany | States within Germany | ISO 3166-2:DE | Berlin (de-be.geojson) Hessen (de-he.geojson) |
None |
Japan | Prefectures of Japan | ISO 3166-2:JP | Chiba (jp-12.geojson) Aichi (jp-23.geojson) |
None |
New Zealand | Regions within New Zealand | ISO 3166-2:NZ | Marlborough (nz-mbh.geojson) Wellington (nz-wgn.geojson) |
None |
United States | States within the United States | ISO 3166-2:US | New Jersey (us-nj.geojson) California (us-ca.geojson) |
Alaska (us-ak) Hawaii (us-hi) |
There is partial support for Counties in Great Britain (UK) which follow the ISO 3166-2:GB standard. One exception is gb-lon.geojson
, which represents London as a whole, but gb-lon
isn't part of the ISO 3166-2:GB standard, as each London Borough has its own ISO value.
The file names of the regional features follow the ISO 3166-2 standard for that country; e.g., US-FL.geojson
for the feature representing the US state of Florida. If you wish to assign a locationSet
area confined to a single region, you may use the id
of the .geojson
feature for that region, such as us-fl.geojson
for Florida (note the difference in case from the feature's file name). For example:
"locationSet": {"include": ["us-fl.geojson"]}
You can also use multiple regions if need be, such as Florida & Georgia, for example:
"locationSet": {"include": ["us-ga.geojson","us-fl.geojson"]}
Or exclude regions, such as everywhere in the USA except for Florida & Georgia for example:
"locationSet": {
"include": ["us"],
"exclude": ["us-ga.geojson","us-fl.geojson"]
}
As previously mentioned, the subdivisions built-in to the country-coder project can be referenced directly without the .geojson
file extension:
"locationSet": {"include": ["us-ak"]}
"locationSet": {"include": ["us-hi"]}
See Creating and Editing Feature Files for guidance on how to add new features or edit existing features using QGIS.
Contributing to the index
- Feature Files (geofences)
- Using Overpass Turbo
- Config Files
- Property Reference
- Technical Details
Information for developers using the name-suggestion-index in another project.
Information for maintainers, including how to clone and build the project.