isogeo_pysdk.api.routes_coordinate_systems module
Isogeo API v1 - API Routes to retrieve CoordinateSystems
See: http://help.isogeo.com/api/complete/index.html
- class isogeo_pysdk.api.routes_coordinate_systems.ApiCoordinateSystem(api_client=None)
Bases:
object
Routes as methods of Isogeo API used to manipulate coordinate-systems.
- associate_metadata(metadata, coordinate_system)
Associate a coordinate-system (SRS) to a metadata.
If a coordinate-system is already associated to the metadata, it’ll be oversritten.
- Parameters
metadata (Metadata) – metadata object to update
coordinate_system (CoordinateSystem) – coordinate-system model object to associate
- Return type
- Example
# retrieve metadata md = isogeo.metadata.get( metadata_id=METADATA_UUID, include=() ) # retrieve one of the SRS selected in the workgroup of the metadata wg_srs = self.isogeo.coordinate_system.listing(md._creator.get("_id")) random_srs = CoordinateSystem(**sample(wg_srs, 1)[0]) # associate them isogeo.coordinateSystem.associate_metadata( metadata=md, coordinateSystem=random_srs, )
- associate_workgroup(coordinate_system, workgroup=None)
Add a coordinate system to the workgroup selection or/adn edit the SRS custom alias.
- Parameters
coordinate_system (CoordinateSystem) – EPSG code of the coordinate system to add to the workgroup selection
workgroup (Workgroup) – identifier of the owner workgroup.
- Return type
- Example
# retrieve the SRS coordsys = isogeo.srs.get("4326") # add a custom alias coordsys.alias = "World SRS" # add it to the workgroup selection isogeo.srs.associate_workgroup( workgroup=isogeo.workgroup.get(WORKGROUP_UUID), coordinate_system=coordsys )
- dissociate_metadata(metadata)
Removes the coordinate-system from a metadata.
- dissociate_workgroup(coordinate_system_code, workgroup_id=None)
Remove a coordinate system from the workgroup selection.
- Parameters
- Return type
- Example
>>> isogeo.srs.dissociate_workgroup( workgroup_id=WORKGROUP_TEST_FIXTURE_UUID, coordinate_system_code="2154" )
- get(coordinate_system_code, workgroup_id=None)
Get details about a specific coordinate_system, from the whole Isogeo database or into a specific workgroup (to get the SRS alias for example).
- Parameters
- Return type
- Example
>>> # list all coordinate-systems in the whole Isogeo database >>> srs = isogeo.srs.listing() >>> # print details about the first SRS found >>> pprint.pprint(isogeo.srs.get(srs[0].get("code"))) { '_tag': 'coordinate-system:4143', 'code': 4143, 'name': 'Abidjan 1987' }
- listing(workgroup_id=None, caching=1)
Get coordinate-systems in the whole Isogeo database or into a specific workgroup.
- Parameters
- Return type
- Example
>>> # list all coordinate-systems in the whole Isogeo database >>> srs = isogeo.srs.listing() >>> print(len(srs)) 4301 >>> # list coordinate-systems which have been selected in a specific workgroup >>> srs = isogeo.srs.listing(workgroup_id=WORKGROUP_UUID) >>> print(len(srs)) 5