djangodocs

Django 1.10
Français
Documentation contents

Fonctions de base de données géographiques

Les fonctions documentées sur cette page permettent aux utilisateurs d’accéder aux fonctions géographiques de bases de données utilisables dans les annotations, les agrégations ou les filtres avec Django.

Exemple :

Code
>>> from django.contrib.gis.db.models.functions import Length
>>> Track.objects.annotate(length=Length('line')).filter(length__gt=100)

Tous les moteurs ne supportent pas forcément toutes les fonctions, référez-vous donc à la documentation de chaque fonction pour voir si votre moteur de base de données prend en charge la fonction que vous souhaitez utiliser. Si vous appelez une fonction géographique sur un moteur qui ne le gère pas, vous obtiendrez une exception NotImplementedError.

Sommaire des fonctions :

Mesures

Relations

Opérations

Modifications

Format de sortie

Divers

Area

BoundingCircle

Difference

ForceRHR

AsGeoJSON

IsValid

Distance

Centroid

Intersection

MakeValid

AsGML

MemSize

Length

Envelope

SymDifference

Reverse

AsKML

NumGeometries

Perimeter

PointOnSurface

Union

Scale

AsSVG

NumPoints

SnapToGrid

GeoHash

Transform

Translate

Area

class Area(expression, **extra)

Disponibilité : MySQL, Oracle, PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie la surface du champ sous forme de mesure Area. Avec MySQL, un nombre à virgule est renvoyé, car il n’est pas possible de déterminer automatiquement l’unité du champ.

AsGeoJSON

class AsGeoJSON(expression, bbox=False, crs=False, precision=8, **extra)

Disponibilité : PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie une représentation GeoJSON de l’objet géométrique. Notez que le résultat ne constitue pas une structure GeoJSON complète, mais seulement le contenu de la clé geometry d’une structure GeoJSON. Voir aussi Sérialisation GeoJSON.

Exemple :

Code
>>> City.objects.annotate(json=AsGeoJSON('point')).get(name='Chicago').json
{"type":"Point","coordinates":[-87.65018,41.85039]}

Paramètre nommé

Description

bbox

À définir à True pour que le rectangle englobant soit inclus dans le contenu GeoJSON renvoyé.

crs

À définir à True pour que le système de référence de coordonnées soit inclus dans le format GeoJSON renvoyé.

precision

Peut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation GeoJSON, la valeur par défaut étant 8.

AsGML

class AsGML(expression, version=2, precision=8, **extra)

Disponibilité : PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie une représentation Geographic Markup Language (GML) du champ géométrique.

Exemple :

Code
>>> qs = Zipcode.objects.annotate(gml=AsGML('poly'))
>>> print(qs[0].gml)
<gml:Polygon srsName="EPSG:4326"><gml:OuterBoundaryIs>-147.78711,70.245363 ...
-147.78711,70.245363</gml:OuterBoundaryIs></gml:Polygon>

Paramètre nommé

Description

precision

Indique le nombre de chiffres significatifs des coordonnées de la représentation GML, la valeur par défaut étant 8.

version

Indique la version GML à utiliser : 2 (par défaut) ou 3.

AsKML

class AsKML(expression, precision=8, **extra)

Disponibilité : PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie une représentation Keyhole Markup Language (KML) du champ géométrique.

Exemple :

Code
>>> qs = Zipcode.objects.annotate(kml=AsKML('poly'))
>>> print(qs[0].kml)
<Polygon><outerBoundaryIs><LinearRing><coordinates>-103.04135,36.217596,0 ...
-103.04135,36.217596,0</coordinates></LinearRing></outerBoundaryIs></Polygon>

Paramètre nommé

Description

precision

Ce paramètre peut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation KML, la valeur par défaut étant 8.

AsSVG

class AsSVG(expression, relative=False, precision=8, **extra)

Disponibilité : PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie une représentation Scalable Vector Graphics (SVG) du champ géométrique.

Paramètre nommé

Description

relative

Si défini à True, les données de chemin sont représentées en termes de déplacements relatifs. La valeur par défaut est False ce qui signifie que ce sont les déplacements absolus qui sont utilisés.

