Python Django Distance用法及代码示例

本文介绍 django.contrib.gis.db.models.functions.Distance 的用法。

声明

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

Availability：MariaDB，MySQL，PostGIS，甲骨文，SpatiaLite

接受两个地理字段或表达式并返回它们之间的距离，作为 Distance 对象。在 MySQL 上，当坐标是大地时返回一个原始浮点值。

在支持大地坐标距离计算的后端上，根据几何图形的 SRID 值自动选择适当的后端函数(例如 PostGIS 上的ST_DistanceSphere)。

当使用大地(角)坐标计算距离时，与默认 WGS84 (4326) SRID 的情况一样，您可以设置 spheroid 关键字参数来决定计算是否应基于简单的球体(不太准确，较少resource-intensive)或在球体上(更准确，更多 resource-intensive)。

在以下示例中，计算了从霍巴特市到 AustraliaCity 查询集中其他所有 PointField 的距离：

>>> 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
...