geomark 0.1.1

Installation

Option 1 - Clone this repository and install manually

1. We will do our best to keep the master branch of this repository stable. However you could also checkout the tag corresponding to the release you would like…

   git clone https://github.com/greg-and-adam/python-geomark.git

2. the cd into the directory where this repository was cloned

   cd /path/to/python-geomark

3. Install using setup.py

   python setup.py install

4. Or… Follow step 1 above then install using pip

   pip install /path/to/cloned/python-geomark

Usage

A Geomark object can be instantiated with either a Geomark ID or a full Geomark URL.

We recommend using the Geomark ID.

from geomark import Geomark

gm = Geomark('gm-abcdefghijklmnopqrstuv0bcislands')
# or...
gm = Geomark('https://apps.gov.bc.ca/pub/geomark/geomarks/gm-abcdefghijklmnopqrstuv0bcislands')

This library supports all of the basic read functions from the Geomark API.

Reponse results are returned as a bytes string. It can be parsed using the appropriate library.

The default format is ‘json’ which will return a json parsable byte string. When using the JSON format any geometries will be formatted as EWKT.

Any of the supported file formats may be requested.

import json
from geomark import Geomark

gm = Geomark('gm-abcdefghijklmnopqrstuv0bcislands')

info = json.loads(gm.info())
parts = json.loads(gm.parts('geojson'))  # geojson is also supported.

Data can also be requested in any of the supported coordinate systems.

import json
from geomark import Geomark

gm = Geomark('gm-abcdefghijklmnopqrstuv0bcislands')
parts_bcalbers = json.loads(gm.parts('geojson', 3005))

If you get data in a format you wish to write to a file you may do so by simply opening a file location as writable in binary mode. (wb)

from geomark import Geomark

gm = Geomark('gm-abcdefghijklmnopqrstuv0bcislands')
feature_file = gm.feature('shpz')

with open('bc_islands.shpz', 'wb') as file:
    file.write(feature_file)

Testing

tox -e py36

Contributing

1. Fork it!

2. Create your feature branch: git checkout -b my-new-feature

3. Commit your changes: git commit -am 'Add some feature'

4. Push to the branch: git push origin my-new-feature

5. Submit a pull request :D

History

Recent changes can be viewed in the CHANGELOG.md file.

Credits

• Adam Valair (Primary Developer/Maintainer)

• Greg Sebastian (Primary Developer/Maintainer)

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details