precision

Ce paramètre peut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation SVG, la valeur par défaut étant 8.

BoundingCircle

class BoundingCircle(expression, num_seg=48, **extra)

Disponibilité : PostGIS <http://postgis.net/docs/ST_MinimumBoundingCircle.html>`__

Accepte un seul champ ou expression géographique et renvoie le polygone cercle le plus petit pouvant contenir entièrement l’objet géométrique.

Centroid

class Centroid(expression, **extra)

Disponibilité : MySQL, Oracle, PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie la valeur centroïde de l’objet géométrique.

Difference

class Difference(expr1, expr2, **extra)

Disponibilité : MySQL (≥ 5.6.1), Oracle, PostGIS, SpatiaLite

Accepte deux champs ou expressions géographiques et renvoie la différence géométrique, c’est-à-dire la part de l’objet A qui ne fait pas partie de son intersection avec l’objet B.

Distance

class Distance(expr1, expr2, spheroid=None, **extra)

Disponibilité : MySQL (≥ 5.6.1), Oracle, PostGIS, SpatiaLite

Accepte deux champs ou expressions géographiques et renvoie la distance entre les deux sous forme d’objet Distance. Avec MySQL, un nombre à virgule est renvoyé, car il n’est pas possible de déterminer automatiquement l’unité du champ.

Pour les bases de données qui permettent de calculer des distances avec des coordonnées géodésiques, la bonne fonction de base de données est automatiquement sélectionnée en fonction de la valeur SRID des objets géométriques (par ex. ST_Distance_Sphere avec PostGIS).

Lorsque les distances sont calculées avec des coordonnées géodésiques (angles), comme c’est le cas avec le SRID WGS84 (4326) par défaut, vous pouvez définir le paramètre nommé spheroid pour décider si le calcul doit se faire selon une sphère simple (moins précis, moins gourmand en ressources) ou sur un sphéroïde (plus précis, plus gourmand en ressources).

Dans l’exemple suivant, on calcule la distance entre la ville de Hobart vers tous les autres champs PointField du jeu de requête AustraliaCity:

Code
>>> from django.contrib.gis.db.models.functions import Distance
>>> pnt = AustraliaCity.objects.get(name='Hobart').point
>>> for city in AustraliaCity.objects.annotate(distance=Distance('point', pnt)):
...     print(city.name, city.distance)
Wollongong 990071.220408 m
Shellharbour 972804.613941 m
Thirroul 1002334.36351 m
...

Envelope

class Envelope(expression, **extra)

Disponibilité : PostGIS, MySQL, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie l’objet géométrique représentant le rectangle englobant de l’objet.

ForceRHR

class ForceRHR(expression, **extra)

Disponibilité : PostGIS <http://postgis.net/docs/ST_ForceRHR.html>`__

Accepte un seul champ ou expression géographique et renvoie une version modifiée du (multi)polygone pour lequel tous les côtés suivent la « règle de la main droite ».

GeoHash

class GeoHash(expression, precision=None, **extra)

Disponibilité : PostGIS, SpatiaLite (≥ 4.0, LWGEOM)

Accepte un seul champ ou expression géographique et renvoie une représentation GeoHash du champ géométrique.

Le paramètre nommé precision contrôle le nombre de caractères du résultat.

Intersection

class Intersection(expr1, expr2, **extra)

Disponibilité : MySQL (≥ 5.6.1), Oracle, PostGIS, SpatiaLite

Accepte deux champs ou expressions géographiques et renvoie leur intersection géométrique.

IsValid

class IsValid(expr)

Disponibilité : PostGIS

Accepte un champ ou une expression géographique et teste si la valeur est bien formée. Renvoie True si la valeur est un objet géométrique valide et False dans le cas contraire.

Length

class Length(expression, spheroid=True, **extra)

Disponibilité : MySQL, Oracle, PostGIS, SpatiaLite

Accepte un seul champ ou expression ligne ou multiligne géographique et renvoie sa longueur sous forme de mesure Distance. Avec MySQL, un nombre à virgule est renvoyé, car il n’est pas possible de déterminer automatiquement l’unité du champ.

