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
- type GeoPositionWithoutCRS = [Double]
- data GeoPosition
- newtype GeoPoint = GeoPoint {}
- newtype GeoMultiPoint = GeoMultiPoint {}
- splitGeoMultiPoint :: GeoMultiPoint -> [GeoPoint]
- mergeGeoPoints :: [GeoPoint] -> GeoMultiPoint
- newtype GeoPolygon = GeoPolygon {}
- newtype GeoMultiPolygon = GeoMultiPolygon {}
- splitGeoMultiPolygon :: GeoMultiPolygon -> [GeoPolygon]
- mergeGeoPolygons :: [GeoPolygon] -> GeoMultiPolygon
- newtype GeoLine = GeoLine {}
- newtype GeoMultiLine = GeoMultiLine {}
- splitGeoMultiLine :: GeoMultiLine -> [GeoLine]
- mergeGeoLines :: [GeoLine] -> GeoMultiLine
- data GeospatialGeometry
- type Name = Text
- type Code = Int
- type Href = Text
- type FormatString = Text
- type ProjectionType = Text
- data CRSObject
- type BoundingBoxWithoutCRS = [Double]
- data GeoFeature a = GeoFeature {}
- data GeoFeatureCollection a = GeoFeatureCollection {}
- stripCRSFromPosition :: GeoPosition -> GeoPositionWithoutCRS
- defaultCRS :: CRSObject
- unGeoPoint :: Iso' GeoPoint GeoPositionWithoutCRS
- unGeoMultiPoint :: Iso' GeoMultiPoint [GeoPositionWithoutCRS]
- unGeoPolygon :: Iso' GeoPolygon [LinearRing GeoPositionWithoutCRS]
- unGeoLine :: Iso' GeoLine (LineString GeoPositionWithoutCRS)
- unGeoMultiLine :: Iso' GeoMultiLine [LineString GeoPositionWithoutCRS]
- unGeoMultiPolygon :: Iso' GeoMultiPolygon [[LinearRing GeoPositionWithoutCRS]]
- 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) [GeoFeature a] [GeoFeature a]
- _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 [GeospatialGeometry]
- _NoCRS :: Prism' CRSObject ()
- _NamedCRS :: Prism' CRSObject Name
- _EPSG :: Prism' CRSObject Code
- _LinkedCRS :: Prism' CRSObject (Href, FormatString)
Types
type GeoPositionWithoutCRS = [Double] Source #
(GeoPositionWithoutCRS
is a catch all for indeterminate CRSs and for expression of positions
before a CRS has been determined
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)
newtype GeoMultiPoint Source #
splitGeoMultiPoint :: GeoMultiPoint -> [GeoPoint] Source #
Split GeoMultiPoint coordinates into multiple GeoPoints
mergeGeoPoints :: [GeoPoint] -> GeoMultiPoint Source #
Merge multiple GeoPoints into one GeoMultiPoint
newtype GeoPolygon Source #
newtype GeoMultiPolygon Source #
splitGeoMultiPolygon :: GeoMultiPolygon -> [GeoPolygon] Source #
Split GeoMultiPolygon coordinates into multiple GeoPolygons
mergeGeoPolygons :: [GeoPolygon] -> GeoMultiPolygon Source #
Merge multiple GeoPolygons into one GeoMultiPolygon
newtype GeoMultiLine Source #
splitGeoMultiLine :: GeoMultiLine -> [GeoLine] Source #
Split GeoMultiLine coordinates into multiple GeoLines
mergeGeoLines :: [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 [GeospatialGeometry] |
Eq GeospatialGeometry Source # | |
Show GeospatialGeometry Source # | |
ToJSON GeospatialGeometry Source # | encodes Geometry Objects to GeoJSON |
FromJSON GeospatialGeometry Source # | decodes Geometry Objects from GeoJSON Aeson doesnt decode "null" into |
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
type BoundingBoxWithoutCRS = [Double] 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 # | |
ToJSON a => ToJSON (GeoFeature a) Source # | Encodes Feature objects to GeoJSON |
FromJSON a => FromJSON (GeoFeature a) Source # | Decodes Feature objects from GeoJSON |
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
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) [GeoFeature a] [GeoFeature a] Source #
Prisms
Geometry
CRS
_LinkedCRS :: Prism' CRSObject (Href, FormatString) Source #