{"title":"Fungsi Basisdata Geografis","version":"3.1","locale":"id","docname":"ref/contrib/gis/functions","url":"/id/3.1/ref/contrib/gis/functions/","canonical":"https://djangodocs.dev/id/3.1/ref/contrib/gis/functions/","summary":"Fungsi-fungsi terdokumentasi pada halaman ini mengizinkan pengguna mengakses fungsi basisdata geografis untuk digunakan dalam keterangan, pengumpulan, atau…","html":"

Fungsi Basisdata GeografisLink to this heading#

\n

Fungsi-fungsi terdokumentasi pada halaman ini mengizinkan pengguna mengakses fungsi basisdata geografis untuk digunakan dalam keterangan, pengumpulan, atau penyaringan dalam Django.

\n

Contoh:

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

Tidak semua backend mendukung semua fungsi, jadi mengacu pada dokumentasi dari setiap fungsi untuk melihat jika backend basisdata anda mendukung anda ingin gunakan. Jika anda memanggil fungsi geografis pada backend yang tidak mendukung itu, anda akan mendapatkan pengecualian NotImplementedError.

\n

Ringkasan fungsi:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Pengukuran

Hubungan

Operasi

Penyunting

Bentuk keluaran

Bermacam-macam

Area

Azimuth

Difference

ForcePolygonCW

AsGeoJSON

IsValid

Distance

BoundingCircle

Intersection

MakeValid

AsGML

MemSize

GeometryDistance

Centroid

SymDifference

Reverse

AsKML

NumGeometries

Length

Envelope

Union

Scale

AsSVG

NumPoints

Perimeter

LineLocatePoint

SnapToGrid

AsWKB

PointOnSurface

Transform

AsWKT

Translate

GeoHash

\n
\n
\n

AreaLink to this heading#

\n
\n
\nclass Area(expression, **extra)Link to this definition#
\n
\n\n

Availability: MariaDB, MySQL,\nOracle, PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan kawasan bidang sebagai sebuah ukuran Area.

\n

MySQL dan SpatiaLite tanpa LWGEOM tidak akan mendukung kawasan perhitungan pada geografis SRSes.

\n
\n
\n

AsGeoJSONLink to this heading#

\n
\n
\nclass AsGeoJSON(expression, bbox=False, crs=False, precision=8, **extra)Link to this definition#
\n
\n\n

Availability: MariaDB (≥ 10.2.4), MySQL (≥ 5.7.5),\nOracle, PostGIS, SpatiaLite

\n

Accepts a single geographic field or expression and returns a GeoJSON representation of the geometry. Note that the result\nis not a complete GeoJSON structure but only the geometry key content of a\nGeoJSON structure. See also Penserial GeoJSON.

\n

Contoh:

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

Argumen Katakunci

Deskripsi

bbox

Set this to True if you want the bounding box\nto be included in the returned GeoJSON. Ignored on\nOracle.

crs

Set this to True if you want the coordinate\nreference system to be included in the returned\nGeoJSON. Ignored on MySQL and Oracle.

ketelitian

It may be used to specify the number of significant\ndigits for the coordinates in the GeoJSON\nrepresentation -- the default value is 8. Ignored on\nOracle.

\n
\n\n
\n
\n

AsGMLLink to this heading#

\n
\n
\nclass AsGML(expression, version=2, precision=8, **extra)Link to this definition#
\n
\n\n

Tersedia: Oracle, PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan perwakilan Geographic Markup Language (GML) dari geometri.

\n

Contoh:

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

Argumen Katakunci

Deskripsi

ketelitian

Menentukan sejumlah angka penting untuk kordinat dalam perwakilan GML -- nilai awalan adalah 8. Abaikan pada Oracle.

versi

Menentukan versi GML untuk menggunakan: 2 (awalan) atau 3.

\n
\n
\n
\n

AsKMLLink to this heading#

\n
\n
\nclass AsKML(expression, precision=8, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan perwakilan Keyhole Markup Language (KML) dari geometri.

\n

Contoh:

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

Argumen Katakunci

Deskripsi

ketelitian

Katakunci ini mungkin digunakan untuk menentukan sejumlah angka penting untuk kordinat dalam perwakilan KML -- nilai awalan adalah 8.

\n
\n\n
\n
\n

AsSVGLink to this heading#

\n
\n
\nclass AsSVG(expression, relative=False, precision=8, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan sebuah perwakilan Scalable Vector Graphics (SVG) dari geometri.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Argumen Katakunci

Deskripsi

relative

Jika disetel ke True, jalur data akan diterapkan dalam ketentuan dari pergerakan relatif. Awalan menjadi ``False11, berarti bahwa perpindahan mutlak digunakan sebagai gantinya.

ketelitian

Katakunci mungkin digunakan untuk menentukan sejumlah angka penting untuk kordinat dalam perwakilan SVG -- nilai awalan adalah 8.

\n
\n
\n
\n

AsWKBLink to this heading#

\n
\n
\nclass AsWKB(expression, **extra)Link to this definition#
\n
\n\n\n

Availability: MariaDB, MySQL,\nOracle, PostGIS, SpatiaLite

\n

Accepts a single geographic field or expression and returns a Well-known\nbinary (WKB) representation of the geometry.

\n

Contoh:

\n
Code
>>> bytes(City.objects.annotate(wkb=AsWKB('point')).get(name='Chelyabinsk').wkb)\nb'\\x01\\x01\\x00\\x00\\x00]3\\xf9f\\x9b\\x91K@\\x00X\\x1d9\\xd2\\xb9N@'\n
\n
\n
\n

AsWKTLink to this heading#

\n
\n
\nclass AsWKT(expression, **extra)Link to this definition#
\n
\n\n\n

Availability: MariaDB, MySQL,\nOracle, PostGIS, SpatiaLite

\n

Accepts a single geographic field or expression and returns a Well-known text\n(WKT) representation of the geometry.

\n

Contoh:

\n
Code
>>> City.objects.annotate(wkt=AsWKT('point')).get(name='Chelyabinsk').wkt\n'POINT (55.137555 61.451728)'\n
\n
\n
\n

AzimuthLink to this heading#

\n
\n
\nclass Azimuth(point_a, point_b, **extra)Link to this definition#
\n
\n\n

Ketersediaan: PostGIS, SpatiaLite (LWGEOM)

\n

Mengembalikan azimut dalam radian dari segmen ditentukan oleh titik geometri yang diberikan, atau None jila dia titik bertemu. Azimut adalah sudut diacukan dari utara dan positif jarumg jam: utara = 0; timur= π/2; selatan = π; barat = 3π/2.

\n
\n
\n

BoundingCircleLink to this heading#

\n
\n
\nclass BoundingCircle(expression, num_seg=48, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, Oracle

\n

menerima bidang geografis tunggal atau pernyataan dan mengembalikan lingkaran poligon terkecil yang dapat sepenuhnya mengandung geometri.

\n

Parameter num_seg hanya digunakan pada PostGIS.

\n
\n
\n

CentroidLink to this heading#

\n
\n
\nclass Centroid(expression, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima bidang geografis tunggal atau mengembalikan nilai centroid dari geometri.

\n
\n
\n

DifferenceLink to this heading#

\n
\n
\nclass Difference(expr1, expr2, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima dua bidang geografis atau pernyataan dan mengembalikan perbedaan geometri, yaitu bagian dari geometri A yang tidak berinteraksi dengan geometri B.

\n
\n
\n

DistanceLink to this heading#

\n
\n
\nclass Distance(expr1, expr2, spheroid=None, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima dua bidang geografis atau pernyataan dan mengembalikan jarak diantara mereka, seperti sebuah obyek Distance, nilai float mentah dikembalikan ketika kordinat adalah geodetik.

\n

Pada backend yang mendukung perhitungan jarak pada kordinat geodetik, fungsi backend sesuai otomatis dipilih tergantung pada nilai SRID dari geometri (misalnya ST_DistanceSphere pada PostGIS).

\n

Ketika jarak dihitung dengan kordinat (bersiku-siku) geodetic, seperti halnya dengan awalan SRID WGS84 (4326), anda dapat menyetel argumen kata kunci spheroid untuk memutuskan jika perhitungan harus berdasarkan pada bulatan sederhana (kurang akurat, kurang sumber daya-intensif) atau pada sebuah berbentuk bola (lebih akurat, lebih sumber daya-intensif)

\n

Dalam contoh berikut, jarak dari kota Hobart ke semua selain queryset PointField dalam AustraliaCity dihitung:

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

EnvelopeLink to this heading#

\n
\n
\nclass Envelope(expression, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, Oracle, PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan geometri mewakili kotak batasan dari geometri.

\n
\n
\n

ForcePolygonCWLink to this heading#

\n
\n
\nclass ForcePolygonCW(expression, **extra)Link to this definition#
\n
\n\n

Ketersediaan: PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan versi terubah dari poligon/banyak poligon dimana semua lingkaran eksterior diorientasikan searah jarum jam dan semua lingkaran interior berorientasikan berlawanan jarum jam. Geometri bukan-geometri dikembalikan tidak berubah.

\n
\n
\n

GeoHashLink to this heading#

\n
\n
\nclass GeoHash(expression, precision=None, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MySQL (≥ 5.7.5), PostGIS, SpatiaLite (LWGEOM)

\n

Menerima bidang geografi tunggal atau pernyataan dan mengembalikan perwakilan GeoHash dari geometri.

\n

Argumen kata kunci precision mengendalikan sejumlah karakter dalam hasilnya.

\n
\n
\n

GeometryDistanceLink to this heading#

\n
\n
\nclass GeometryDistance(expr1, expr2, **extra)Link to this definition#
\n
\n\n\n

Ketersediaan: PostGIS

\n

Accepts two geographic fields or expressions and returns the distance between\nthem. When used in an order_by() clause,\nit provides index-assisted nearest-neighbor result sets.

\n
\n
\n

IntersectionLink to this heading#

\n
\n
\nclass Intersection(expr1, expr2, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima dua bidang geografi dan pernyataan dan mengembalikan persimpangan geometri diantara mereka.

\n
\n
\n

IsValidLink to this heading#

\n
\n
\nclass IsValid(expr)Link to this definition#
\n
\n\n

Ketersediaan: MySQL (≥ 5.7.5), PostGIS, Oracle, SpatiaLite (LWGEOM)

\n

Menerima sebuah bidang geografi atau pernyataan dan percobaan jika nilai berbentuk bagus. Mengembalikan True jika nilainya adalah geometri sah dan False sebaliknya.

\n
\n
\n

LengthLink to this heading#

\n
\n
\nclass Length(expression, spheroid=True, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, Oracle, PostGIS, SpatiaLite

\n

Menerima bidang linestring geografis tunggal atau banyak linestring atau pernyataan dan mengembalikan panjangnya sebagai ukuran Distance.

\n

Pada PostGIS dan SpatiaLite, ketika kordinat adalah geodetik (siku), anda dapat menentukan jika perhitungan harus berdasarkan pada bidang sederhana (kurang akurat, kurang sumber-daya-intensif) atau pada sebuah bidang (lebih akurat, lebih sumber-daya-intensif) dengan argumen kata kunci spheroid.

\n

MySQL tidak mendukung dukungan perhitungan panjang pada geografis SRS.

\n
\n
\n

LineLocatePointLink to this heading#

\n
\n
\nclass LineLocatePoint(linestring, point, **extra)Link to this definition#
\n
\n\n

Ketersediaan: PostGIS, SpatiaLite

\n

Mengembalikan sebuah float diantara 0 dan 1 mewakili tempat dari titik terdekat di linestring pada point yang diberikan, sebagai sebuah pecahan dari panjang garis 2D.

\n
\n
\n

MakeValidLink to this heading#

\n
\n
\nclass MakeValid(expr)Link to this definition#
\n
\n\n

Tersedia: PostGIS, SpatiaLite (LWGEOM)

\n

Menerima bidang geografis tunggal atau pernyataan dan berusaha merubah nilai menjadi geometri sah tanpakehilangan masukan simpul apapun. Geometri yang sudah sah dikembalikan tanpa perubahan. Poligon sederhana mungkin menjadi poligon banyak dan hasil mungkin berupa dimensi rendah daripada masukan.

\n
\n
\n

MemSizeLink to this heading#

\n
\n
\nclass MemSize(expression, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan ukuran memori (sejumlah byte) yang bidang geometri ambil.

\n
\n
\n

NumGeometriesLink to this heading#

\n
\n
\nclass NumGeometries(expression, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan sejumlah geometri jika bidang geometri adalah kumpulan (misalnya, bidang GEOMETRYCOLLECTION atau MULTI*). mengembalikan 1 untuk geometri tunggal.

\n

Pada MySQL, mengembalikan None untuk geometri tunggal.

\n
\n
\n

NumPointsLink to this heading#

\n
\n
\nclass NumPoints(expression, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan sejumlah titik dalam sebuah geometri.

\n

Pada MySQL, mengembalikan None untuk geometri bukan-LINESTRING apapun.

\n
\n
\n

PerimeterLink to this heading#

\n
\n
\nclass Perimeter(expression, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, Oracle, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan lingakran dari bidang geometri sebagai sebuah obyek Distance.

\n
\n
\n

PointOnSurfaceLink to this heading#

\n
\n
\nclass PointOnSurface(expression, **extra)Link to this definition#
\n
\n\n

Ketersediaan: PostGIS, MariaDB, Oracle, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan Point geometri dijamin berbohong pada permukaan dari bidang; sebaliknya mengembalikan None.

\n
\n
\n

ReverseLink to this heading#

\n
\n
\nclass Reverse(expression, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, Oracle, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan geometri dengan kordinat terbalik.

\n
\n
\n

ScaleLink to this heading#

\n
\n
\nclass Scale(expression, x, y, z=0.0, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan geometri dengan kordinat ditingkatkan dengan mengalikan mereka dengan parameter x, y, dan pilihannya z.

\n
\n
\n

SnapToGridLink to this heading#

\n
\n
\nclass SnapToGrid(expression, *args, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan geometri dengan semua titik diambil pada jala yang diberikan. Bagaimana geometri diambil pada jala tergantung pada seberapa banyak argumen numerik (baik itu float, integer, atau long) diberikan.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Jumlah Argumen

Deskripsi

1

A single size to snap both the X and Y grids to.

2

X and Y sizes to snap the grid to.

4

Ukuran X, Y dan berhubungan asli X,Y.

\n
\n
\n
\n

SymDifferenceLink to this heading#

\n
\n
\nclass SymDifference(expr1, expr2, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima dua bidang geografis atau pernyataan dan mengembalikan perbedaan simetrik geografis (penyatuan tanpa persimpangan) diantara parameter diberikan.

\n
\n
\n

TransformLink to this heading#

\n
\n
\nclass Transform(expression, srid, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, Oracle, SpatiaLite

\n

Menerima sebuah bidang geografis atau pernyataan dan kode integer SRID, dan mengembalikan geometri diubah ke sistem acuan spasial ditentukan oleh parameter srid.

\n\n
\n
\n

TranslateLink to this heading#

\n
\n
\nclass Translate(expression, x, y, z=0.0, **extra)Link to this definition#
\n
\n\n

Tersedia: PostGIS, SpatiaLite

\n

Menerima bidang geografis tunggal atau pernyataan dan mengembalikan geometri dengan kordinat penyeimbangnya oleh parameter angka x, y, dan pilihannya z.

\n
\n
\n

UnionLink to this heading#

\n
\n
\nclass Union(expr1, expr2, **extra)Link to this definition#
\n
\n\n

Ketersediaan: MariaDB, MySQL, PostGIS, Oracle, SpatiaLite

\n

Menerima dua bidang geografi atau pernyataan dan mengembalikan gabungan dari kedua geometri.

\n
","rootId":"module-django.contrib.gis.db.models.functions","toc":[{"title":"Area","anchor":"area","children":[]},{"title":"AsGeoJSON","anchor":"asgeojson","children":[]},{"title":"AsGML","anchor":"asgml","children":[]},{"title":"AsKML","anchor":"askml","children":[]},{"title":"AsSVG","anchor":"assvg","children":[]},{"title":"AsWKB","anchor":"aswkb","children":[]},{"title":"AsWKT","anchor":"aswkt","children":[]},{"title":"Azimuth","anchor":"azimuth","children":[]},{"title":"BoundingCircle","anchor":"boundingcircle","children":[]},{"title":"Centroid","anchor":"centroid","children":[]},{"title":"Difference","anchor":"difference","children":[]},{"title":"Distance","anchor":"distance","children":[]},{"title":"Envelope","anchor":"envelope","children":[]},{"title":"ForcePolygonCW","anchor":"forcepolygoncw","children":[]},{"title":"GeoHash","anchor":"geohash","children":[]},{"title":"GeometryDistance","anchor":"geometrydistance","children":[]},{"title":"Intersection","anchor":"intersection","children":[]},{"title":"IsValid","anchor":"isvalid","children":[]},{"title":"Length","anchor":"length","children":[]},{"title":"LineLocatePoint","anchor":"linelocatepoint","children":[]},{"title":"MakeValid","anchor":"makevalid","children":[]},{"title":"MemSize","anchor":"memsize","children":[]},{"title":"NumGeometries","anchor":"numgeometries","children":[]},{"title":"NumPoints","anchor":"numpoints","children":[]},{"title":"Perimeter","anchor":"perimeter","children":[]},{"title":"PointOnSurface","anchor":"pointonsurface","children":[]},{"title":"Reverse","anchor":"reverse","children":[]},{"title":"Scale","anchor":"scale","children":[]},{"title":"SnapToGrid","anchor":"snaptogrid","children":[]},{"title":"SymDifference","anchor":"symdifference","children":[]},{"title":"Transform","anchor":"transform","children":[]},{"title":"Translate","anchor":"translate","children":[]},{"title":"Union","anchor":"union","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Acuan API","url":"/id/3.1/ref/"},{"docname":"ref/contrib/index","title":"Paket contrib","url":"/id/3.1/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/id/3.1/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/geoquerysets","title":"Acuan API QuerySet GIS","url":"/id/3.1/ref/contrib/gis/geoquerysets/"},"next":{"docname":"ref/contrib/gis/measure","title":"Obyek Pengukuran","url":"/id/3.1/ref/contrib/gis/measure/"},"formats":{"html":"/id/3.1/ref/contrib/gis/functions/","markdown":"/id/3.1/ref/contrib/gis/functions.md","json":"/id/3.1/ref/contrib/gis/functions.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/ref/contrib/gis/functions.txt","official":"https://docs.djangoproject.com/id/3.1/ref/contrib/gis/functions/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}