Avec PostGIS ou SpatiaLite, et lorsque les coordonnées sont géodésiques (angles), vous pouvez définir avec le paramètre nommé spheroid si le calcul doit se faire selon une sphère simple (moins précis, moins gourmand en ressources) ou sur un sphéroïde (plus précis, plus gourmand en ressources).

MakeValid

class MakeValid(expr)

Disponibilité : PostGIS

Accepte un champ ou une expression géographique et essaye de convertir la valeur en une géométrie valide sans perdre aucun des segments originaux. Les objets déjà valides sont renvoyés tels quels. Des polygones simples peuvent devenir des multipolygones et le résultat peut être d’une dimension inférieure à l’objet en entrée.

MemSize

class MemSize(expression, **extra)

Disponibilité : PostGIS

Accepte un seul champ ou expression géographique et renvoie la taille mémoire (en octets) consommé par le champ géométrique.

NumGeometries

class NumGeometries(expression, **extra)

Disponibilité : MySQL, Oracle, PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie le nombre d’objets géométriques dans le cas où le champ est une collection (par ex. GEOMETRYCOLLECTION ou un champ MULTI*) ; sinon, renvoie None.

NumPoints

class NumPoints(expression, **extra)

Disponibilité : MySQL, Oracle, PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie le nombre de points du premier objet ligne du champs géométrique ; sinon renvoie None.

Perimeter

class Perimeter(expression, **extra)

Disponibilité : PostGIS, Oracle, SpatiaLite (≥ 4.0)

Accepte un seul champ ou expression géographique et renvoie le périmètre du champ sous forme de mesure Distance.

PointOnSurface

class PointOnSurface(expression, **extra)

Disponibilité : PostGIS, Oracle, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie un objet Point qui se trouve avec certitude dans la surface du champ ; sinon renvoie None.

Reverse

class Reverse(expression, **extra)

Disponibilité : PostGIS, Oracle, SpatiaLite (≥ 4.0)

Accepte un seul champ ou expression géographique et renvoie un objet géométrique avec les coordonnées inversées.

Scale

class Scale(expression, x, y, z=0.0, **extra)

Disponibilité : PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie un objet géométrique avec ses coordonnées mises à l’échelle en les multipliant par les paramètres x, y et facultativement, z.

SnapToGrid

class SnapToGrid(expression, *args, **extra)

Disponibilité : PostGIS, SpatiaLite (≥ 3.1)

Accepte un seul champ ou expression géographique et renvoie un objet géométrique dont tous les points sont ajustés à la grille donnée. La manière d’ajuster l’objet géométrique à la grille dépend du nombre de paramètres numériques fournis (des nombres à virgule, entiers ou entiers longs).

Nombre de paramètres

Description

1

Une seule taille de cellule de grille (à la fois pour la taille X et Y).

2

Tailles X et Y de cellule de grille.

4

Tailles de cellule X et Y ainsi que coordonnées X et Y de l’origine de la grille.

SymDifference

class SymDifference(expr1, expr2, **extra)

Disponibilité : MySQL (≥ 5.6.1), Oracle, PostGIS, SpatiaLite

Accepte deux champs ou expressions géographiques et renvoie la différence géométrique symétrique (union sans l’intersection) entre les paramètres données.

Transform

class Transform(expression, srid, **extra)

Disponibilité : PostGIS, Oracle, SpatiaLite

Accepte un champ ou expression géographique et un code SRID nombre entier, et renvoie l’objet géométrique transformé dans le système de référence spatiale indiqué par le paramètre srid.

Translate

class Translate(expression, x, y, z=0.0, **extra)

Disponibilité : PostGIS, SpatiaLite

Accepte un seul champ ou expression géographique et renvoie un objet géométrique avec ses coordonnées décalées en fonction des paramètres x, y et facultativement, z.

Union

class Union(expr1, expr2, **extra)

Disponibilité : MySQL (≥ 5.6.1), Oracle, PostGIS, SpatiaLite

Accepte deux champs ou expressions géographiques et renvoie l’union des deux.

This page as Markdown JSON

Edit this page on GitHub Official version