GEOS stands for Geometry Engine - Open Source,\nand is a C++ library, ported from the Java Topology Suite. GEOS\nimplements the OpenGIS Simple Features for SQL spatial predicate functions\nand spatial operators. GEOS, now an OSGeo project, was initially developed and\nmaintained by Refractions Research of Victoria, Canada.
\nCuireann GeodJango fillteán Python ardleibhéil i bhfeidhm don leabharlann GEOS, tá a ghnéithe tá:
\nComhéadan ceadúnaithe BSD le gnáthaimh geoiméadachta GEOS, a chuirtear i bhfeidhm i Python amháin ag baint úsáide as ctype`.
Loosely-coupled to GeoDjango. For example, GEOSGeometry objects\nmay be used outside of a Django project/application. In other words,\nno need to have DJANGO_SETTINGS_MODULE set or use a database, etc.
Is féidir athraitheacht: :class: rudaí Geosgeometry a mhodhnú.
Cross-platform tested.
Sa chuid seo tá réamhrá gairid agus teagaisc teagaisc maidir le rudaí: aicme: GeosGeometry a úsáid.
\nGEOSGeometry objects may be created in a few ways. The first is\nto simply instantiate the object on some spatial input -- the following\nare examples of creating the same geometry from WKT, HEX, WKB, and GeoJSON:
>>> from django.contrib.gis.geos import GEOSGeometry\n>>> pnt = GEOSGeometry("POINT(5 23)") # WKT\n>>> pnt = GEOSGeometry("010100000000000000000014400000000000003740") # HEX\n>>> pnt = GEOSGeometry(\n... memoryview(\n... b"\\x01\\x01\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x14@\\x00\\x00\\x00\\x00\\x00\\x007@"\n... )\n... ) # WKB\n>>> pnt = GEOSGeometry(\n... '{ "type": "Point", "coordinates": [ 5.000000, 23.000000 ] }'\n... ) # GeoJSON\nAnother option is to use the constructor for the specific geometry type\nthat you wish to create. For example, a Point object may be\ncreated by passing in the X and Y coordinates into its constructor:
>>> from django.contrib.gis.geos import Point\n>>> pnt = Point(5, 23)\nGlacann na tógálaí seo go léir an argóint eochairfhocal srid. Mar shampla:
>>> from django.contrib.gis.geos import GEOSGeometry, LineString, Point\n>>> print(GEOSGeometry("POINT (0 0)", srid=4326))\nSRID=4326;POINT (0 0)\n>>> print(LineString((0, 0), (1, 1), srid=4326))\nSRID=4326;LINESTRING (0 0, 1 1)\n>>> print(Point(0, 0, srid=32140))\nSRID=32140;POINT (0 0)\nFaoi dheireadh, tá an modh monarcha:func: fromfile ann a thugann réad a:class: GeosGeometry ó chomhad:
\n>>> from django.contrib.gis.geos import fromfile\n>>> pnt = fromfile("/path/to/pnt.wkt")\n>>> pnt = fromfile(open("/path/to/pnt.wkt"))\nGEOSGeometry objects are 'Pythonic', in other words components may\nbe accessed, modified, and iterated over using standard Python conventions.\nFor example, you can iterate over the coordinates in a Point:
>>> pnt = Point(5, 23)\n>>> [coord for coord in pnt]\n[5.0, 23.0]\nLe haon réad geoiméadrach, is féidir an maoin: attr: Geosgeometry.coords a úsáid chun na comhordanáidí geoiméadrachta a fháil mar thúpla Python:
\n>>> pnt.coords\n(5.0, 23.0)\nYou can get/set geometry components using standard Python indexing\ntechniques. However, what is returned depends on the geometry type\nof the object. For example, indexing on a LineString\nreturns a coordinate tuple:
>>> from django.contrib.gis.geos import LineString\n>>> line = LineString((0, 0), (0, 50), (50, 50), (50, 0), (0, 0))\n>>> line[0]\n(0.0, 0.0)\n>>> line[-2]\n(50.0, 0.0)\nCé go gcuirfidh innéacsú ar a: aicme: Polygon an fáinne (a: aicme: Línearing réad) a fhreagraíonn don innéacs ar ais:
\n>>> from django.contrib.gis.geos import Polygon\n>>> poly = Polygon(((0.0, 0.0), (0.0, 50.0), (50.0, 50.0), (50.0, 0.0), (0.0, 0.0)))\n>>> poly[0]\n<LinearRing object at 0x1044395b0>\n>>> poly[0][-2] # second-to-last coordinate of external ring\n(50.0, 0.0)\nIna theannta sin, féadfar comhordáití/comhpháirteanna an geoiméadrachta a chur leis nó a mhodhnú, díreach cosúil le liosta
\n>>> line[0] = (1.0, 1.0)\n>>> line.pop()\n(0.0, 0.0)\n>>> line.append((1.0, 1.0))\n>>> line.coords\n((1.0, 1.0), (0.0, 50.0), (50.0, 50.0), (50.0, 0.0), (1.0, 1.0))\nTacaíonn geoiméadraí le hoibreoirí cosúil le tac
\n>>> from django.contrib.gis.geos import LineString\n>>> ls1 = LineString((0, 0), (2, 2))\n>>> ls2 = LineString((1, 1), (3, 3))\n>>> print(ls1 | ls2) # equivalent to `ls1.union(ls2)`\nMULTILINESTRING ((0 0, 1 1), (1 1, 2 2), (2 2, 3 3))\n>>> print(ls1 & ls2) # equivalent to `ls1.intersection(ls2)`\nLINESTRING (1 1, 2 2)\n>>> print(ls1 - ls2) # equivalent to `ls1.difference(ls2)`\nLINESTRING(0 0, 1 1)\n>>> print(ls1 ^ ls2) # equivalent to `ls1.sym_difference(ls2)`\nMULTILINESTRING ((0 0, 1 1), (2 2, 3 3))\ngeo_input -- Luach ionchuir geoiméadais (teaghrán nó: aicme: memoryview)
srid (int) -- aitheantas tagartha spásúil
max_geom_collections -- maximum number of nested (WKT) or total (WKB)\ngeometry collections accepted before parsing is refused
This is the base class for all GEOS geometry objects. It initializes on the\ngiven geo_input argument, and then assumes the proper geometry subclass\n(e.g., GEOSGeometry('POINT(1 1)') will create a Point object).
Socraítear an paraiméadar srid, má thugtar é, mar SRID an geoiméadra cruthaithe mura bhfuil SRID ag geo_input`. Má chuirtear SRIDanna éagsúla ar fáil tríd na paraiméadair geo_input` agus srid, ardaítear LuaeError:
>>> from django.contrib.gis.geos import GEOSGeometry\n>>> GEOSGeometry("POINT EMPTY", srid=4326).ewkt\n'SRID=4326;POINT EMPTY'\n>>> GEOSGeometry("SRID=4326;POINT EMPTY", srid=4326).ewkt\n'SRID=4326;POINT EMPTY'\n>>> GEOSGeometry("SRID=1;POINT EMPTY", srid=4326)\nTraceback (most recent call last):\n...\nValueError: Input geometry already has SRID: 1.\nGlactar leis na formáidí ionchuir seo a leanas, mar aon lena gcineálacha comhfhreagracha Python:
\nFormáid | \nCineál Ionchuir | \n
|---|---|
WKT/EWKT | \n
| \n
HEICSEACH/HEXEWKB | \n
| \n
WKB/EWKB | \n
| \n
<7946>:rfc: `GeoJSON ` | \n
| \n
Maidir leis an bhformáid GeoJSON, socraítear an SRID bunaithe ar an bhall crs. Mura gcuirtear crs ar fáil, réamhshocraíonn an SRID go 4326.
Tógann a: aicme: Geosgeometry ón sreang GML a thugtar.
\nTugann comhordanáidí an ghéimseadrachta ar ais mar thuple.
\nTugann sé gné an geoiméadrachta ar ais:
\n0 le haghaidh: aicme: Points agus:aicme: Multipoints
1 le haghaidh: aicme: LíneStrings agus:aicme: Multilinestrings
2 le haghaidh: aicme: Polygons agus:aicme: Multipolygons
-1 le haghaidh folam:class: GeometryCollections
gné uasta a chuid eilimintí le haghaidh neamh-fholm:class: GeometryCollections
Tugann sé ar ais cibé an bhfuil an tacar pointí sa ghéiméadracht folamh nó nach bhfuil.
\nReturns a string corresponding to the type of geometry. For example:
\n>>> pnt = GEOSGeometry("POINT(5 23)")\n>>> pnt.geom_type\n'Point'\nReturns the GEOS geometry type identification number. The following table\nshows the value for each geometry type:
\nCoiméadras | \nID | \n
|---|---|
| \n | 0 | \n
| \n | 1 | \n
| \n | 2 | \n
| \n | 3 | \n
| \n | 4 | \n
| \n | 5 | \n
| \n | 6 | \n
| \n | 7 | \n
Filleann líon na gcomhordanáidí sa ghéiméadracht.
\nReturns the number of geometries in this geometry. In other words, will\nreturn 1 on anything but geometry collections.
\nReturns a boolean indicating whether the geometry has the Z dimension.
\nReturns a boolean indicating whether the geometry has the M dimension.\nRequires GEOS 3.12.
\nTugann sé boolean a thugann le fios an bhfuil an geoiméadra ina Línearing`.
\nReturns a boolean indicating whether the geometry is 'simple'. A geometry\nis simple if and only if it does not intersect itself (except at boundary\npoints). For example, a LineString object is not simple if it\nintersects itself. Thus, LinearRing and Polygon objects\nare always simple because they cannot intersect themselves, by definition.
Tugann sé boolean ar ais a thugann le fios an bhfuil an geoiméadracht bailí.
\nTugann teaghrán ar ais ag cur síos ar an gcúis go bhfuil geoiméadacht neamhbhail
\nProperty that may be used to retrieve or set the SRID associated with the\ngeometry. For example:
\n>>> pnt = Point(5, 23)\n>>> print(pnt.srid)\nNone\n>>> pnt.srid = 4326\n>>> pnt.srid\n4326\nThe properties in this section export the GEOSGeometry object into\na different. This output may be in the form of a string, buffer, or even\nanother object.
Returns the "extended" Well-Known Text of the geometry. This representation\nis specific to PostGIS and is a superset of the OGC WKT standard. [1]\nEssentially the SRID is prepended to the WKT representation, for example\nSRID=4326;POINT(5 23).
Returns the WKB of this Geometry in hexadecimal form. Please note\nthat the SRID value is not included in this representation\nbecause it is not a part of the OGC specification (use the\nGEOSGeometry.hexewkb property instead).
Returns the EWKB of this Geometry in hexadecimal form. This is an\nextension of the WKB specification that includes the SRID value\nthat are a part of this geometry.
\nTugann ionadaíocht GeoJSON ar an geoiméadra ar ais. Tabhair faoi deara nach struchtúr iomlán GeoJSON é an toradh ach ach príomhábhar “geoiméadracht” de struchtúr GeoJSON amháin. Féach freis:doc: /ref/contrib/gis/serializers.
\nAlias le haghaidh: attr: GeosGeometry.JSON.
\nReturns a KML (Keyhole Markup Language) representation of the\ngeometry. This should only be used for geometries with an SRID of\n4326 (WGS84), but this restriction is not enforced.
\nTugann sé ar:class: ~django.contrib.gis.gdal.ogrGeometry réad a fhreagraíonn don geoiméadacht GEOS.
\nReturns the WKB (Well-Known Binary) representation of this Geometry\nas a Python buffer. SRID value is not included, use the\nGEOSGeometry.ewkb property instead.
Tabhair ar ais ionadaíocht EWKB an Céiméadracht seo mar mhaolán Python. Is síneadh é seo ar shonraíocht WKB a chuimsíonn aon luach SRID atá mar chuid den ghéiméadracht seo.
\nTugann sé an Téacs Aitheanta den ghéiméadracht (caighdeán OGC) ar ais.
\nGlacann gach ceann de na modhanna réamhdhéanta spásúla seo a leanas eile: class: Geosgeometry (``eile ``) mar pharaiméadar, agus cuireann sé boolean ar ais.
\n<GEOSGeometry.within>Tuairisceann True ife:meth: other.within (this) `filleann ``True`.
Tugann sé ar ais True má chlúdaíonn an geoiméadacht seo an geoiméadra sonraithe.
Tá na sainmhínithe coibhéiseach seo a leanas ag an réamhchúiseach clúdaithe
Is pointe den ghéiméadracht seo é gach pointe den ghéimseadracht eile.
Is é T*****FF*`, *T****FF*, ***T**FF*, ***T**FF*, ***T**FF*`, nó ****T*FF*.
Má tá ceachtar geoiméadair folamh, filleann sé False.
Tá an predicate seo cosúil le:meth: Geosgeometry.contains, ach tá sé níos cuimsitheach (ie tuairisceann True le haghaidh tuilleadh cásanna). Go háirithe, nach cosúil:meth: ~ Geosgeometry.Contains ní dhéanann sé idirdhealú idir pointí sa teorainn agus ar an taobh istigh de na geoiméadraí. Maidir le formhór na gcásanna, ba chóir go mbeadh clúdaigh () ``níos fearr ná: meth: `~ Geosgeometry.contains. Mar shochar breise, tá ``clúdaigh () ``níos inúsáidte le barrfheabhsú agus dá bhrí sin ba chóir go mbeadh feidhm níos faide ná: meth: ~Geosgeometry.contains.
Tugann sé ar ais True más é T*T******` an maitrís trasna DE-9IM don dá Geoiméadair (le haghaidh pointe agus cuar, pointe agus limistéar nó líne agus limistéar) ``0******** (le haghaidh dhá chuar).
Tugann sé ar ais True más é FF*FF****` an maitrís trasna DE-9IM don dá ghéiméadracht.
Tugann sé ar ais True más é T* F**FFF*` an maitrís trasna DE-9IM don dá ghéiméadracht.
Returns true if the two geometries are exactly equal, up to a\nspecified tolerance. The tolerance value should be a floating\npoint number representing the error tolerance in the comparison, e.g.,\npoly1.equals_exact(poly2, 0.001) will compare equality to within\none thousandth of a unit.
Tugann sé “Fíor” ar ais má tá an dá ghéiméadracht coibhéiseach pointe trí sheiceáil go bhfuil struchtúr, ordú agus luachanna gach beart comhionann i ngach toise. Meastar go bhfuil luachanna Nan comhionann le luachanna Nan eile. Éilíonn GEOS 3.12.
Tuairisceann True ife:meth: Geosgeometry.disjoint False.
Tugann sé fíor más é an maitrís trasna DE-9IM don dá ghéiméadracht T*T***T** (le haghaidh dhá phointe nó dhá dhromchla) 1* T***T** (le haghaidh dhá chuar).
Tugann True ar ais má mheaitríonn na heilimintí i maitrís trasna DE-9IM don ghéiméadracht seo agus an ceann eile leis an patrún ``a thugtar -- sreang de naoi charachtar ón aibítir: {``T, F`, *`, 0`}.
Tugann sé ar ais True más é FT*******`, F**T*****` nó F***T**** nó F***T**** an maitrís trasna DE-9IM don dá ghéiméadracht.
Tugann sé ar ais True más é T*F**F***` an maitrís trasna DE-9IM don dá ghéiméadracht T*F**F***.
Tuairisceáin a:aicme: Geosgeoiméadr a léiríonn gach pointe a bhfuil a n-achar ón gcéiméadra seo níos lú ná nó cothrom leis an leithead a thugtar. Socraíonn an eochairfhocal roghnach `quadsegs' líon na ndeighleoga a úsáidtear chun ceathrú ciorcal a mheas (is é 8 na réamhshocraithe).
\nMar an gcéanna le: meth: `maolán `, ach ceadaíonn sé stíl an maoláin a shaincheapadh.
\nIs féidir le end_cap_style a bheith cruinn (1), cothrom (2), nó cearnach (3).
Is féidir le join_style a bheith cruinn (1), mitre (2), nó bevel (3).
Níl i bhfeidhm ach ar an teorainn cóimheas mitre (mitre_limit`) ar stíl comhcheangail mitre.
Tuairisceáin a: aicme: GeosGeometry a léiríonn na pointí a chuimsíonn an geoiméadracht seo nach ndéanann suas eile.
\nMar gheall ar achar (snámhphointe), filleann sé an pointe (nó an pointe is gaire) laistigh den ghéiméadracht (:class: Linestring nó:class: MultilineString) ag an achar sin. Tógann an leagan normalaithe an fad mar snámhphointe idir 0 (tionscnamh) agus 1 (críochphointe).
\nIomsaigh de:meth: Geosgeometry.Project.
\nTuairisceáin a: aicme: GeosGeometry a léiríonn na pointí atá roinnte ag an geoiméadacht seo agus eile.
\nFilleann sé an fad (snámhphointe) ó bhunús an ghéiméadrachta (:class: Linestring nó:class: MultilineString) go dtí an pointe a réamhaítear ar an geoiméadra (is é sin go pointe den líne is gaire don phointe ar leith). Tugann an leagan normalaithe an fad ar ais mar snámhphointe idir 0 (tionscnamh) agus 1 (críochphointe).
\nIomsaigh de:meth: Geosgeometry.interpolate.
\nFilleann sé an maitrís trasna DE-9IM (sreang) a léiríonn an gaol topolaíoch idir an geoiméadacht seo agus an ceann eile.
\nFilleann sé nua:class: GeosGeometry, a shimpliú go dtí an lamháltas sonraithe ag baint úsáide as an algartam Douglas-Peucker. Tugann luach lamháltais níos airde le tuiscint níos lú pointí san aschur. Mura gcuirtear aon lamháltas ar fáil, réamhshocraíonn sé go 0.
\nDe réir réamhshocraithe, ní chaomhnóidh an fheidhm seo topolaíocht. Mar shampla, :class: Is féidir rudaí Polygon a roinnt, iad a thitim ina línte, nó imeacht. :class: Is féidir poill Polygon a chruthú nó a imirt, agus féadfaidh línte trasnú. Trí shonrú preserve_topology=True, beidh an toise agus an líon comhpháirteanna céanna ag an toradh leis an ionchur; tá sé seo i bhfad níos moille, áfach.
Tuairisceáin a: aicme: GeosGeometry a chomhcheanglaíonn na pointí sa ghéimseadracht seo nach bhfuil i bpointí eile, agus na pointí eile nach bhfuil sa ghéiméadracht seo.
\nTuairisceáin a: aicme: GeosGeometry a léiríonn na pointí go léir sa ghéimseadracht seo agus an ceann eile.
\nTugann sé an teorainn ar ais mar réad Coiméadra nua-leithdháil
\nReturns a Point object representing the geometric center of\nthe geometry. The point is not guaranteed to be on the interior\nof the geometry.
Filleann sé an beag:class: Polygon ina bhfuil na pointí go léir sa ghéimseadracht.
\nTuairisceáin a: aicme: Polygon a léiríonn clúdach teorainneach an geoiméadair seo. Tabhair faoi deara gur féidir leis a: class: Point a thabhairt ar ais freisin más pointe é an geoiméadra ionchuir.
\nRáthaítear go mbeidh Point ar an taobh istigh den ghéiméadracht seo a ríomh agus tuairisceann a: aicme: Point
\nRíomhann aontas na n-eilimintí uile den ghéiméadracht seo.
\nCloíonn an toradh don chonradh seo a leanas:
\nTá an éifeacht ag aontú tacar de:class: Linestrings an obair líne a nochtadh agus a dhíscaoileadh go hiomlán.
Ag aontú sraith de:class: Polygons, tabharfar ar ais i gcónaí a:class: Polygon nó:class: Multipolygon geoiméadracht (gan amhail: meth: Geosgeometry.Union, a d'fhéadfadh geoiméadraí de ghné níos ísle a thabhairt ar ais má tharlaíonn titim topaolaíochta).
Tugann an maoin seo limistéar an Céiméadracht ar ais.
\nTugann an maoin seo méid an geoiméadra seo ar ais mar 4-tuple, comhdhéanta de (xmin, ymin, xmax, ymax).
Tugann an modh seo a: class: GeosGeometry is clón den bhunaidh é.
\nTugann sé an fad idir na pointí is gaire ar an geoiméadacht seo agus an geom` a thugtar (rud eile: aicme: GeosGeometry réad).
\n\nTugann sé ar ais fad an ghéiméadracht seo (m.sh., 0 do aicme a: Point, fad a: aicme a: LíneString, nó imlíne a:aicme: Polygon).
\nFilleann GEOS PrepareidGeometry le haghaidh ábhar an geoiméadra seo. Déantar rudaí ``Geoiméadracht ullmhaithe “a bharrfheabhsú le haghaidh na n-ábhar, trasna, clúdaigh, croisí, neamhchoitianta, forluí, teagmhálacha agus laistigh d'oibríochtaí. Féach ar an doiciméadach:ref: ullmhai-geoiméadraitheach le haghaidh tuilleadh faisnéise.
Tuairisceáin a:class: ~django.contrib.gis.gdal.spatialReference réad a fhreagraíonn do SRID an geoiméadair nó None.
Athraíonn sé an geoiméadra de réir an pharaiméadar claochlaithe comhordaithe tugtha (ct`), a d'fhéadfadh a bheith ina SRID sláimhir, teaghrán spásúil WKT, teaghrán PROJ, a:class: ~django.contrib.gis.gdal.spatialReference réad, nó a:class: ~django.contrib.gis.gdal.coordTransform. De réir réamhshocraithe, déantar an geoiméadra a athrú in áit agus ní thugtar aon rud ar ais Mar sin féin má shocraítear an eochairfhocal “clón”, ansin ní mhodhnaítear an geoiméadra agus cuirtear clón claochlaithe den ghéiméadracht ar ais ina ionad sin.
\n\nTugann sé coibhéis bailí:class: GeosGeometry ar ais, ag iarraidh gan aon cheann de na beartacha ionchuir a chailleadh. Má tá an geoiméadra bailí cheana féin, cuirtear ar ais gan teagmháil leis. Tá sé seo cosúil leis an bhfeidhm bunachar sonraí:: class: ~django.contrib.gis.db.models.functions.MakeValid. Éilíonn GEOS 3.8.
\nAthraíonn sé an geoiméadra seo go foirm canónach. Má shocraítear an eochairfhocal ``clón`, ansin ní mhodhnaítear an geoiméadra agus cuirtear clón normalaithe den ghéimseata ar ais ina ionad sin:
\n>>> g = MultiPoint(Point(0, 0), Point(2, 2), Point(1, 1))\n>>> print(g)\nMULTIPOINT (0 0, 2 2, 1 1)\n>>> g.normalize()\n>>> print(g)\nMULTIPOINT (2 2, 1 1, 0 0)\nPointLink to this heading#Déantar rudaí Point a thionscnamh ag baint úsáide as argóintí a léiríonn comhordanáidí comhpháirteanna an phointe nó le comhordanáidí seicheamh amháin. Mar shampla, tá na nithe seo a leanas coibhéiseach:
>>> pnt = Point(5, 23)\n>>> pnt = Point([5, 23])\nFéadfar rudaí folmha Point a chur isteach trí aon argóintí nó seicheamh folamh a chur ar aghaidh. Tá na nithe seo a leanas comhionann:
>>> pnt = Point()\n>>> pnt = Point([])\nLínestringLink to this heading#Déantar rudaí LíneString` a ionchasadh ag baint úsáide as argóintí atá ina seicheamh comhordanáidí nó: aicme: Point rudaí. Mar shampla, tá na nithe seo a leanas coibhéiseach:
\n>>> ls = LineString((0, 0), (1, 1))\n>>> ls = LineString(Point(0, 0), Point(1, 1))\nIna theannta sin, féadfar rudaí LíneString` a chruthú freisin trí sheicheamh amháin de rudaí comhordaithe nó: aicme: Point a rith i seacham amháin:
\n>>> ls = LineString(((0, 0), (1, 1)))\n>>> ls = LineString([Point(0, 0), Point(1, 1)])\nFéadfar rudaí folmha LíneString a thionscnamh trí aon argóintí nó seicheamh folamh a chur ar aghaidh. Tá na nithe seo a leanas comhionann:
>>> ls = LineString()\n>>> ls = LineString([])\nTugann sé ar ais cibé an bhfuil an Linestring` seo dúnta nó nach bhfuil.
\nLínearLink to this heading#Tógtar rudaí Línearing` ar an mbealach céanna le rudaí: aicme: LíneString, ach caithfidh na comhordanáidí* a bheith dúnta, is é sin le rá, caithfidh na chéad chomhordanáidí a bheith mar an gcéanna leis na comhordanáidí deireanacha. Mar shampla:
\n>>> ls = LinearRing((0, 0), (0, 1), (1, 1), (0, 0))\nTabhair faoi deara gurb é (0, 0) an chéad chomhordú agus an comhordú deireanach - mura mbeadh siad comhionann, ardófaí earráid.
Tugann sé ar ais cibé an bhfuil an Línearing` seo i gcoinne.
\nPolygónLink to this heading#Polygon objects may be instantiated by passing in parameters that\nrepresent the rings of the polygon. The parameters must either be\nLinearRing instances, or a sequence that may be used to construct\na LinearRing:
>>> ext_coords = ((0, 0), (0, 1), (1, 1), (1, 0), (0, 0))\n>>> int_coords = ((0.4, 0.4), (0.4, 0.6), (0.6, 0.6), (0.6, 0.4), (0.4, 0.4))\n>>> poly = Polygon(ext_coords, int_coords)\n>>> poly = Polygon(LinearRing(ext_coords), LinearRing(int_coords))\nTugann sé réad polagún ar ais ón mbosca teorainn a thugtar, 4 tuipéil ina bhfuil (xmin, ymin, xmax, ymax).
Filleann líon na bhfáinní taobh istigh sa geoiméadracht seo.
\nIlphointLink to this heading#Féadfar rudaí multipoint a chur isteach trí rudaí: aicme: Point a rith mar argóintí, nó seicheamh amháin de:class: Point rudaí:
>>> mp = MultiPoint(Point(0, 0), Point(1, 1))\n>>> mp = MultiPoint((Point(0, 0), Point(1, 1)))\nMultilinestringLink to this heading#Féadfar rudaí MultilineString a chur isteach trí rudaí: class: Linestring a chur isteach mar argóintí, nó seicheamh amháin de:class: LineString rudaí:
>>> ls1 = LineString((0, 0), (1, 1))\n>>> ls2 = LineString((2, 2), (3, 3))\n>>> mls = MultiLineString(ls1, ls2)\n>>> mls = MultiLineString([ls1, ls2])\nTuairisceáin a: aicme: LíneString a léiríonn cumasc líne na gcomhpháirteanna go léir sa Multilinestring` seo.
\nTugann sé “Fíor” ar ais má tá gach eilimint dúnta agus amháin má tá gach eilimint dúnta.
\nMultipolygonLink to this heading#Féadfar rudaí Multipolygon` a thionscnamh trí rudaí pas:class: Polygon mar argóintí, nó seicheamh amháin de:class: Polygon rudaí:
\n>>> p1 = Polygon(((0, 0), (0, 1), (1, 1), (0, 0)))\n>>> p2 = Polygon(((1, 1), (1, 2), (2, 2), (1, 1)))\n>>> mp = MultiPolygon(p1, p2)\n>>> mp = MultiPolygon([p1, p2])\nBailiúchán GeoiméadrachLink to this heading#Féadfar rudaí Geoimetrach a thionscnamh trí:class: GeosGeometry eile a rith mar argóintí, nó seicheamh amháin de:class: Geosgeoimetrry rudaí:
>>> poly = Polygon(((0, 0), (0, 1), (1, 1), (0, 0)))\n>>> gc = GeometryCollection(Point(0, 0), MultiPoint(Point(0, 0), Point(1, 1)), poly)\n>>> gc = GeometryCollection((Point(0, 0), MultiPoint(Point(0, 0), Point(1, 1)), poly))\nIn order to obtain a prepared geometry, access the\nGEOSGeometry.prepared property. Once you have a PreparedGeometry\ninstance its spatial predicate methods, listed below, may be used with other\nGEOSGeometry objects. An operation with a prepared geometry can be orders\nof magnitude faster -- the more complex the geometry that is prepared, the\nlarger the speedup in the operation. For more information, please consult the\nGEOS wiki page on prepared geometries.
Mar shampla:
\n>>> from django.contrib.gis.geos import Point, Polygon\n>>> poly = Polygon.from_bbox((0, 0, 5, 5))\n>>> prep_poly = poly.prepared\n>>> prep_poly.contains(Point(2.5, 2.5))\nTrue\nGeoiméadracht ullmhaitheLink to this heading#Glacann gach modh ar Réamh-Geoiméadracht argóint ``eile ``, a chaithfidh a bheith ina sampla a:class: Geosgeoimetrry.
file_h (a Python file object or a string path to the file) -- comhad ionchuir ina bhfuil sonraí spásúla
a: aicme: GeosGeometry a fhreagraíonn do na sonraí spásúla sa chomhad
\nSampla:
\n>>> from django.contrib.gis.geos import fromfile\n>>> g = fromfile("/home/bob/geom.wkt")\na: aicme: Geosgeometry a fhreagraíonn do na sonraí spásúla sa sreangán
\n<GEOSGeometry>Tá ``fromstr (string, srid) ``comhionann le:aicme: `GeosGeometracht (string, srid) `.
\nSampla:
\n>>> from django.contrib.gis.geos import fromstr\n>>> pnt = fromstr("POINT(-90.5 29.5)", srid=4326)\nTugann ranganna I/O an léitheora a: class: GeosGeometry ar ais ón ionchur WKB agus/nó WKT a thugtar dá modh léite (geom) `.
\nSampla:
\n>>> from django.contrib.gis.geos import WKBReader\n>>> wkb_r = WKBReader()\n>>> wkb_r.read("0101000000000000000000F03F000000000000F03F")\n<Point object at 0x103a88910>\nSampla:
\n>>> from django.contrib.gis.geos import WKTReader\n>>> wkt_r = WKTReader()\n>>> wkt_r.read("POINT(1 1)")\n<Point object at 0x103a88b50>\nAll writer objects have a write(geom) method that returns either the\nWKB or WKT of the given geometry. In addition, WKBWriter objects\nalso have properties that may be used to change the byte order, and or\ninclude the SRID value (in other words, EWKB).
WKBWriter provides the most control over its output. By default it\nreturns OGC-compliant WKB when its write method is called. However,\nit has properties that allow for the creation of EWKB, a superset of the\nWKB standard that includes additional information. See the\nWKBWriter.outdim documentation for more details about the dim\nargument.
Tugann sé WKB an ghéimseadracht a thugtar ar ais mar réad Python buffer. Sampla:
>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> pnt = Point(1, 1)\n>>> wkb_w = WKBWriter()\n>>> wkb_w.write(pnt)\n<read-only buffer for 0x103a898f0, size -1, offset 0 at 0x103a89930>\nReturns WKB of the geometry in hexadecimal. Example:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> pnt = Point(1, 1)\n>>> wkb_w = WKBWriter()\n>>> wkb_w.write_hex(pnt)\n'0101000000000000000000F03F000000000000F03F'\nFéadfar an maoin seo a shocrú chun ordú báite na léiriúcháin geoiméadrachta a athrú.
\nLuach Byteorder | \nCur síos | \n
|---|---|
0 | \nBig Endian (m.sh., comhoiriúnach le córais RISC) | \n
1 | \nLittle Endian (m.sh., comhoiriúnach le córais x86) | \n
Sampla:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> wkb_w = WKBWriter()\n>>> pnt = Point(1, 1)\n>>> wkb_w.write_hex(pnt)\n'0101000000000000000000F03F000000000000F03F'\n>>> wkb_w.byteorder = 0\n'00000000013FF00000000000003FF0000000000000'\nThis property may be set to change the output dimension of the geometry\nrepresentation. In other words, if you have a 3D geometry then set to 3\nso that the Z value is included in the WKB.
\nLuach Outdim | \nCur síos | \n
|---|---|
2 | \nAn réamhshocraithe, aschur 2D WKB. | \n
3 | \nAschur 3D WKB. | \n
Sampla:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> wkb_w = WKBWriter()\n>>> wkb_w.outdim\n2\n>>> pnt = Point(1, 1, 1)\n>>> wkb_w.write_hex(pnt) # By default, no Z value included:\n'0101000000000000000000F03F000000000000F03F'\n>>> wkb_w.outdim = 3 # Tell writer to include Z values\n>>> wkb_w.write_hex(pnt)\n'0101000080000000000000F03F000000000000F03F000000000000F03F'\nSet this property with a boolean to indicate whether the SRID of the\ngeometry should be included with the WKB representation. Example:
\n>>> from django.contrib.gis.geos import Point, WKBWriter\n>>> wkb_w = WKBWriter()\n>>> pnt = Point(1, 1, srid=4326)\n>>> wkb_w.write_hex(pnt) # By default, no SRID included:\n'0101000000000000000000F03F000000000000F03F'\n>>> wkb_w.srid = True # Tell writer to include SRID\n>>> wkb_w.write_hex(pnt)\n'0101000020E6100000000000000000F03F000000000000F03F'\nLigeann an rang seo léiriú WKT de ghéiméadracht a chur amach. Féach na tréithe: attr: wkbwriter.outdim, :attr: trim, agus:attr: precision le haghaidh sonraí faoi argóintí an tógálaí.
\nTugann sé ar ais WKT an ghéiméadracht a thugtar. Sampla:
\n>>> from django.contrib.gis.geos import Point, WKTWriter\n>>> pnt = Point(1, 1)\n>>> wkt_w = WKTWriter()\n>>> wkt_w.write(pnt)\n'POINT (1.0000000000000000 1.0000000000000000)'\nFéach: attr: WKBWriter.outdim.
\nÚsáidtear an maoin seo chun gearradh deochlacha gan ghá a chumasú nó a dhíchumasú.
\n>>> from django.contrib.gis.geos import Point, WKTWriter\n>>> pnt = Point(1, 1)\n>>> wkt_w = WKTWriter()\n>>> wkt_w.trim\nFalse\n>>> wkt_w.write(pnt)\n'POINT (1.0000000000000000 1.0000000000000000)'\n>>> wkt_w.trim = True\n>>> wkt_w.write(pnt)\n'POINT (1 1)'\nRialaíonn an maoin seo cruinneas timpeallaithe na gcomhordanáidí; má tá sé socraithe go None díchumasaítear an timpeallú.
>>> from django.contrib.gis.geos import Point, WKTWriter\n>>> pnt = Point(1.44, 1.66)\n>>> wkt_w = WKTWriter()\n>>> print(wkt_w.precision)\nNone\n>>> wkt_w.write(pnt)\n'POINT (1.4399999999999999 1.6599999999999999)'\n>>> wkt_w.precision = 0\n>>> wkt_w.write(pnt)\n'POINT (1 2)'\n>>> wkt_w.precision = 1\n>>> wkt_w.write(pnt)\n'POINT (1.4 1.7)'\nFonótaí
\n\nCONAIR_LEABHARLANNA_GEOSLink to this heading#A string specifying the location of the GEOS C library. Typically,\nthis setting is only used if the GEOS C library is in a non-standard\nlocation (e.g., /home/bob/lib/libgeos_c.so).
Léiríonn an buneisceacht GEOS earráid a bhaineann le GEOS.
\n