geomark 0.1.1

Description:

geomark 0.1.1

A small python library that provides implementations of the BC
Governments Geomark Web
Service

Installation
Option 1 - Clone this repository and install manually

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

the cd into the directory where this repository was cloned
cd /path/to/python-geomark

Install using setup.py
python setup.py install

Or… Follow step 1 above then install using pip
pip install /path/to/cloned/python-geomark



TODO List more installation methods here as they become supported…



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

Using tox
The recommended way to run the tests is by using
tox, which can be installed
usingpip install tox.
You can use tox -l to list the available environments, and then e.g.
use the following to run all tests with Python 3.6
tox -e py36


Running tests manually
Please refer to the tox.ini file for reference/help in
case you want to run tests manually / without tox.



Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
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