Git Product home page Git Product logo

geojson4entityframework's Introduction

GeoJSON4EntityFramework Logo BuildStatus


What is GeoJSON?

GeoJSON is a format for encoding a variety of geographic data structures. A GeoJSON object may represent a geometry, a feature, or a collection of features.

In 2015, the Internet Engineering Task Force (IETF), in conjunction with the original specification authors, formed a GeoJSON WG to standardize GeoJSON. RFC 7946 was published in August 2016 and is the new standard specification of the GeoJSON format, replacing the 2008 GeoJSON specification.

GeoJSON supports Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, and GeometryCollection geometry types.

Feature contain a geometry object and additional properties, and a FeatureCollection represents a list of features.

For example, A house, a road and a bus stop represents three different Feature. All of them might have different type of geometries. House could be a polygon, road could be a linestring and bus stop could be a point. All of them represents a neighbourhood and this called FeatureCollection in GeoJSON.

What is EntityFramework?

EntityFramework (EF) is an open source object-relational mapping (ORM) framework for Microsoft .net. It allows us to use database rows as class instances.

What is Well-known Text (WKT)?

Well-known Text (WKT) is a text markup language for representing vector geometry objects on a map, spatial reference systems of spatial objects and transformations between spatial reference systems. In summary, It's a text representations of geometrical objects.

So, What is GeoJSON4EntityFramework ??

GeoJSON for EntityFramework is a .net library that allows you to create GeoJSON output from EntityFramework Spatial Data or WKT inputs. In other words, It serializes different type of geometry objects to GeoJSON. It's not limited to only EF entities but It can serialize WKT inputs as well.

Features

  • Supports Entity Framework v6 (System.Data.Entity.Spatial namespace) and Entity Framework v5 (System.Data.Spatial namespace) objects
  • Supports Well-known Text inputs
  • Supports DbGeometry (planar) and DbGeography (geodetic "round earth") objects
  • Supports all types of features defined in geojson specs (RFC 7946)
  • Supports boundingbox property defined in geojson specs (RFC 7946)
  • Supports geometry transform

Quick Start

EntityFramework Example

Visual Basic

Imports alatas.GeoJSON4EntityFramework

Function GetGeoJSONFromDB() As String
    Using db As New SpatialExampleEntities
        Dim data = From row In db.SampleTables Select row.SpatialData

        Dim features as New FeatureCollection(data.ToArray)
        Return features.Serialize(prettyPrint:=True)
    End Using
End Function

C#

using alatas.GeoJSON4EntityFramework;

public string GetGeoJSONFromDB()
{
    using (Entities db = new Entities())
    {

    DbGeometry[] data = (from row in db.SampleTables select row.SpatialData).ToArray();
    
    FeatureCollection features = new FeatureCollection(data);
    return features.Serialize(prettyPrint: true);
    }
}

Well-Known Text (WKT) Example

Visual Basic

Imports alatas.GeoJSON4EntityFramework

Function GetGeoJSONFromWKT() As String
    Dim WKTs = {"POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))",
                "MULTIPOINT ((10 40), (40 30), (20 20), (30 10))",
                "LINESTRING (1 1, 2 2)"}

    Dim features as New FeatureCollection(WKTs)
    Return features.Serialize(prettyPrint:=True)
End Function

C#

using alatas.GeoJSON4EntityFramework;

public string GetGeoJSONFromWKT()
{
    string[] WKTs = {
        "POLYGON ((30 10, 40 40, 20 40, 10 20, 30 10))",
        "MULTIPOINT ((10 40), (40 30), (20 20), (30 10))",
        "LINESTRING (1 1, 2 2)"
    };

    FeatureCollection features = new FeatureCollection(WKTs);
    return features.Serialize(prettyPrint: true);
}

Install

Install with Package Manager Console - Nuget

To install GeoJSON for Entity Framework, run the following command in the Package Manager Console

Entity Framework 6

Install-Package GeoJSON4EntityFramework

Entity Framework 5

Install-Package GeoJSON4EntityFramework5

Manual Install

Download the latest release and add to your project references manually

Prerequisites

Tests and Validation

You may validate outputs with http://geojson.io and http://geojsonlint.com


Test data extracted from OpenStreetMap®. OpenStreetMap® is open data, licensed under the Open Data Commons Open Database License (ODbL) by the OpenStreetMap Foundation (OSMF)

geojson4entityframework's People

Contributors

alatas avatar jumpinjackie avatar titoluyo avatar

Watchers

JacquesB. avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.