GeoJSON support for Django GraphQL
Project description
GeoJSON support for Django GraphQL
Dependencies
Python ≥ 3.4
Django ≥ 1.11
Installation
Update Graphene Django package.
pip install -U git+https://github.com/graphql-python/graphene-django.git@master
Install last stable version from Pypi.
pip install django-graphql-geojson
GeoJSONType
GeoJSONType is a subclass of DjangoObjectType which provides GraphQL fields in GeoJSON format.
Just define a Meta.geojson_field to be represented as a Geometry type.
models.py
from django.contrib.gis.db import models
class Place(models.Model):
name = models.CharField(max_length=255)
location = models.PointField()
schema.py
import graphene
import graphql_geojson
class PlaceType(graphql_geojson.GeoJSONType):
class Meta:
model = models.Place
geojson_field = 'location'
class Query(graphene.ObjectType):
places = graphene.List(PlaceType)
schema = graphene.Schema(query=Query)
Query
query {
places {
id
type
geometry {
type
coordinates
}
bbox
properties {
name
}
}
}
Geometry Type
Geometry is a special GraphQL type that represents a GEOS geometry object.
schema.py
import graphene
import graphql_geojson
class CreatePlace(graphene.Mutation):
place = graphene.Field(types.PlaceType)
class Arguments:
name = graphene.String(required=True)
location = graphql_geojson.Geometry(required=True)
@classmethod
def mutate(cls, root, info, **args):
place = models.Place.objects.create(**args)
return cls(place=place)
Mutation
mutation CreatePlace($name: String!, $location: Geometry!) {
createPlace(name: $name, location: $location) {
place {
id
}
}
}
Geometry type may be initialized in a few ways:
Well-known text (WKT):
"POINT(5 23)"
Hexadecimal (HEX):
"010100000000000000000014400000000000003740"
GeoJSON:
{
"type": "Point",
"coordinates": [5, 23]
}
GeometryFilterSet
Django GraphQL GeoJSON provides a custom FilterSet for spatial lookups.
The Meta.fields option is combined with model to automatically generate filters.
filters.py
from graphql_geojson.filters import GeometryFilterSet
class PlaceFilter(GeometryFilterSet):
class Meta:
model = models.Place
fields = {
'name': ['exact'],
'location': ['exact', 'intersects', 'distance_lte'],
}
schema.py
import graphene
import graphql_geojson
from graphene import relay
from graphene_django.filter import DjangoFilterConnectionField
class PlaceNode(graphql_geojson.GeoJSONType):
class Meta:
model = Place
interfaces = [relay.Node]
geojson_field = 'location'
class Query(graphene.ObjectType):
places = DjangoFilterConnectionField(
PlaceNode,
filterset_class=PlaceFilter)
Query
query Places($geometry: Geometry!){
places(location_Intersects: $geometry) {
edges {
node {
id
}
}
}
}
Distance lookups take a Distance parameter comprising:
The desired unit attribute name
Distance value
A geometry to base calculations from
query Places(
$unit: DistanceUnitEnum!,
$value: Float!,
$geometry: Geometry!)
{
places(location_DistanceLte: {
unit: $unit,
value: $value,
geometry: $geometry
}) {
edges {
node {
id
}
}
}
}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-graphql-geojson-0.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a1a10e792d5c385097f909adcb779388611df5a669cc7e8e6ffb7528cacc5229 |
|
MD5 | babba8df3a48d1a893523f174d3728fa |
|
BLAKE2b-256 | 3cb99b5b233ce2fc3f0140f83a384a2fcf247974ed0dafc96939f763db8807bc |
Hashes for django_graphql_geojson-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 168da8036b46f34f418b2c644c36864fe57503630b7f0814a6a8ae546b19727a |
|
MD5 | 2153fe44e931bd0d8d97cb5bc496fb1e |
|
BLAKE2b-256 | 18cd4ddba9ca8571a8d47aa455e89cf19e3a0faab07282f0bc8b0c39045be345 |