Changes between Version 43 and Version 44 of GeoDjango

Timestamp:

Mar 25, 2007, 2:35:37 PM (17 years ago)

Author:

jbronn

Comment:

improved Model API section

GeoDjango

@@ -212 +212 @@
 
 == Creating a Geometry Object and Saving ==
-Here is an example of how to create a geometry object (assuming the {{{Zip}}} model example above).  Geometries can be represented in either the WKT (Well Known Text) format, or in HEXEWKB (PostGIS specific, essentially a WKB geometry in hexadecimal).   ''See'' Open GIS Consortium, Inc., ''[http://portal.opengeospatial.org/files/?artifact_id=829&ei=Z5oGRv6aCZ-IwQKh2LXwAw&usg=__4YgoHsbqjocl8Z01SwMAyN84aW0=&sig2=4DpSpm83ZDEIBKSivWcYGQ OpenGIS Simple Feature Specification For SQL]'', Document 99-049 (May 5, 1999), at  Ch. 3.2.5 (SQL Textual Representation of Geometry, pg. 53); ''see also'' [http://postgis.refractions.net/docs/ch04.html#id2904792 "PostGIS EWKB, EWKT and Canonical Forms"], PostGIS documentation at Ch. 4.1.2.
+Here is an example of how to create a geometry object (assuming the {{{Zip}}} model example above):
+
 {{{
 >>> from zipcode.models import Zip
@@ -218 +219 @@
 >>> z.save()
 }}}
+
+Geometries are represented as '''strings''' in either of the formats WKT (Well Known Text) or HEXEWKB (PostGIS specific, essentially a WKB geometry in hexadecimal).  For example:
+ * WKT Polygon: {{{'POLYGON(( 10 10, 10 20, 20 20, 20 15, 10 10))'}}}
+ * HEXEWKB Polygon: '{{{0103000000010000000 ... 00000000000002440'}}}
+
+'''References:'''
+ * ''See'' Open GIS Consortium, Inc., ''[http://portal.opengeospatial.org/files/?artifact_id=829&ei=Z5oGRv6aCZ-IwQKh2LXwAw&usg=__4YgoHsbqjocl8Z01SwMAyN84aW0=&sig2=4DpSpm83ZDEIBKSivWcYGQ OpenGIS Simple Feature Specification For SQL]'', Document 99-049 (May 5, 1999), at  Ch. 3.2.5 (SQL Textual Representation of Geometry, pg. 53).
+ * ''See also'' [http://postgis.refractions.net/docs/ch04.html#id2904792 "PostGIS EWKB, EWKT and Canonical Forms"], PostGIS documentation at Ch. 4.1.2.
 
 = Database API =
@@ -263 +272 @@
 
 == PostGIS GEOS Function Field Lookup Types ==
- * ''See generally'' "Geometry Relationship Functions", PostGIS Documentation at Ch. 6.1.2.  This documentation will be updated completely with the content from the aforementioned PostGIS docs.
+ * ''See generally'' [http://postgis.refractions.net/docs/ch06.html#id2615853 "Geometry Relationship Functions", PostGIS Documentation at Ch. 6.1.2].  This documentation will be updated completely with the content from the aforementioned PostGIS docs.
  * {{{distance}}}
    * Return the cartesian distance between two geometries in projected units.