Copyright | (C) 2014-2018 HS-GeoJSON Project |
---|---|
License | BSD-style (see the file LICENSE.md) |
Maintainer | Andrew Newman |
Safe Haskell | None |
Language | Haskell2010 |
Refer to the GeoJSON Spec http://www.geojson.org/geojson-spec.html
- type Latitude = Double
- type Longitude = Double
- type Easting = Double
- type Northing = Double
- type Altitude = Double
- data FeatureID
- data GeoPositionWithoutCRS
- data GeoPosition
- newtype GeoPoint = GeoPoint {}
- retrieveXY :: GeoPositionWithoutCRS -> PointXY
- data PointXY = PointXY {}
- data PointXYZ = PointXYZ {}
- data PointXYZM = PointXYZM {}
- newtype GeoMultiPoint = GeoMultiPoint {}
- splitGeoMultiPoint :: GeoMultiPoint -> Vector GeoPoint
- mergeGeoPoints :: Vector GeoPoint -> GeoMultiPoint
- newtype GeoPolygon = GeoPolygon {}
- newtype GeoMultiPolygon = GeoMultiPolygon {}
- splitGeoMultiPolygon :: GeoMultiPolygon -> Vector GeoPolygon
- mergeGeoPolygons :: Vector GeoPolygon -> GeoMultiPolygon
- newtype GeoLine = GeoLine {}
- newtype GeoMultiLine = GeoMultiLine {}
- splitGeoMultiLine :: GeoMultiLine -> Vector GeoLine
- mergeGeoLines :: Vector GeoLine -> GeoMultiLine
- data GeospatialGeometry
- type Name = Text
- type Code = Int
- type Href = Text
- type FormatString = Text
- type ProjectionType = Text
- data CRSObject
- data BoundingBoxWithoutCRS
- data GeoFeature a = GeoFeature {}
- reWrapGeometry :: GeoFeature a -> GeospatialGeometry -> GeoFeature a
- data GeoFeatureCollection a = GeoFeatureCollection {}
- stripCRSFromPosition :: GeoPosition -> GeoPositionWithoutCRS
- defaultCRS :: CRSObject
- unGeoPoint :: Iso' GeoPoint GeoPositionWithoutCRS
- unGeoMultiPoint :: Iso' GeoMultiPoint (Vector GeoPositionWithoutCRS)
- unGeoPolygon :: Iso' GeoPolygon (Vector (LinearRing GeoPositionWithoutCRS))
- unGeoLine :: Iso' GeoLine (LineString GeoPositionWithoutCRS)
- unGeoMultiLine :: Iso' GeoMultiLine (Vector (LineString GeoPositionWithoutCRS))
- unGeoMultiPolygon :: Iso' GeoMultiPolygon (Vector (Vector (LinearRing GeoPositionWithoutCRS)))
- unBoundingBoxWithoutCrs :: BoundingBoxWithoutCRS -> Vector Double
- bbox :: forall a. Lens' (GeoFeature a) (Maybe BoundingBoxWithoutCRS)
- geometry :: forall a. Lens' (GeoFeature a) GeospatialGeometry
- properties :: forall a a. Lens (GeoFeature a) (GeoFeature a) a a
- featureId :: forall a. Lens' (GeoFeature a) (Maybe FeatureID)
- boundingbox :: forall a. Lens' (GeoFeatureCollection a) (Maybe BoundingBoxWithoutCRS)
- geofeatures :: forall a a. Lens (GeoFeatureCollection a) (GeoFeatureCollection a) (Vector (GeoFeature a)) (Vector (GeoFeature a))
- class HasGeoPositionWithoutCRS c where
- _NoGeometry :: Prism' GeospatialGeometry ()
- _Point :: Prism' GeospatialGeometry GeoPoint
- _MultiPoint :: Prism' GeospatialGeometry GeoMultiPoint
- _Polygon :: Prism' GeospatialGeometry GeoPolygon
- _MultiPolygon :: Prism' GeospatialGeometry GeoMultiPolygon
- _Line :: Prism' GeospatialGeometry GeoLine
- _MultiLine :: Prism' GeospatialGeometry GeoMultiLine
- _Collection :: Prism' GeospatialGeometry (Vector GeospatialGeometry)
- _NoCRS :: Prism' CRSObject ()
- _NamedCRS :: Prism' CRSObject Name
- _EPSG :: Prism' CRSObject Code
- _LinkedCRS :: Prism' CRSObject (Href, FormatString)
Types
data GeoPositionWithoutCRS Source #
data GeoPosition Source #
see Section 2.1.1 Position in the GeoJSON Spec, I make the assumption here that the only position types we will use will involve easting or northing (+ve or -ve Altitude) or lon or lat (+ve or -ve Altitude)
(GeoPositionWithoutCRS
is a catch all for indeterminate CRSs and for expression of positions
before a CRS has been determined
newtype GeoMultiPoint Source #
splitGeoMultiPoint :: GeoMultiPoint -> Vector GeoPoint Source #
Split GeoMultiPoint coordinates into multiple GeoPoints
mergeGeoPoints :: Vector GeoPoint -> GeoMultiPoint Source #
Merge multiple GeoPoints into one GeoMultiPoint
newtype GeoPolygon Source #
newtype GeoMultiPolygon Source #
splitGeoMultiPolygon :: GeoMultiPolygon -> Vector GeoPolygon Source #
Split GeoMultiPolygon coordinates into multiple GeoPolygons
mergeGeoPolygons :: Vector GeoPolygon -> GeoMultiPolygon Source #
Merge multiple GeoPolygons into one GeoMultiPolygon
newtype GeoMultiLine Source #
splitGeoMultiLine :: GeoMultiLine -> Vector GeoLine Source #
Split GeoMultiLine coordinates into multiple GeoLines
mergeGeoLines :: Vector GeoLine -> GeoMultiLine Source #
Merge multiple GeoLines into one GeoMultiLine
data GeospatialGeometry Source #
See section 2.1 Geometry Objects in the GeoJSON Spec.
NoGeometry | |
Point GeoPoint | |
MultiPoint GeoMultiPoint | |
Polygon GeoPolygon | |
MultiPolygon GeoMultiPolygon | |
Line GeoLine | |
MultiLine GeoMultiLine | |
Collection (Vector GeospatialGeometry) |
Eq GeospatialGeometry Source # | |
Show GeospatialGeometry Source # | |
Generic GeospatialGeometry Source # | |
ToJSON GeospatialGeometry Source # | encodes Geometry Objects to GeoJSON |
FromJSON GeospatialGeometry Source # | decodes Geometry Objects from GeoJSON Aeson doesnt decode "null" into |
NFData GeospatialGeometry Source # | |
type Rep GeospatialGeometry Source # | |
type FormatString = Text Source #
type ProjectionType = Text Source #
See Section 3 Coordinate Reference System Objects in the GeoJSON Spec
NoCRS
is required because no crs
attribute in a GeoJSON feature is NOT the same thing as
a null crs
attribute. no crs
value implies the default CRS, while a null CRS means
you cannot assume a CRS, null will mapped to NoCRS
while a non-existent attribute will
be mapped to a Nothing
Maybe
value
data BoundingBoxWithoutCRS Source #
See Section 4 Bounding Boxes of the GeoJSON spec, The length of the list/array must be 2*n where n is the dimensionality of the position type for the CRS with min values first followed by the max values, wich both the min/max sets following the same axis order as the CRS, e.g for WGS84: minLongitude, minLatitude, maxLongitude, maxLatitude The spec mentions that it can be part of a geometry object too but doesnt give an example, This implementation will ignore bboxes on Geometry objects, they can be added if required.
data GeoFeature a Source #
See Section 2.2 Feature Objects of the GeoJSON spec. Parameterised on the property type
Eq a => Eq (GeoFeature a) Source # | |
Show a => Show (GeoFeature a) Source # | |
Generic (GeoFeature a) Source # | |
ToJSON a => ToJSON (GeoFeature a) Source # | Encodes Feature objects to GeoJSON |
FromJSON a => FromJSON (GeoFeature a) Source # | Decodes Feature objects from GeoJSON |
NFData a => NFData (GeoFeature a) Source # | |
type Rep (GeoFeature a) Source # | |
reWrapGeometry :: GeoFeature a -> GeospatialGeometry -> GeoFeature a Source #
data GeoFeatureCollection a Source #
See Section 2.3 Feature Collection Objects of the GeoJSON spec
Eq a => Eq (GeoFeatureCollection a) Source # | |
Show a => Show (GeoFeatureCollection a) Source # | |
ToJSON a => ToJSON (GeoFeatureCollection a) Source # | Encode FeatureCollection objects to GeoJSON |
FromJSON a => FromJSON (GeoFeatureCollection a) Source # | Decode FeatureCollection objects from GeoJSON |
Functions
stripCRSFromPosition :: GeoPosition -> GeoPositionWithoutCRS Source #
the GeoPosition
is a bit special in that when you convert it to GeoJSON,
it will lose the CRS info attached to it and cannot be read back in
from the GeoJSON. Hence it is ineligible for the FromJSON
type class,
so this function will strip it down to a GeoPositionWithoutCRS
, which is eligible
defaultCRS :: CRSObject Source #
The default CRS according to Section 3 Coordinate Reference System Objects is WGS84 which I believe, from http://spatialreference.org/ref/epsg/4326/ which translates to this in JSON: http://spatialreference.org/ref/epsg/4326/json/) is represented thus:
Lenses
Geometry Lenses
unGeoMultiPolygon :: Iso' GeoMultiPolygon (Vector (Vector (LinearRing GeoPositionWithoutCRS))) Source #
Feature Lenses
bbox :: forall a. Lens' (GeoFeature a) (Maybe BoundingBoxWithoutCRS) Source #
geometry :: forall a. Lens' (GeoFeature a) GeospatialGeometry Source #
properties :: forall a a. Lens (GeoFeature a) (GeoFeature a) a a Source #
boundingbox :: forall a. Lens' (GeoFeatureCollection a) (Maybe BoundingBoxWithoutCRS) Source #
geofeatures :: forall a a. Lens (GeoFeatureCollection a) (GeoFeatureCollection a) (Vector (GeoFeature a)) (Vector (GeoFeature a)) Source #
Prisms
BasicTypes
class HasGeoPositionWithoutCRS c where Source #
Geometry
CRS
_LinkedCRS :: Prism' CRSObject (Href, FormatString) Source #