From: Sandro Santilli Date: Fri, 17 Oct 2014 16:57:51 +0000 (+0000) Subject: Import Polish translation from transifex, enable it X-Git-Tag: 2.2.0rc1~765 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e0d2e932bd0b0919d4b4a124919976646b48fc8d;p=postgis Import Polish translation from transifex, enable it Updated translations were also re-pushed on transifex git-svn-id: http://svn.osgeo.org/postgis/trunk@13086 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/Makefile.in b/doc/Makefile.in index 80f9e415a..0b4f3ff53 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -21,7 +21,7 @@ # that we could produce a large number of files (think chunked HTML) # -translations = it_IT pt_BR fr es +translations = it_IT pt_BR fr es pl POSTGIS_MAJOR_VERSION=@POSTGIS_MAJOR_VERSION@ POSTGIS_MINOR_VERSION=@POSTGIS_MINOR_VERSION@ diff --git a/doc/po/pl/Makefile b/doc/po/pl/Makefile new file mode 100644 index 000000000..0693327df --- /dev/null +++ b/doc/po/pl/Makefile @@ -0,0 +1,2 @@ +DOCSUFFIX=-pl +include ../Makefile.local diff --git a/doc/po/pl/extras.xml.po b/doc/po/pl/extras.xml.po new file mode 100644 index 000000000..8af826dcd --- /dev/null +++ b/doc/po/pl/extras.xml.po @@ -0,0 +1,40 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2014-10-14 22:30+0000\n" +"PO-Revision-Date: 2014-10-14 22:34+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: extras.xml:3 +#, no-c-format +msgid "PostGIS Extras" +msgstr "" + +#. Tag: para +#: extras.xml:5 +#, no-c-format +msgid "" +"This chapter documents features found in the extras folder of the PostGIS " +"source tarballs and source repository. These are not always packaged with " +"PostGIS binary releases, but are usually plpgsql based or standard shell " +"scripts that can be run as is." +msgstr "" + +#. Tag: chapter +#: extras.xml:6 +#, no-c-format +msgid "&extras_tigergeocoder;" +msgstr "" diff --git a/doc/po/pl/extras_address_standardizer.xml.po b/doc/po/pl/extras_address_standardizer.xml.po new file mode 100644 index 000000000..b09a7f646 --- /dev/null +++ b/doc/po/pl/extras_address_standardizer.xml.po @@ -0,0 +1,853 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2014-10-10 23:07+0000\n" +"PO-Revision-Date: 2014-10-13 18:05+0000\n" +"Last-Translator: FULL NAME \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: extras_address_standardizer.xml:3 +#, no-c-format +msgid "Address Standardizer" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:4 +#, no-c-format +msgid "" +"This is a fork of the PAGC standardizer (original code for this portion was PAGC PostgreSQL Address Standardizer)." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:5 +#, no-c-format +msgid "" +"The address standardizer is a single line address parser that takes an input " +"address and normalizes it based on a set of rules stored in a table and " +"helper lex and gaz tables." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:6 +#, no-c-format +msgid "" +"The code is built into a single postgresql extension library called " +"address_standardizer which can be installed with CREATE " +"EXTENSION address_standardizer;." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:7 +#, no-c-format +msgid "" +"The code for this extension can be found in the PostGIS extensions/" +"address_standardizer and is currently self-contained." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:8 +#, no-c-format +msgid "" +"For installation instructions refer to: ." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:9 +#, no-c-format +msgid "How the Parser Works" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:10 +#, no-c-format +msgid "" +"The parser works from right to left looking first at the macro elements for " +"postcode, state/province, city, and then looks micro elements to determine " +"if we are dealing with a house number street or intersection or landmark. It " +"currently does not look for a country code or name, but that could be " +"introduced in the future." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:17 +#, no-c-format +msgid "Country code" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:18 +#, no-c-format +msgid "" +"Assumed to be US or CA based on: postcode as US or Canada state/province as " +"US or Canada else US" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:21 +#, no-c-format +msgid "Postcode/zipcode" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:22 +#, no-c-format +msgid "" +"These are recognized using Perl compatible regular expressions. These regexs " +"are currently in the parseaddress-api.c and are relatively simple to make " +"changes to if needed." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:27 +#, no-c-format +msgid "State/province" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:28 +#, no-c-format +msgid "" +"These are recognized using Perl compatible regular expressions. These regexs " +"are currently in the parseaddress-api.c but could get moved into includes in " +"the future for easier maintenance." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:37 +#, no-c-format +msgid "" +"This section lists the PostgreSQL data types installed by Address " +"Standardizer extension. Note we describe the casting behavior of these which " +"is very important especially when designing your own functions." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:42 +#, no-c-format +msgid "Address Standardizer Types" +msgstr "" + +#. Tag: refname +#: extras_address_standardizer.xml:45 +#, no-c-format +msgid "stdaddr" +msgstr "" + +#. Tag: refpurpose +#: extras_address_standardizer.xml:46 +#, no-c-format +msgid "" +"A composite type that consists of the elements of an address. This is the " +"return type for standardize_address function." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:49 extras_address_standardizer.xml:152 +#: extras_address_standardizer.xml:214 extras_address_standardizer.xml:256 +#: extras_address_standardizer.xml:314 extras_address_standardizer.xml:373 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:50 +#, no-c-format +msgid "" +"A composite type that consists of elements of an address. This is the return " +"type for function. Some descriptions " +"for elements are borrowed from PAGC Postal Attributes." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:51 +#, no-c-format +msgid "" +"The token numbers denote the reference number in the rules table." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:52 extras_address_standardizer.xml:321 +#: extras_address_standardizer.xml:379 +#, no-c-format +msgid "&address_standardizer_required;" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:55 +#, no-c-format +msgid "building" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:57 +#, no-c-format +msgid "" +"is text (token number 0): Refers to building number or name. " +"Unparsed building identifiers and types. Generally blank for most addresses." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:60 +#, no-c-format +msgid "house_num" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:62 +#, no-c-format +msgid "" +"is a text (token number 1): This is the street number on a " +"street. Example 75 in 75 State Street." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:65 +#, no-c-format +msgid "predir" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:66 +#, no-c-format +msgid "" +"is text (token number 2): STREET NAME PRE-DIRECTIONAL such as " +"North, South, East, West etc." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:68 +#, no-c-format +msgid "qual" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:70 +#, no-c-format +msgid "" +"is text (token number 3): STREET NAME PRE-MODIFIER Example " +"OLD in 3715 OLD HIGHWAY 99." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:73 +#, no-c-format +msgid "pretype" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:75 +#, no-c-format +msgid "is text (token number 4): STREET PREFIX TYPE" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:78 +#, no-c-format +msgid "name" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:80 +#, no-c-format +msgid "is text (token number 5): STREET NAME" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:83 +#, no-c-format +msgid "suftype" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:85 +#, no-c-format +msgid "" +"is text (token number 6): STREET POST TYPE e.g. St, Ave, Cir. A " +"street type following the root street name. Example STREET in 75 State Street." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:88 +#, no-c-format +msgid "sufdir" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:90 +#, no-c-format +msgid "" +"is text (token number 7): STREET POST-DIRECTIONAL A directional " +"modifier that follows the street name.. Example WEST in " +"3715 TENTH AVENUE WEST." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:93 +#, no-c-format +msgid "ruralroute" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:95 +#, no-c-format +msgid "" +"is text (token number 8): RURAL ROUTE . Example 8 in RR 7." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:98 +#, no-c-format +msgid "extra" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:100 +#, no-c-format +msgid "is text: Extra information like Floor number." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:103 +#, no-c-format +msgid "city" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:105 +#, no-c-format +msgid "is text (token number 10): Example Boston." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:108 +#, no-c-format +msgid "state" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:110 +#, no-c-format +msgid "" +"is text (token number 11): Example MASSACHUSETTS" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:113 +#, no-c-format +msgid "country" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:115 +#, no-c-format +msgid "is text (token number 12): Example USA" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:118 +#, no-c-format +msgid "postcode" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:120 +#, no-c-format +msgid "" +"is text POSTAL CODE (ZIP CODE) (token number 13): Example " +"02109" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:123 +#, no-c-format +msgid "box" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:125 +#, no-c-format +msgid "" +"is text POSTAL BOX NUMBER (token number 14 and 15): Example " +"02109" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:128 +#, no-c-format +msgid "unit" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:130 +#, no-c-format +msgid "" +"is text Apartment number or Suite Number (token number 17): " +"Example 3B in APT 3B." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:141 +#, no-c-format +msgid "" +"This section lists the PostgreSQL table formats used by the " +"address_standardizer for normalizing addresses. Note that these tables do " +"not need to be named the same as what is referenced here. You can have " +"different lex, gaz, rules tables for each country for example or for your " +"custom geocoder. The names of these tables get passed into the address " +"standardizer functions." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:145 +#, no-c-format +msgid "Address Standardizer Tables" +msgstr "" + +#. Tag: refname +#: extras_address_standardizer.xml:148 +#, no-c-format +msgid "rules table" +msgstr "" + +#. Tag: refpurpose +#: extras_address_standardizer.xml:149 +#, no-c-format +msgid "" +"The rules table contains a set of rules that maps address input sequence " +"tokens to standardized output sequence" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:153 +#, no-c-format +msgid "" +"A rules table must have at least the following columns, though you are " +"allowed to add more for your own uses." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:157 extras_address_standardizer.xml:220 +#: extras_address_standardizer.xml:262 +#, no-c-format +msgid "id" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:159 extras_address_standardizer.xml:222 +#: extras_address_standardizer.xml:264 +#, no-c-format +msgid "Primary key of table" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:162 +#, no-c-format +msgid "rule" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:164 +#, no-c-format +msgid "" +"text field denoting the rule. Details at PAGC Address Standardizer Rule records." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:165 +#, no-c-format +msgid "" +"A rule consists of a set of non-negative integers representing input tokens, " +"terminated by a -1, followed by an equal number of non-negative integers " +"representing postal attributes, terminated by a -1, followed by an integer " +"representing a rule type, followed by an integer representing the rank of " +"the rule. The rules are ranked from 0 (lowest) to 17 (highest)." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:166 +#, no-c-format +msgid "" +"So for example the rule 2 0 2 22 3 -1 5 5 6 7 3 -1 2 6 maps to " +"sequence of tokens TYPE NUMBER TYPE DIRECT QUALIF to " +"the output sequence STREET STREET SUFTYP SUFDIR QUALIF. " +"The rule is an ARC_C rule of rank 6." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:171 +#, no-c-format +msgid "Each rule has a rule type which is denoted by one of following:" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:174 +#, no-c-format +msgid "MACRO_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:176 +#, no-c-format +msgid "(token number = \"0\"). The class of rules for parsing MACRO clauses." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:180 +#, no-c-format +msgid "MICRO_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:182 +#, no-c-format +msgid "" +"(token number = \"1\"). The class of rules for parsing full MICRO clauses " +"(ie ARC_C plus CIVIC_C). These rules are not used in the build phase." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:186 +#, no-c-format +msgid "ARC_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:188 +#, no-c-format +msgid "" +"(token number = \"2\"). The class of rules for parsing MICRO clauses, " +"excluding the HOUSE attribute." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:192 +#, no-c-format +msgid "CIVIC_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:194 +#, no-c-format +msgid "" +"(token number = \"3\"). The class of rules for parsing the HOUSE attribute." +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:198 +#, no-c-format +msgid "EXTRA_C" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:200 +#, no-c-format +msgid "" +"(token number = \"4\"). The class of rules for parsing EXTRA attributes - " +"attributes excluded from geocoding. These rules are not used in the build " +"phase." +msgstr "" + +#. Tag: refname +#: extras_address_standardizer.xml:210 +#, no-c-format +msgid "lex table" +msgstr "" + +#. Tag: refpurpose +#: extras_address_standardizer.xml:211 +#, no-c-format +msgid "" +"A lex table is used to classify alphanumeric input and associate that input " +"with (a) input tokens ( See Input Tokens) and (b) standardized " +"representations." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:215 +#, no-c-format +msgid "" +"A lex (short for lexicon) table is used to classify alphanumeric input and " +"associate that input with (a) input tokens and (b) standardized " +"representations. Things you will find in these tables are ONE " +"mapped to stdworkd: 1." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:217 +#, no-c-format +msgid "A lex has at least the following columns in the table. You may add" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:225 extras_address_standardizer.xml:267 +#, no-c-format +msgid "seq" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:227 extras_address_standardizer.xml:269 +#, no-c-format +msgid "integer: definition number?" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:231 extras_address_standardizer.xml:272 +#, no-c-format +msgid "word" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:233 extras_address_standardizer.xml:274 +#, no-c-format +msgid "text: the input word" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:236 extras_address_standardizer.xml:277 +#, no-c-format +msgid "stdword" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:238 extras_address_standardizer.xml:279 +#, no-c-format +msgid "text: the standardized replacement word" +msgstr "" + +#. Tag: term +#: extras_address_standardizer.xml:241 extras_address_standardizer.xml:282 +#, no-c-format +msgid "token" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:243 extras_address_standardizer.xml:284 +#, no-c-format +msgid "" +"integer: the kind of word it is. Only if it is used in this context will it " +"be replaced. Refer to PAGC Tokens." +msgstr "" + +#. Tag: refname +#: extras_address_standardizer.xml:252 +#, no-c-format +msgid "gaz table" +msgstr "" + +#. Tag: refpurpose +#: extras_address_standardizer.xml:253 +#, no-c-format +msgid "" +"A gaz table is used to standardize place names and associate that input with " +"(a) input tokens ( See Input Tokens) and (b) standardized representations." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:257 +#, no-c-format +msgid "" +"A gaz (short for gazeteer) table is used to classify place names and " +"associate that input with (a) input tokens and (b) standardized " +"representations. For example if you are in US, you may load these with State " +"Names and associated abbreviations." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:259 +#, no-c-format +msgid "" +"A gaz table has at least the following columns in the table. You may add " +"more columns if you wish for your own purposes." +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:295 +#, no-c-format +msgid "Address Standardizer Functions" +msgstr "" + +#. Tag: refname +#: extras_address_standardizer.xml:298 +#, no-c-format +msgid "parse_address" +msgstr "" + +#. Tag: refpurpose +#: extras_address_standardizer.xml:300 +#, no-c-format +msgid "Takes a 1 line address and breaks into parts" +msgstr "" + +#. Tag: funcprototype +#: extras_address_standardizer.xml:305 +#, no-c-format +msgid "" +"record parse_address " +"text address" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:316 +#, no-c-format +msgid "" +"Returns takes as input an address, and returns a record output consisting of " +"fields num, street, " +"street2, address1, city, state, zip, " +"zipplus, country." +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:320 extras_address_standardizer.xml:378 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:326 extras_address_standardizer.xml:384 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: extras_address_standardizer.xml:328 +#, no-c-format +msgid "" +"SELECT num, street, city, zip, zipplus FROM parse_address('1 Devonshire " +"Place, Boston, MA 02109-1234');\n" +" num | street | city | zip | zipplus\n" +"-----+------------------+--------+-------+---------\n" +" 1 | Devonshire Place | Boston | 02109 | 1234" +msgstr "" + +#. Tag: title +#: extras_address_standardizer.xml:338 extras_address_standardizer.xml:417 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: extras_address_standardizer.xml:346 +#, no-c-format +msgid "standardize_address" +msgstr "" + +#. Tag: refpurpose +#: extras_address_standardizer.xml:348 +#, no-c-format +msgid "" +"Returns an stdaddr form of an input address utilizing lex, gaz, and rule " +"tables." +msgstr "" + +#. Tag: funcsynopsis +#: extras_address_standardizer.xml:352 +#, no-c-format +msgid "" +" stdaddr standardize_address text lextab text gaztab text rultab text address stdaddr " +"standardize_address text lextab text " +"gaztab text " +"rultab text " +"micro text " +"macro " +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:375 +#, no-c-format +msgid "" +"Returns an form of an input address utilizing " +" table name, , and table names and an address." +msgstr "" + +#. Tag: programlisting +#: extras_address_standardizer.xml:386 +#, no-c-format +msgid "" +"SELECT * FROM standardize_address('tiger.pagc_lex', \n" +" 'tiger.pagc_gaz', 'tiger.pagc_rules', 'One " +"Devonshire Place, PH 301, Boston, MA 02109-1234');" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:389 +#, no-c-format +msgid "" +"Make easier to read we'll dump output using hstore extension CREATE " +"EXTENSION hstore; you need to install" +msgstr "" + +#. Tag: programlisting +#: extras_address_standardizer.xml:390 +#, no-c-format +msgid "" +"SELECT (each(hstore(p))).* \n" +" FROM standardize_address('tiger.pagc_lex', 'tiger.pagc_gaz', \n" +" 'tiger.pagc_rules', 'One Devonshire Place, PH 301, Boston, MA " +"02109-1234') As p;" +msgstr "" + +#. Tag: screen +#: extras_address_standardizer.xml:393 +#, no-c-format +msgid "" +"key | value\n" +"------------+-----------------\n" +" box |\n" +" city | BOSTON\n" +" name | DEVONSHIRE\n" +" qual |\n" +" unit | # PENTHOUSE 301\n" +" extra |\n" +" state | MA\n" +" predir |\n" +" sufdir |\n" +" country | USA\n" +" pretype |\n" +" suftype | PL\n" +" building |\n" +" postcode | 02109\n" +" house_num | 1\n" +" ruralroute |\n" +"(16 rows)" +msgstr "" + +#. Tag: para +#: extras_address_standardizer.xml:419 +#, no-c-format +msgid "" +", , , ," +msgstr "" diff --git a/doc/po/pl/extras_historytable.xml.po b/doc/po/pl/extras_historytable.xml.po new file mode 100644 index 000000000..96b6753cc --- /dev/null +++ b/doc/po/pl/extras_historytable.xml.po @@ -0,0 +1,262 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: extras_historytable.xml:3 +#, no-c-format +msgid "History Tracking" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:6 +#, no-c-format +msgid "" +"Suppose you have a table of data that represents the current state of a " +"particular geographic feature. A parcels table, or a roads table, or a fruit " +"trees table, whatever. Generally, GIS tools understand a table as a single " +"entity into which they can update, insert and delete rows from. How you do " +"allow common GIS tools to work against your data, while maintaining an audit " +"trail of what changes have been made, by whom, and what the past state of " +"the data is?" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:10 +#, no-c-format +msgid "" +"This history_table extra module provides some utility " +"functions for creating and maintaining history." +msgstr "" + +#. Tag: para +#: extras_historytable.xml:14 +#, no-c-format +msgid "" +"The history_table was also packaged in PostGIS 1.5, but " +"added to the documentation in PostGIS 2.0. This package is written in " +"plpgsql and located in the extras/history_table of " +"PostGIS source tar balls and source repository." +msgstr "" + +#. Tag: para +#: extras_historytable.xml:15 +#, no-c-format +msgid "" +"If you have a table 'roads', this module will maintain a 'roads_history' " +"side table, which contains all the columns of the parent table, and the " +"following additional columns:" +msgstr "" + +#. Tag: programlisting +#: extras_historytable.xml:16 +#, no-c-format +msgid "" +"history_id | integer | not null default \n" +" date_added | timestamp without time zone | not null default now()\n" +" date_deleted | timestamp without time zone | \n" +" last_operation | character varying(30) | not null\n" +" active_user | character varying(90) | not null default " +"\"current_user\"()\n" +" current_version | text | not null" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:20 +#, no-c-format +msgid "" +"When you insert a new record into 'roads' a record is automatically inserted " +"into 'roads_history', with the 'date_added' filled in the 'date_deleted' set " +"to NULL, a unique 'history_id', a 'last_operation' of 'INSERT' and " +"'active_user' set." +msgstr "" + +#. Tag: para +#: extras_historytable.xml:23 +#, no-c-format +msgid "" +"When you delete a record in 'roads', the record in the history table is " +"*not* deleted, but the 'date_deleted' is set to the current date." +msgstr "" + +#. Tag: para +#: extras_historytable.xml:26 +#, no-c-format +msgid "" +"When you update a record in 'roads', the current record has 'date_deleted' " +"filled in and a new record is created with the 'date_added' set and " +"'date_deleted' NULL." +msgstr "" + +#. Tag: para +#: extras_historytable.xml:30 +#, no-c-format +msgid "" +"With this information maintained, it is possible to retrieve the history of " +"any record in the roads table:" +msgstr "" + +#. Tag: programlisting +#: extras_historytable.xml:31 +#, no-c-format +msgid "SELECT * FROM roads_history WHERE roads_pk = 111;" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:33 +#, no-c-format +msgid "Or, to retrieve a view of the roads table at any point in the past:" +msgstr "" + +#. Tag: programlisting +#: extras_historytable.xml:34 +#, no-c-format +msgid "" +"SELECT * FROM roads_history \n" +" WHERE date_added < 'January 1, 2001' AND \n" +" ( date_deleted >= 'January 1, 2001' OR date_deleted IS NULL );" +msgstr "" + +#. Tag: refname +#: extras_historytable.xml:38 +#, no-c-format +msgid "Postgis_Install_History" +msgstr "" + +#. Tag: refpurpose +#: extras_historytable.xml:39 +#, no-c-format +msgid "" +"Creates a table that will hold some interesting values for managing history " +"tables." +msgstr "" + +#. Tag: funcprototype +#: extras_historytable.xml:44 +#, no-c-format +msgid "" +"void Postgis_Install_History " +"" +msgstr "" + +#. Tag: title +#: extras_historytable.xml:52 extras_historytable.xml:92 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:54 +#, no-c-format +msgid "" +"Creates a table that will hold some interesting values for managing history " +"tables. Creates a table called historic_information" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:58 extras_historytable.xml:100 +#, no-c-format +msgid "Availability: 1.5.0" +msgstr "" + +#. Tag: title +#: extras_historytable.xml:63 extras_historytable.xml:105 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: extras_historytable.xml:65 +#, no-c-format +msgid "SELECT postgis_install_history();" +msgstr "" + +#. Tag: title +#: extras_historytable.xml:71 extras_historytable.xml:113 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: extras_historytable.xml:77 +#, no-c-format +msgid "Postgis_Enable_History" +msgstr "" + +#. Tag: refpurpose +#: extras_historytable.xml:78 +#, no-c-format +msgid "" +"Registers a tablein the history_information table for tracking and also adds " +"in side line history table and insert, update, delete rules on the table." +msgstr "" + +#. Tag: funcprototype +#: extras_historytable.xml:83 +#, no-c-format +msgid "" +"boolean Postgis_Enable_History " +"text p_schema " +"text p_table" +msgstr "" + +#. Tag: para +#: extras_historytable.xml:94 +#, no-c-format +msgid "" +"Registers a table in the history_information table for tracking and also " +"adds in side line history table with same name as table but prefixed with " +"history in the same schema as the original table. Puts in " +"insert, update, delete rules on the table. Any inserts,updates,deletes of " +"the geometry are recorded in the history table." +msgstr "" + +#. Tag: para +#: extras_historytable.xml:97 +#, no-c-format +msgid "" +"This function currently relies on a geometry column being registered in " +"geometry_columns and fails if the geometry column is not " +"present in geometry_columns table." +msgstr "" + +#. Tag: programlisting +#: extras_historytable.xml:107 +#, no-c-format +msgid "" +"CREATE TABLE roads(gid SERIAL PRIMARY KEY, road_name varchar(150));\n" +"SELECT AddGeometryColumn('roads', 'geom', 26986, 'LINESTRING', 2);\n" +" \n" +"SELECT postgis_enable_history('public', 'roads', 'geom') As register_table;\n" +"register_table\n" +"--------------\n" +"t\n" +"\n" +"INSERT INTO roads(road_name, geom) \n" +" VALUES('Test Street', ST_GeomFromText('LINESTRING(231660.5 832170,231647 " +"832202,231627.5 832250.5)',26986));\n" +"\n" +"-- check transaction detail --\n" +"SELECT date_added, last_operation, current_version \n" +"FROM roads_history \n" +"WHERE road_name = 'Test Street' ORDER BY date_added DESC;\n" +"\n" +" date_added | last_operation | current_version\n" +"------------------------+----------------+-----------------\n" +" 2011-02-07 12:44:36.92 | INSERT | 2" +msgstr "" diff --git a/doc/po/pl/extras_tigergeocoder.xml.po b/doc/po/pl/extras_tigergeocoder.xml.po new file mode 100644 index 000000000..46f5af16a --- /dev/null +++ b/doc/po/pl/extras_tigergeocoder.xml.po @@ -0,0 +1,2163 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-10-11 21:39+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: para +#: extras_tigergeocoder.xml:6 +#, no-c-format +msgid "" +"A plpgsql based geocoder written to work with the TIGER (Topologically Integrated Geographic " +"Encoding and Referencing system ) / Line and Master Address database export released by the US Census Bureau. In versions prior to 2008 the TIGER " +"files were released in ASCII format. The older geocoder used to work with " +"that format and is available in PostGIS source 1.5 and below in " +"extras/tiger_geocoder/tiger_2006andbefore." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:8 +#, no-c-format +msgid "" +"There are four components to the geocoder: the data loader functions, the " +"address normalizer, the address geocoder, and the reverse geocoder. The " +"latest version updated to use the TIGER 2011 census data is located in the " +"extras/tiger_geocoder/tiger_2011 folder." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:9 +#, no-c-format +msgid "" +"Although it is designed specifically for the US, a lot of the concepts and " +"functions are applicable and can be adapted to work with other country " +"address and road networks." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:10 +#, no-c-format +msgid "" +"The script builds a schema called tiger to house all the " +"tiger related functions, reusable lookup data such as road type prefixes, " +"suffixes, states, various control tables for managing data load, and " +"skeleton base tables from which all the tiger loaded tables inherit from." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:11 +#, no-c-format +msgid "" +"Another schema called tiger_data is also created which " +"houses all the census data for each state that the loader downloads from " +"Census site and loads into the database. In the current model, each set of " +"state tables is prefixed with the state code e.g ma_addr, " +"ma_edges etc with constraints to enforce only that state " +"data. Each of these tables inherits from the tables addr, " +"faces, edges, etc located in the " +"tiger schema." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:13 +#, no-c-format +msgid "" +"All the geocode functions only reference the base tables, so there is no " +"requirement that the data schema be called tiger_data or " +"that data can't be further partitioned into other schemas -- e.g a different " +"schema for each state, as long as all the tables inherit from the tables in " +"the tiger schema." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:17 +#, no-c-format +msgid "" +"If you are using tiger geocoder (tiger_2010), you can upgrade the scripts " +"using the accompanying upgrade_geocoder.bat / .sh scripts in tiger_2011. One " +"major change between tiger_2010 and tiger_2011 is that the county and county and " +"state tables are no longer broken out by state. We'll be " +"refining the upgrade scripts until release. If you have data from tiger_2010 " +"and want replace with tiger_2011 refer to " +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:24 +#, no-c-format +msgid "Design:" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:25 +#, no-c-format +msgid "" +"The goal of this project is to build a fully functional geocoder that can " +"process an arbitrary United States address string and using normalized TIGER " +"census data, produce a point geometry and rating reflecting the location of " +"the given address and likeliness of the location. The higher the rating " +"number the worse the result." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:27 +#, no-c-format +msgid "" +"The reverse_geocode function, introduced in PostGIS 2.0.0 " +"is useful for deriving the street address and cross streets of a GPS " +"location." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:28 +#, no-c-format +msgid "" +"The geocoder should be simple for anyone familiar with PostGIS to install " +"and use, and should be easily installable and usable on all platforms " +"supported by PostGIS." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:29 +#, no-c-format +msgid "" +"It should be robust enough to function properly despite formatting and " +"spelling errors." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:30 +#, no-c-format +msgid "" +"It should be extensible enough to be used with future data updates, or " +"alternate data sources with a minimum of coding changes." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:32 +#, no-c-format +msgid "" +"The tiger schema must be added to the database search " +"path for the functions to work properly." +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:36 +#, no-c-format +msgid "Tiger Geocoder" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:38 +#, no-c-format +msgid "" +"There are a couple other open source geocoders for PostGIS, that unlike " +"tiger geocoder have the advantage of multi-country geocoding support" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:40 +#, no-c-format +msgid "" +"Nominatim and uses OpenStreetMap gazeteer formatted data. It requires osm2pgsql " +"for loading the data, PostgreSQL 8.4+ and PostGIS 1.5+ to function. It is " +"packaged as a webservice interface and seems designed to be called as a " +"webservice. Just like the tiger geocoder, it has both a geocoder and a " +"reverse geocoder component. From the documentation, it is unclear if it has " +"a pure SQL interface like the tiger geocoder, or if a good deal of the logic " +"is implemented in the web interface." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:43 +#, no-c-format +msgid "" +"GIS Graphy also utilizes " +"PostGIS and like Nominatim works with OpenStreetMap (OSM) data. It comes " +"with a loader to load OSM data and similar to Nominatim is capable of " +"geocoding not just US. Much like Nominatim, it runs as a webservice and " +"relies on Java 1.5, Servlet apps, Solr. GisGraphy is cross-platform and also " +"has a reverse geocoder among some other neat features." +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:48 +#, no-c-format +msgid "Drop_Indexes_Generate_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:50 +#, no-c-format +msgid "" +"Generates a script that drops all non-primary key and non-unique " +"indexes on tiger schema and user specified schema. Defaults schema to " +"tiger_data if no schema is specified." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:55 +#, no-c-format +msgid "" +"text Drop_Indexes_Generate_Script " +"text " +"param_schema=tiger_data" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:63 extras_tigergeocoder.xml:106 +#: extras_tigergeocoder.xml:148 extras_tigergeocoder.xml:204 +#: extras_tigergeocoder.xml:266 extras_tigergeocoder.xml:311 +#: extras_tigergeocoder.xml:351 extras_tigergeocoder.xml:390 +#: extras_tigergeocoder.xml:435 extras_tigergeocoder.xml:493 +#: extras_tigergeocoder.xml:550 extras_tigergeocoder.xml:605 +#: extras_tigergeocoder.xml:650 extras_tigergeocoder.xml:728 +#: extras_tigergeocoder.xml:775 extras_tigergeocoder.xml:847 +#: extras_tigergeocoder.xml:912 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:65 +#, no-c-format +msgid "" +"Generates a script that drops all non-primary key and non-unique " +"indexes on tiger schema and user specified schema. Defaults schema to " +"tiger_data if no schema is specified." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:66 +#, no-c-format +msgid "" +"This is useful for minimizing index bloat that may confuse the query planner " +"or take up unnecessary space. Use in combination with to add just the indexes used by the geocoder." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:69 extras_tigergeocoder.xml:154 +#: extras_tigergeocoder.xml:273 extras_tigergeocoder.xml:355 +#: extras_tigergeocoder.xml:398 extras_tigergeocoder.xml:453 +#: extras_tigergeocoder.xml:613 extras_tigergeocoder.xml:801 +#: extras_tigergeocoder.xml:873 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:76 extras_tigergeocoder.xml:118 +#: extras_tigergeocoder.xml:161 extras_tigergeocoder.xml:405 +#: extras_tigergeocoder.xml:460 extras_tigergeocoder.xml:518 +#: extras_tigergeocoder.xml:573 extras_tigergeocoder.xml:620 +#: extras_tigergeocoder.xml:696 extras_tigergeocoder.xml:738 +#: extras_tigergeocoder.xml:806 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:77 +#, no-c-format +msgid "" +"SELECT drop_indexes_generate_script() As actionsql;\n" +"actionsql\n" +"---------------------------------------------------------\n" +"DROP INDEX tiger.idx_tiger_countysub_lookup_lower_name;\n" +"DROP INDEX tiger.idx_tiger_edges_countyfp;\n" +"DROP INDEX tiger.idx_tiger_faces_countyfp;\n" +"DROP INDEX tiger.tiger_place_the_geom_gist;\n" +"DROP INDEX tiger.tiger_edges_the_geom_gist;\n" +"DROP INDEX tiger.tiger_state_the_geom_gist;\n" +"DROP INDEX tiger.idx_tiger_addr_least_address;\n" +"DROP INDEX tiger.idx_tiger_addr_tlid;\n" +"DROP INDEX tiger.idx_tiger_addr_zip;\n" +"DROP INDEX tiger.idx_tiger_county_countyfp;\n" +"DROP INDEX tiger.idx_tiger_county_lookup_lower_name;\n" +"DROP INDEX tiger.idx_tiger_county_lookup_snd_name;\n" +"DROP INDEX tiger.idx_tiger_county_lower_name;\n" +"DROP INDEX tiger.idx_tiger_county_snd_name;\n" +"DROP INDEX tiger.idx_tiger_county_the_geom_gist;\n" +"DROP INDEX tiger.idx_tiger_countysub_lookup_snd_name;\n" +"DROP INDEX tiger.idx_tiger_cousub_countyfp;\n" +"DROP INDEX tiger.idx_tiger_cousub_cousubfp;\n" +"DROP INDEX tiger.idx_tiger_cousub_lower_name;\n" +"DROP INDEX tiger.idx_tiger_cousub_snd_name;\n" +"DROP INDEX tiger.idx_tiger_cousub_the_geom_gist;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_addr_least_address;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_addr_tlid;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_addr_zip;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_county_countyfp;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_county_lookup_lower_name;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_county_lookup_snd_name;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_county_lower_name;\n" +"DROP INDEX tiger_data.idx_tiger_data_ma_county_snd_name;\n" +":\n" +":" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:83 extras_tigergeocoder.xml:125 +#: extras_tigergeocoder.xml:168 extras_tigergeocoder.xml:235 +#: extras_tigergeocoder.xml:289 extras_tigergeocoder.xml:328 +#: extras_tigergeocoder.xml:368 extras_tigergeocoder.xml:412 +#: extras_tigergeocoder.xml:470 extras_tigergeocoder.xml:528 +#: extras_tigergeocoder.xml:582 extras_tigergeocoder.xml:627 +#: extras_tigergeocoder.xml:706 extras_tigergeocoder.xml:749 +#: extras_tigergeocoder.xml:821 extras_tigergeocoder.xml:889 +#: extras_tigergeocoder.xml:929 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:84 extras_tigergeocoder.xml:413 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:90 +#, no-c-format +msgid "Drop_Nation_Tables_Generate_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:92 +#, no-c-format +msgid "" +"Generates a script that drops all tables in the specified schema that start " +"with county_all, state_all or stae " +"code followed by county or state." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:97 extras_tigergeocoder.xml:139 +#, no-c-format +msgid "" +"text Drop_State_Tables_Generate_Script text param_state text " +"param_schema=tiger_data" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:108 +#, no-c-format +msgid "" +"Generates a script that drops all tables in the specified schema that start " +"with county_all, state_all or stae " +"code followed by county or state. This " +"is needed if you are upgrading from tiger_2010 to " +"tiger_2011 data." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:111 extras_tigergeocoder.xml:316 +#: extras_tigergeocoder.xml:567 extras_tigergeocoder.xml:916 +#, no-c-format +msgid "Availability: 2.1.0" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:119 +#, no-c-format +msgid "" +"SELECT drop_nation_tables_generate_script();\n" +"DROP TABLE tiger_data.county_all;\n" +"DROP TABLE tiger_data.county_all_lookup;\n" +"DROP TABLE tiger_data.state_all;\n" +"DROP TABLE tiger_data.ma_county;\n" +"DROP TABLE tiger_data.ma_state;" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:132 +#, no-c-format +msgid "Drop_State_Tables_Generate_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:134 +#, no-c-format +msgid "" +"Generates a script that drops all tables in the specified schema that are " +"prefixed with the state abbreviation. Defaults schema to " +"tiger_data if no schema is specified." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:150 +#, no-c-format +msgid "" +"Generates a script that drops all tables in the specified schema that are " +"prefixed with the state abbreviation. Defaults schema to " +"tiger_data if no schema is specified. This function is " +"useful for dropping tables of a state just before you reload a state in case " +"something went wrong during your previous load." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:162 +#, no-c-format +msgid "" +"SELECT drop_state_tables_generate_script('PA');\n" +"DROP TABLE tiger_data.pa_addr;\n" +"DROP TABLE tiger_data.pa_county;\n" +"DROP TABLE tiger_data.pa_county_lookup;\n" +"DROP TABLE tiger_data.pa_cousub;\n" +"DROP TABLE tiger_data.pa_edges;\n" +"DROP TABLE tiger_data.pa_faces;\n" +"DROP TABLE tiger_data.pa_featnames;\n" +"DROP TABLE tiger_data.pa_place;\n" +"DROP TABLE tiger_data.pa_state;\n" +"DROP TABLE tiger_data.pa_zip_lookup_base;\n" +"DROP TABLE tiger_data.pa_zip_state;\n" +"DROP TABLE tiger_data.pa_zip_state_loc;" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:174 +#, no-c-format +msgid "Geocode" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:176 +#, no-c-format +msgid "" +"Takes in an address as a string (or other normalized address) and outputs a " +"set of possible locations which include a point geometry in NAD 83 long lat, " +"a normalized address for each, and the rating. The lower the rating the more " +"likely the match. Results are sorted by lowest rating first. Can optionally " +"pass in maximum results, defaults to 10, and restrict_region (defaults to " +"NULL)" +msgstr "" + +#. Tag: funcsynopsis +#: extras_tigergeocoder.xml:181 +#, no-c-format +msgid "" +" setof record geocode " +"varchar address " +"integer max_results=10 geometry " +"restrict_region=NULL " +"norm_addy OUT addy " +"geometry OUT geomout integer OUT rating setof record " +"geocode norm_addy " +"in_addy integer max_results=10 " +"geometry " +"restrict_region=NULL " +"norm_addy OUT addy " +"geometry OUT geomout integer OUT rating " +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:206 +#, no-c-format +msgid "" +"Takes in an address as a string (or already normalized address) and outputs " +"a set of possible locations which include a point geometry in NAD 83 long " +"lat, a normalized_address (addy) for each, and the " +"rating. The lower the rating the more likely the match. Results are sorted " +"by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy " +"string matching (soundex,levenshtein) and PostGIS line interpolation " +"functions to interpolate address along the Tiger edges. The higher the " +"rating the less likely the geocode is right. The geocoded point is defaulted " +"to offset 10 meters from center-line off to side (L/R) of street address is " +"located on." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:210 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic " +"to improve speed, accuracy of geocoding, and to offset point from centerline " +"to side of street address is located on. New parameter max_results useful " +"for specifying ot just return the best result." +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:216 extras_tigergeocoder.xml:279 +#: extras_tigergeocoder.xml:361 +#, no-c-format +msgid "Examples: Basic" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:217 +#, no-c-format +msgid "" +"The below examples timings are on a 3.0 GHZ single processor Windows 7 " +"machine with 2GB ram running PostgreSQL 9.1rc1/PostGIS 2.0 loaded with all " +"of MA,MN,CA, RI state Tiger data loaded." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:218 +#, no-c-format +msgid "Exact matches are faster to compute (61ms)" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:219 +#, no-c-format +msgid "" +"SELECT g.rating, ST_X(g.geomout) As lon, ST_Y(g.geomout) As lat, \n" +" (addy).address As stno, (addy).streetname As street, \n" +" (addy).streettypeabbrev As styp, (addy).location As city, (addy)." +"stateabbrev As st,(addy).zip \n" +" FROM geocode('75 State Street, Boston MA 02109') As g; \n" +" rating | lon | lat | stno | street | styp | " +"city | st | zip \n" +"--------+-------------------+------------------+------+--------+------" +"+--------+----+-------\n" +" 0 | -71.0556722990239 | 42.3589914927049 | 75 | State | St | " +"Boston | MA | 02109" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:220 +#, no-c-format +msgid "" +"Even if zip is not passed in the geocoder can guess (took about 122-150 ms)" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:221 +#, no-c-format +msgid "" +"SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n" +" (addy).address As stno, (addy).streetname As street, \n" +" (addy).streettypeabbrev As styp, (addy).location As city, (addy)." +"stateabbrev As st,(addy).zip \n" +" FROM geocode('226 Hanover Street, Boston, MA',1) As g; \n" +" rating | wktlonlat | stno | street | styp | city | st | " +"zip \n" +"--------+---------------------------+------+---------+------+--------+----" +"+-------\n" +" 1 | POINT(-71.05528 42.36316) | 226 | Hanover | St | Boston | MA | " +"02113" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:222 +#, no-c-format +msgid "" +"Can handle misspellings and provides more than one possible solution with " +"ratings and takes longer (500ms)." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:223 +#, no-c-format +msgid "" +"SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n" +" (addy).address As stno, (addy).streetname As street, \n" +" (addy).streettypeabbrev As styp, (addy).location As city, (addy)." +"stateabbrev As st,(addy).zip \n" +" FROM geocode('31 - 37 Stewart Street, Boston, MA 02116') As g; \n" +" rating | wktlonlat | stno | street | styp | city | st | " +"zip \n" +"--------+---------------------------+------+--------+------+--------+----" +"+-------\n" +" 70 | POINT(-71.06459 42.35113) | 31 | Stuart | St | Boston | MA | " +"02116" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:225 +#, no-c-format +msgid "" +"Using to do a batch geocode of addresses. Easiest is to set " +"max_results=1. Only process those not yet geocoded (have " +"no rating)." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:226 +#, no-c-format +msgid "" +"CREATE TABLE addresses_to_geocode(addid serial PRIMARY KEY, address text,\n" +" lon numeric, lat numeric, new_address text, rating " +"integer);\n" +"\n" +"INSERT INTO addresses_to_geocode(address)\n" +"VALUES ('529 Main Street, Boston MA, 02129'),\n" +" ('77 Massachusetts Avenue, Cambridge, MA 02139'),\n" +" ('25 Wizard of Oz, Walaford, KS 99912323'),\n" +" ('26 Capen Street, Medford, MA'),\n" +" ('124 Mount Auburn St, Cambridge, Massachusetts 02138'),\n" +" ('950 Main Street, Worcester, MA 01610');\n" +" \n" +"-- only update the first 3 addresses (323-704 ms - there are caching and " +"shared memory effects so first geocode you do is always slower) --\n" +"-- for large numbers of addresses you don't want to update all at once\n" +"-- since the whole geocode must commit at once \n" +"-- For this example we rejoin with LEFT JOIN \n" +"-- and set to rating to -1 rating if no match \n" +"-- to ensure we don't regeocode a bad address \n" +"UPDATE addresses_to_geocode\n" +" SET (rating, new_address, lon, lat) \n" +" = ( COALESCE((g.geo).rating,-1), pprint_addy((g.geo).addy),\n" +" ST_X((g.geo).geomout)::numeric(8,5), ST_Y((g.geo).geomout)::" +"numeric(8,5) )\n" +"FROM (SELECT addid \n" +" FROM addresses_to_geocode \n" +" WHERE rating IS NULL ORDER BY addid LIMIT 3) As a\n" +" LEFT JOIN (SELECT addid, (geocode(address,1)) As geo\n" +" FROM addresses_to_geocode As ag\n" +" WHERE ag.rating IS NULL ORDER BY addid LIMIT 3) As g ON a.addid = g." +"addid\n" +"WHERE a.addid = addresses_to_geocode.addid;\n" +"\n" +"result\n" +"-----\n" +"Query returned successfully: 3 rows affected, 480 ms execution time.\n" +"\n" +"SELECT * FROM addresses_to_geocode WHERE rating is not null;\n" +"\n" +" addid | address | lon | lat " +"| new_address | rating \n" +"-------+----------------------------------------------+-----------+----------" +"+-------------------------------------------+--------\n" +" 1 | 529 Main Street, Boston MA, 02129 | -71.07181 | 42.38359 " +"| 529 Main St, Boston, MA 02129 | 0\n" +" 2 | 77 Massachusetts Avenue, Cambridge, MA 02139 | -71.09428 | 42.35988 " +"| 77 Massachusetts Ave, Cambridge, MA 02139 | 0\n" +" 3 | 25 Wizard of Oz, Walaford, KS 99912323 | | " +"| | -1" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:229 +#, no-c-format +msgid "Examples: Using Geometry filter" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:230 +#, no-c-format +msgid "" +"SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat, \n" +" (addy).address As stno, (addy).streetname As street, \n" +" (addy).streettypeabbrev As styp, \n" +" (addy).location As city, (addy).stateabbrev As st,(addy).zip \n" +" FROM geocode('100 Federal Street, MA',\n" +" 3, \n" +" (SELECT ST_Union(the_geom) \n" +" FROM place WHERE statefp = '25' AND name = 'Lynn')::" +"geometry\n" +" ) As g;\n" +"\n" +" rating | wktlonlat | stno | street | styp | city | st | " +"zip\n" +"--------+--------------------------+------+---------+------+------+----" +"+-------\n" +" 8 | POINT(-70.96796 42.4659) | 100 | Federal | St | Lynn | MA | " +"01905\n" +"Total query runtime: 245 ms." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:236 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:242 +#, no-c-format +msgid "Geocode_Intersection" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:244 +#, no-c-format +msgid "" +"Takes in 2 streets that intersect and a state, city, zip, and outputs a set " +"of possible locations on the first cross street that is at the intersection, " +"also includes a point geometry in NAD 83 long lat, a normalized address for " +"each location, and the rating. The lower the rating the more likely the " +"match. Results are sorted by lowest rating first. Can optionally pass in " +"maximum results, defaults to 10" +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:250 +#, no-c-format +msgid "" +"setof record geocode_intersection " +"text roadway1 " +"text roadway2 " +"text in_state " +"text in_city text in_zip integer " +"max_results=10 norm_addy OUT addy geometry OUT geomout integer " +" OUT rating" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:268 +#, no-c-format +msgid "" +"Takes in 2 streets that intersect and a state, city, zip, and outputs a set " +"of possible locations on the first cross street that is at the intersection, " +"also includes a point geometry in NAD 83 long lat, a normalized address for " +"each location, and the rating. The lower the rating the more likely the " +"match. Results are sorted by lowest rating first. Can optionally pass in " +"maximum results, defaults to 10. Returns normalized_address (addy) for each, geomout as the point location in nad 83 long lat, " +"and the rating. The lower the rating the more likely the match. Results are " +"sorted by lowest rating first. Uses Tiger data (edges,faces,addr), " +"PostgreSQL fuzzy string matching (soundex,levenshtein)" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:280 +#, no-c-format +msgid "" +"The below examples timings are on a 3.0 GHZ single processor Windows 7 " +"machine with 2GB ram running PostgreSQL 9.0/PostGIS 1.5 loaded with all of " +"MA state Tiger data loaded. Currently a bit slow (3000 ms)" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:281 +#, no-c-format +msgid "" +"Testing on Windows 2003 64-bit 8GB on PostGIS 2.0 PostgreSQL 64-bit Tiger " +"2011 data loaded -- (41ms)" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:282 +#, no-c-format +msgid "" +"SELECT pprint_addy(addy), st_astext(geomout),rating \n" +" FROM geocode_intersection( 'Haverford St','Germania " +"St', 'MA', 'Boston', '02130',1); \n" +" pprint_addy | st_astext | rating\n" +"----------------------------------+----------------------------+--------\n" +"98 Haverford St, Boston, MA 02130 | POINT(-71.101375 42.31376) | 0" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:283 +#, no-c-format +msgid "" +"Even if zip is not passed in the geocoder can guess (took about 3500 ms on " +"the windows 7 box), on the windows 2003 64-bit 741 ms" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:284 +#, no-c-format +msgid "" +"SELECT pprint_addy(addy), st_astext(geomout),rating \n" +" FROM geocode_intersection('Weld', 'School', " +"'MA', 'Boston');\n" +" pprint_addy | st_astext | rating\n" +"-------------------------------+--------------------------+--------\n" +" 98 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) | 3\n" +" 99 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) | 3" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:290 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:296 +#, no-c-format +msgid "Get_Geocode_Setting" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:298 +#, no-c-format +msgid "" +"Returns value of specific setting stored in tiger.geocode_settings table." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:303 +#, no-c-format +msgid "" +"text Get_Geocode_Setting " +"text setting_name" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:313 +#, no-c-format +msgid "" +"Returns value of specific setting stored in tiger.geocode_settings table. " +"Settings allow you to toggle debugging of functions. Later plans will be to " +"control rating with settings. Current list of settings are as follows:" +msgstr "" + +#. Tag: screen +#: extras_tigergeocoder.xml:314 +#, no-c-format +msgid "" +"name | category | " +"short_desc \n" +"----------------------------+----------" +"+----------------------------------------------------------------------------------\n" +" debug_geocode_address | debug | outputs debug information in notice " +"log such as queries \n" +" | when geocode_addresss is called if " +"true\n" +" debug_geocode_intersection | debug | outputs debug information in notice " +"log such as queries \n" +" | when geocode_intersection is " +"called if true\n" +" debug_normalize_address | debug | outputs debug information in notice " +"log such as queries \n" +" | and intermediate expressions when " +"normalize_address is called if true\n" +" debug_reverse_geocode | debug | if true, outputs debug information " +"in notice log \n" +" such as queries and intermediate " +"expressions when reverse_geocode" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:322 extras_tigergeocoder.xml:922 +#, no-c-format +msgid "Example return debugging setting" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:323 +#, no-c-format +msgid "" +"SELECT get_geocode_setting('debug_geocode_address) As result;\n" +"result\n" +"---------\n" +"false" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:335 +#, no-c-format +msgid "Get_Tract" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:337 +#, no-c-format +msgid "" +"Returns census tract or field from tract table of where the geometry is " +"located. Default to returning short name of tract." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:342 +#, no-c-format +msgid "" +"text get_tract " +"geometry loc_geom " +"text output_field=name" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:353 +#, no-c-format +msgid "" +"Given a geometry will return the census tract location of that geometry. NAD " +"83 long lat is assumed if no spatial ref sys is specified." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:362 +#, no-c-format +msgid "" +"SELECT get_tract(ST_Point(-71.101375, 42.31376) ) As tract_name;\n" +"tract_name\n" +"---------\n" +"1203.01" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:363 +#, no-c-format +msgid "" +"--this one returns the tiger geoid\n" +"SELECT get_tract(ST_Point(-71.101375, 42.31376), 'tract_id' ) As tract_id;\n" +"tract_id\n" +"---------\n" +"25025120301" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:369 +#, no-c-format +msgid ">" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:375 +#, no-c-format +msgid "Install_Missing_Indexes" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:377 +#, no-c-format +msgid "" +"Finds all tables with key columns used in geocoder joins and filter " +"conditions that are missing used indexes on those columns and will add them." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:382 +#, no-c-format +msgid "" +"boolean Install_Missing_Indexes " +"" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:392 +#, no-c-format +msgid "" +"Finds all tables in tiger and tiger_data schemas with key columns used in geocoder joins and filters that " +"are missing indexes on those columns and will output the SQL DDL to define " +"the index for those tables and then execute the generated script. This is a " +"helper function that adds new indexes needed to make queries faster that may " +"have been missing during the load process. This function is a companion to " +" that in addition to " +"generating the create index script, also executes it. It is called as part " +"of the update_geocode.sql upgrade script." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:406 +#, no-c-format +msgid "" +"SELECT install_missing_indexes();\n" +" install_missing_indexes\n" +"-------------------------\n" +" t" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:419 +#, no-c-format +msgid "Loader_Generate_Census_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:421 +#, no-c-format +msgid "" +"Generates a shell script for the specified platform for the specified states " +"that will download Tiger census state tract, bg, and tabblocks data tables, " +"stage and load into tiger_data schema. Each state script " +"is returned as a separate record." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:426 +#, no-c-format +msgid "" +"setof text loader_generate_census_script text[] param_states text os" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:437 +#, no-c-format +msgid "" +"Generates a shell script for the specified platform for the specified states " +"that will download Tiger data census state tract, block " +"groups bg, and tabblocks data tables, " +"stage and load into tiger_data schema. Each state script " +"is returned as a separate record." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:438 +#, no-c-format +msgid "" +"It uses unzip on Linux (7-zip on Windows by default) and wget to do the " +"downloading. It uses to load in the " +"data. Note the smallest unit it does is a whole state. It will only process " +"the files in the staging and temp folders." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:440 extras_tigergeocoder.xml:498 +#, no-c-format +msgid "" +"It uses the following control tables to control the process and different OS " +"shell syntax variations." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:444 extras_tigergeocoder.xml:502 +#: extras_tigergeocoder.xml:558 +#, no-c-format +msgid "" +"loader_variables keeps track of various variables such as " +"census site, year, data and staging schemas" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:447 extras_tigergeocoder.xml:505 +#, no-c-format +msgid "" +"loader_platform profiles of various platforms and where " +"the various executables are located. Comes with windows and linux. More can " +"be added." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:450 extras_tigergeocoder.xml:508 +#: extras_tigergeocoder.xml:564 +#, no-c-format +msgid "" +"loader_lookuptables each record defines a kind of table " +"(state, county), whether to process records in it and how to load them in. " +"Defines the steps to import data, stage data, add, removes columns, indexes, " +"and constraints for each. Each table is prefixed with the state and inherits " +"from a table in the tiger schema. e.g. creates tiger_data.ma_faces which inherits from tiger.faces" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:454 +#, no-c-format +msgid "" +"includes this logic, but if you installed tiger geocoder prior to PostGIS " +"2.0.0 alpha5, you'll need to run this on the states you have already done to " +"get these additional tables." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:461 +#, no-c-format +msgid "" +"Generate script to load up data for select states in Windows shell script " +"format." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:462 +#, no-c-format +msgid "" +"SELECT loader_generate_census_script(ARRAY['MA'], 'windows');\n" +"-- result --\n" +"set STATEDIR=\"\\gisdata\\www2.census.gov\\geo\\pvs\\tiger2010st" +"\\25_Massachusetts\"\n" +"set TMPDIR=\\gisdata\\temp\\\n" +"set UNZIPTOOL=\"C:\\Program Files\\7-Zip\\7z.exe\"\n" +"set WGETTOOL=\"C:\\wget\\wget.exe\"\n" +"set PGBIN=C:\\projects\\pg\\pg91win\\bin\\\n" +"set PGPORT=5432\n" +"set PGHOST=localhost\n" +"set PGUSER=postgres\n" +"set PGPASSWORD=yourpasswordhere\n" +"set PGDATABASE=tiger_postgis20\n" +"set PSQL=\"%PGBIN%psql\"\n" +"set SHP2PGSQL=\"%PGBIN%shp2pgsql\"\n" +"cd \\gisdata\n" +"\n" +"%WGETTOOL% http://www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts/25/ --" +"no-parent --relative --accept=*bg10.zip,*tract10.zip,*tabblock10.zip --" +"mirror --reject=html\n" +"del %TMPDIR%\\*.* /Q\n" +"%PSQL% -c \"DROP SCHEMA tiger_staging CASCADE;\"\n" +"%PSQL% -c \"CREATE SCHEMA tiger_staging;\"\n" +"cd %STATEDIR%\n" +"for /r %%z in (*.zip) do %UNZIPTOOL% e %%z -o%TMPDIR% \n" +"cd %TMPDIR% \n" +"%PSQL% -c \"CREATE TABLE tiger_data.MA_tract(CONSTRAINT pk_MA_tract PRIMARY " +"KEY (tract_id) ) INHERITS(tiger.tract); \" \n" +"%SHP2PGSQL% -c -s 4269 -g the_geom -W \"latin1\" tl_2010_25_tract10.dbf " +"tiger_staging.ma_tract10 | %PSQL%\n" +"%PSQL% -c \"ALTER TABLE tiger_staging.MA_tract10 RENAME geoid10 TO " +"tract_id; SELECT loader_load_staged_data(lower('MA_tract10'), " +"lower('MA_tract')); \"\n" +"%PSQL% -c \"CREATE INDEX tiger_data_MA_tract_the_geom_gist ON tiger_data." +"MA_tract USING gist(the_geom);\"\n" +"%PSQL% -c \"VACUUM ANALYZE tiger_data.MA_tract;\"\n" +"%PSQL% -c \"ALTER TABLE tiger_data.MA_tract ADD CONSTRAINT chk_statefp CHECK " +"(statefp = '25');\"\n" +":" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:463 extras_tigergeocoder.xml:521 +#, no-c-format +msgid "Generate sh script" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:464 +#, no-c-format +msgid "" +"STATEDIR=\"/gisdata/www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts\" \n" +"TMPDIR=\"/gisdata/temp/\"\n" +"UNZIPTOOL=unzip\n" +"WGETTOOL=\"/usr/bin/wget\"\n" +"export PGBIN=/usr/pgsql-9.0/bin\n" +"export PGPORT=5432\n" +"export PGHOST=localhost\n" +"export PGUSER=postgres\n" +"export PGPASSWORD=yourpasswordhere\n" +"export PGDATABASE=geocoder\n" +"PSQL=${PGBIN}/psql\n" +"SHP2PGSQL=${PGBIN}/shp2pgsql\n" +"cd /gisdata\n" +"\n" +"wget http://www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts/25/ --no-" +"parent --relative --accept=*bg10.zip,*tract10.zip,*tabblock10.zip --mirror --" +"reject=html\n" +"rm -f ${TMPDIR}/*.*\n" +"${PSQL} -c \"DROP SCHEMA tiger_staging CASCADE;\"\n" +"${PSQL} -c \"CREATE SCHEMA tiger_staging;\"\n" +"cd $STATEDIR\n" +"for z in *.zip; do $UNZIPTOOL -o -d $TMPDIR $z; done\n" +":\n" +":" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:477 +#, no-c-format +msgid "Loader_Generate_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:479 +#, no-c-format +msgid "" +"Generates a shell script for the specified platform for the specified states " +"that will download Tiger data, stage and load into tiger_data schema. Each state script is returned as a separate record. Latest " +"version supports Tiger 2010 structural changes and also loads census tract, " +"block groups, and blocks tables." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:484 +#, no-c-format +msgid "" +"setof text loader_generate_script " +"text[] param_states " +"text os" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:495 +#, no-c-format +msgid "" +"Generates a shell script for the specified platform for the specified states " +"that will download Tiger data, stage and load into tiger_data schema. Each state script is returned as a separate record." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:496 +#, no-c-format +msgid "" +"It uses unzip on Linux (7-zip on Windows by default) and wget to do the " +"downloading. It uses to load in the " +"data. Note the smallest unit it does is a whole state, but you can overwrite " +"this by downloading the files yourself. It will only process the files in " +"the staging and temp folders." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:511 +#, no-c-format +msgid "" +"Availability: 2.0.0 to support Tiger 2010 structured data and load census " +"tract (tract), block groups (bg), and blocks (tabblocks) tables ." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:519 +#, no-c-format +msgid "" +"Generate script to load up data for 2 states in Windows shell script format." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:520 +#, no-c-format +msgid "" +"SELECT loader_generate_script(ARRAY['MA','RI'], 'windows') AS result;\n" +"-- result --\n" +"set STATEDIR=\"\\gisdata\\www2.census.gov\\geo\\pvs\\tiger2010st" +"\\44_Rhode_Island\"\n" +"set TMPDIR=\\gisdata\\temp\\\n" +"set UNZIPTOOL=\"C:\\Program Files\\7-Zip\\7z.exe\"\n" +"set WGETTOOL=\"C:\\wget\\wget.exe\"\n" +"set PGBIN=C:\\Program Files\\PostgreSQL\\8.4\\bin\\\n" +"set PGPORT=5432\n" +"set PGHOST=localhost\n" +"set PGUSER=postgres\n" +"set PGPASSWORD=yourpasswordhere\n" +"set PGDATABASE=geocoder\n" +"set PSQL=\"%PGBIN%psql\"\n" +"set SHP2PGSQL=\"%PGBIN%shp2pgsql\"\n" +"\n" +"%WGETTOOL% http://www2.census.gov/geo/pvs/tiger2010st/44_Rhode_Island/ --no-" +"parent --relative --recursive --level=2 --accept=zip,txt --mirror --" +"reject=html\n" +":\n" +":" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:522 +#, no-c-format +msgid "" +"SELECT loader_generate_script(ARRAY['MA','RI'], 'sh') AS result;\n" +"-- result --\n" +"STATEDIR=\"/gisdata/www2.census.gov/geo/pvs/tiger2010st/44_Rhode_Island\" \n" +"TMPDIR=\"/gisdata/temp/\"\n" +"UNZIPTOOL=unzip\n" +"PGPORT=5432\n" +"PGHOST=localhost\n" +"PGUSER=postgres\n" +"PGPASSWORD=yourpasswordhere\n" +"PGDATABASE=geocoder\n" +"PSQL=psql\n" +"SHP2PGSQ=shp2pgsql\n" +"\n" +"wget http://www2.census.gov/geo/pvs/tiger2010st/44_Rhode_Island/ --no-parent " +"--relative --recursive --level=2 --accept=zip,txt --mirror --reject=html\n" +":\n" +":" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:535 +#, no-c-format +msgid "Loader_Generate_Nation_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:537 +#, no-c-format +msgid "" +"Generates a shell script for the specified platform that loads in the county " +"and state lookup tables." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:542 +#, no-c-format +msgid "" +"text loader_generate_nation_script " +"text os" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:552 +#, no-c-format +msgid "" +"Generates a shell script for the specified platform that loads in the " +"county_all, county_all_lookup, " +"state_all tables into tiger_data " +"schema. These inherit respectively from the county, " +"county_lookup, state tables in " +"tiger schema." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:553 +#, no-c-format +msgid "" +"It uses unzip on Linux (7-zip on Windows by default) and wget to do the " +"downloading. It uses to load in the data." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:554 +#, no-c-format +msgid "" +"It uses the following control tables tiger.loader_platform, tiger.loader_variables, and tiger." +"loader_lookuptables to control the process and different OS shell " +"syntax variations." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:561 +#, no-c-format +msgid "" +"loader_platform profiles of various platforms and where " +"the various executables are located. Comes with windows and linux/unix. More " +"can be added." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:568 +#, no-c-format +msgid "" +"If you were running tiger_2010 version and you want to " +"reload as state with tiger_2011, you'll need to for the " +"very first load generate and run drop statements before you run this script." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:574 +#, no-c-format +msgid "Generate script script to load nation data Windows." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:575 +#, no-c-format +msgid "SELECT loader_generate_nation_script('windows');" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:576 +#, no-c-format +msgid "Generate script to load up data for Linux/Unix systems." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:577 +#, no-c-format +msgid "SELECT loader_generate_nation_script('sh');" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:589 +#, no-c-format +msgid "Missing_Indexes_Generate_Script" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:591 +#, no-c-format +msgid "" +"Finds all tables with key columns used in geocoder joins that are missing " +"indexes on those columns and will output the SQL DDL to define the index for " +"those tables." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:597 +#, no-c-format +msgid "" +"text Missing_Indexes_Generate_Script " +"" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:607 +#, no-c-format +msgid "" +"Finds all tables in tiger and tiger_data schemas with key columns used in geocoder joins that are missing " +"indexes on those columns and will output the SQL DDL to define the index for " +"those tables. This is a helper function that adds new indexes needed to make " +"queries faster that may have been missing during the load process. As the " +"geocoder is improved, this function will be updated to accommodate new " +"indexes being used. If this function outputs nothing, it means all your " +"tables have what we think are the key indexes already in place." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:621 +#, no-c-format +msgid "" +"SELECT missing_indexes_generate_script();\n" +"-- output: This was run on a database that was created before many " +"corrections were made to the loading script ---\n" +"CREATE INDEX idx_tiger_county_countyfp ON tiger.county USING " +"btree(countyfp);\n" +"CREATE INDEX idx_tiger_cousub_countyfp ON tiger.cousub USING " +"btree(countyfp);\n" +"CREATE INDEX idx_tiger_edges_tfidr ON tiger.edges USING btree(tfidr);\n" +"CREATE INDEX idx_tiger_edges_tfidl ON tiger.edges USING btree(tfidl);\n" +"CREATE INDEX idx_tiger_zip_lookup_all_zip ON tiger.zip_lookup_all USING " +"btree(zip);\n" +"CREATE INDEX idx_tiger_data_ma_county_countyfp ON tiger_data.ma_county USING " +"btree(countyfp);\n" +"CREATE INDEX idx_tiger_data_ma_cousub_countyfp ON tiger_data.ma_cousub USING " +"btree(countyfp);\n" +"CREATE INDEX idx_tiger_data_ma_edges_countyfp ON tiger_data.ma_edges USING " +"btree(countyfp);\n" +"CREATE INDEX idx_tiger_data_ma_faces_countyfp ON tiger_data.ma_faces USING " +"btree(countyfp);" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:628 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:634 +#, no-c-format +msgid "Normalize_Address" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:636 +#, no-c-format +msgid "" +"Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, " +"streetname etc. broken into separate fields. This function will work with " +"just the lookup data packaged with the tiger_geocoder (no need for tiger " +"census data)." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:642 +#, no-c-format +msgid "" +"norm_addy normalize_address " +"varchar in_address" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:652 +#, no-c-format +msgid "" +"Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, " +"streetname etc. broken into separate fields. This is the first step in the " +"geocoding process to get all addresses into normalized postal form. No other " +"data is required aside from what is packaged with the geocoder." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:654 +#, no-c-format +msgid "" +"This function just uses the various direction/state/suffix lookup tables " +"preloaded with the tiger_geocoder and located in the tiger schema, so it doesn't need you to download tiger census data or any " +"other additional data to make use of it. You may find the need to add more " +"abbreviations or alternative namings to the various lookup tables in the " +"tiger schema." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:656 +#, no-c-format +msgid "" +"It uses various control lookup tables located in tiger " +"schema to normalize the input address." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:657 +#, no-c-format +msgid "" +"Fields in the norm_addy type object returned by this " +"function in this order where () indicates a field required by the geocoder, " +"[] indicates an optional field:" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:658 +#, no-c-format +msgid "" +"(address) [predirAbbrev] (streetName) [streetTypeAbbrev] [postdirAbbrev] " +"[internal] [location] [stateAbbrev] [zip]" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:661 +#, no-c-format +msgid "address is an integer: The street number" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:664 +#, no-c-format +msgid "" +"predirAbbrev is varchar: Directional prefix of road such " +"as N, S, E, W etc. These are controlled using the direction_lookup table." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:667 +#, no-c-format +msgid "streetName varchar" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:670 +#, no-c-format +msgid "" +"streetTypeAbbrev varchar abbreviated version of street " +"type: e.g. St, Ave, Cir. These are controlled using the " +"street_type_lookup table." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:673 +#, no-c-format +msgid "" +"postdirAbbrev varchar abbreviated directional suffice of " +"road N, S, E, W etc. These are controlled using the " +"direction_lookup table." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:676 +#, no-c-format +msgid "" +"internal varchar internal address such as an apartment or " +"suite number." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:679 +#, no-c-format +msgid "" +"location varchar usually a city or governing province." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:682 +#, no-c-format +msgid "" +"stateAbbrev varchar two character US State. e.g MA, NY, " +"MI. These are controlled by the state_lookup table." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:685 +#, no-c-format +msgid "zip varchar 5-digit zipcode. e.g. 02109." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:688 +#, no-c-format +msgid "" +"parsed boolean - denotes if addess was formed from " +"normalize process. The normalize_address function sets this to true before " +"returning the address." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:697 +#, no-c-format +msgid "" +"Output select fields. Use if you want a " +"pretty textual output." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:698 +#, no-c-format +msgid "" +"SELECT address As orig, (g.na).streetname, (g.na).streettypeabbrev\n" +" FROM (SELECT address, normalize_address(address) As na\n" +" FROM addresses_to_geocode) As g;\n" +" \n" +" orig | streetname | " +"streettypeabbrev \n" +"-----------------------------------------------------+---------------" +"+------------------\n" +" 28 Capen Street, Medford, MA | Capen | St\n" +" 124 Mount Auburn St, Cambridge, Massachusetts 02138 | Mount Auburn | St\n" +" 950 Main Street, Worcester, MA 01610 | Main | St\n" +" 529 Main Street, Boston MA, 02129 | Main | St\n" +" 77 Massachusetts Avenue, Cambridge, MA 02139 | Massachusetts | Ave\n" +" 25 Wizard of Oz, Walaford, KS 99912323 | Wizard of Oz |" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:707 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:713 +#, no-c-format +msgid "Pprint_Addy" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:715 +#, no-c-format +msgid "" +"Given a norm_addy composite type object, returns a pretty " +"print representation of it. Usually used in conjunction with " +"normalize_address." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:720 +#, no-c-format +msgid "" +"varchar pprint_addy " +"norm_addy in_addy" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:730 +#, no-c-format +msgid "" +"Given a norm_addy composite type object, returns a pretty " +"print representation of it. No other data is required aside from what is " +"packaged with the geocoder." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:731 +#, no-c-format +msgid "Usually used in conjunction with ." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:739 +#, no-c-format +msgid "Pretty print a single address" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:740 +#, no-c-format +msgid "" +"SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, " +"Nevada 89101')) As pretty_address;\n" +" pretty_address\n" +"---------------------------------------\n" +" 202 E Fremont St, Las Vegas, NV 89101" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:742 +#, no-c-format +msgid "Pretty print address a table of addresses" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:743 +#, no-c-format +msgid "" +"SELECT address As orig, pprint_addy(normalize_address(address)) As " +"pretty_address\n" +" FROM addresses_to_geocode;\n" +" \n" +" orig | " +"pretty_address\n" +"-----------------------------------------------------" +"+-------------------------------------------\n" +" 529 Main Street, Boston MA, 02129 | 529 Main St, Boston " +"MA, 02129\n" +" 77 Massachusetts Avenue, Cambridge, MA 02139 | 77 Massachusetts Ave, " +"Cambridge, MA 02139\n" +" 28 Capen Street, Medford, MA | 28 Capen St, Medford, " +"MA\n" +" 124 Mount Auburn St, Cambridge, Massachusetts 02138 | 124 Mount Auburn St, " +"Cambridge, MA 02138\n" +" 950 Main Street, Worcester, MA 01610 | 950 Main St, " +"Worcester, MA 01610" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:756 +#, no-c-format +msgid "Reverse_Geocode" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:758 +#, no-c-format +msgid "" +"Takes a geometry point in a known spatial ref sys and returns a record " +"containing an array of theoretically possible addresses and an array of " +"cross streets. If include_strnum_range = true, includes the street range in " +"the cross streets." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:763 +#, no-c-format +msgid "" +"record Reverse_Geocode " +"geometry pt " +"boolean " +"include_strnum_range=false " +"geometry[] OUT intpt norm_addy[] OUT addy varchar[] OUT " +"street" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:777 +#, no-c-format +msgid "" +"Takes a geometry point in a known spatial ref and returns a record " +"containing an array of theoretically possible addresses and an array of " +"cross streets. If include_strnum_range = true, includes the street range in " +"the cross streets. include_strnum_range defaults to false if not passed in. " +"Addresses are sorted according to which road a point is closest to so first " +"address is most likely the right one." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:780 +#, no-c-format +msgid "" +"Why do we say theoretical instead of actual addresses. The Tiger data " +"doesn't have real addresses, but just street ranges. As such the theoretical " +"address is an interpolated address based on the street ranges. Like for " +"example interpolating one of my addresses returns a 26 Court St. and 26 " +"Court Sq., though there is no such place as 26 Court Sq. This is because a " +"point may be at a corner of 2 streets and thus the logic interpolates along " +"both streets. The logic also assumes addresses are equally spaced along a " +"street, which of course is wrong since you can have a municipal building " +"taking up a good chunk of the street range and the rest of the buildings are " +"clustered at the end." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:785 +#, no-c-format +msgid "" +"Note: Hmm this function relies on Tiger data. If you have not loaded data " +"covering the region of this point, then hmm you will get a record filled " +"with NULLS." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:786 +#, no-c-format +msgid "Returned elements of the record are as follows:" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:789 +#, no-c-format +msgid "" +"intpt is an array of points: These are the center line " +"points on the street closest to the input point. There are as many points as " +"there are addresses." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:792 +#, no-c-format +msgid "" +"addy is an array of norm_addy (normalized addresses): " +"These are an array of possible addresses that fit the input point. The first " +"one in the array is most likely. Generally there should be only one, except " +"in the case when a point is at the corner of 2 or 3 streets, or the point is " +"somewhere on the road and not off to the side." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:796 +#, no-c-format +msgid "" +"street an array of varchar: These are cross streets (or " +"the street) (streets that intersect or are the street the point is projected " +"to be on)." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:807 +#, no-c-format +msgid "" +"Example of a point at the corner of two streets, but closest to one. This is " +"approximate location of MIT: 77 Massachusetts Ave, Cambridge, MA 02139 Note " +"that although we don't have 3 streets, PostgreSQL will just return null for " +"entries above our upper bound so safe to use. This includes street ranges" +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:809 +#, no-c-format +msgid "" +"SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, " +"pprint_addy(r.addy[3]) As st3, \n" +" array_to_string(r.street, ',') As cross_streets \n" +" FROM reverse_geocode(ST_GeomFromText('POINT(-71.093902 " +"42.359446)',4269),true) As r;\n" +" \n" +" result\n" +" ------\n" +" st1 | st2 | st3 | " +"cross_streets\n" +"-------------------------------------------+-----+-----" +"+----------------------------------------------\n" +" 67 Massachusetts Ave, Cambridge, MA 02139 | | | 67 - 127 " +"Massachusetts Ave,32 - 88 Vassar St" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:811 +#, no-c-format +msgid "" +"Here we choose not to include the address ranges for the cross streets and " +"picked a location really really close to a corner of 2 streets thus could be " +"known by two different addresses." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:813 +#, no-c-format +msgid "" +"SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, \n" +"pprint_addy(r.addy[3]) As st3, array_to_string(r.street, ',') As cross_str\n" +"FROM reverse_geocode(ST_GeomFromText('POINT(-71.06941 42.34225)',4269)) As " +"r;\n" +"\n" +"result\n" +"--------\n" +" st1 | st2 | st3 | " +"cross_str\n" +"---------------------------------+---------------------------------+-----" +"+------------------------\n" +" 5 Bradford St, Boston, MA 02118 | 49 Waltham St, Boston, MA 02118 | | " +"Waltham St" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:815 +#, no-c-format +msgid "" +"For this one we reuse our geocoded example from " +"and we only want the primary address and at most 2 cross streets." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:816 +#, no-c-format +msgid "" +"SELECT actual_addr, lon, lat, pprint_addy((rg).addy[1]) As int_addr1, \n" +" (rg).street[1] As cross1, (rg).street[2] As cross2\n" +"FROM (SELECT address As actual_addr, lon, lat,\n" +" reverse_geocode( ST_SetSRID(ST_Point(lon,lat),4326) ) As rg\n" +" FROM addresses_to_geocode WHERE rating > -1) As foo;\n" +"\n" +" actual_addr | lon | lat " +"| int_addr1 | cross1 | cross2 \n" +"-----------------------------------------------------+-----------+----------" +"+-------------------------------------------+-----------------+------------\n" +" 529 Main Street, Boston MA, 02129 | -71.07181 | 42.38359 " +"| 527 Main St, Boston, MA 02129 | Medford St | \n" +" 77 Massachusetts Avenue, Cambridge, MA 02139 | -71.09428 | 42.35988 " +"| 77 Massachusetts Ave, Cambridge, MA 02139 | Vassar St | \n" +" 26 Capen Street, Medford, MA | -71.12377 | 42.41101 " +"| 9 Edison Ave, Medford, MA 02155 | Capen St | Tesla Ave\n" +" 124 Mount Auburn St, Cambridge, Massachusetts 02138 | -71.12304 | 42.37328 " +"| 3 University Rd, Cambridge, MA 02138 | Mount Auburn St | \n" +" 950 Main Street, Worcester, MA 01610 | -71.82368 | 42.24956 " +"| 3 Maywood St, Worcester, MA 01603 | Main St | Maywood Pl" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:823 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:829 +#, no-c-format +msgid "Topology_Load_Tiger" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:831 +#, no-c-format +msgid "" +"Loads a defined region of tiger data into a PostGIS Topology and " +"transforming the tiger data to spatial reference of the topology and " +"snapping to the precision tolerance of the topology." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:837 +#, no-c-format +msgid "" +"text Topology_Load_Tiger " +"varchar topo_name " +"varchar region_type varchar region_id" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:849 +#, no-c-format +msgid "" +"Loads a defined region of tiger data into a PostGIS Topology. The faces, " +"nodes and edges are transformed to the spatial reference system of the " +"target topology and points are snapped to the tolerance of the target " +"topology. The created faces, nodes, edges maintain the same ids as the " +"original Tiger data faces, nodes, edges so that datasets can be in the " +"future be more easily reconciled with tiger data. Returns summary details " +"about the process." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:852 +#, no-c-format +msgid "" +"This would be useful for example for redistricting data where you require " +"the newly formed polygons to follow the center lines of streets and for the " +"resulting polygons not to overlap." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:854 +#, no-c-format +msgid "" +"This function relies on Tiger data as well as the installation of the " +"PostGIS topology module. For more information, refer to and . If you " +"have not loaded data covering the region of interest, then no topology " +"records will be created. This function will also fail if you have not " +"created a topology using the topology functions." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:856 +#, no-c-format +msgid "" +"Most topology validation errors are a result of tolerance issues where after " +"transformation the edges points don't quite line up or overlap. To remedy " +"the situation you may want to increase or lower the precision if you get " +"topology validation failures." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:858 +#, no-c-format +msgid "Required arguments:" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:861 +#, no-c-format +msgid "" +"topo_name The name of an existing PostGIS topology to " +"load data into." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:864 +#, no-c-format +msgid "" +"region_type The type of bounding region. Currently only " +"place and county are supported. Plan " +"is to have several more. This is the table to look into to define the region " +"bounds. e.g tiger.place, tiger.county" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:867 +#, no-c-format +msgid "" +"region_id This is what TIGER calls the geoid. It is the " +"unique identifier of the region in the table. For place it is the " +"plcidfp column in tiger.place. For " +"county it is the cntyidfp column in tiger." +"county" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:876 +#, no-c-format +msgid "Example: Boston, Massachusetts Topology" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:877 +#, no-c-format +msgid "" +"Create a topology for Boston, Massachusetts in Mass State Plane Feet (2249) " +"with tolerance 0.25 feet and then load in Boston city tiger faces, edges, " +"nodes." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:879 +#, no-c-format +msgid "" +"SELECT topology.CreateTopology('topo_boston', 2249, 0.25);\n" +"createtopology\n" +"--------------\n" +" 15\n" +"-- 60,902 ms ~ 1 minute on windows 7 desktop running 9.1 (with 5 states " +"tiger data loaded) \n" +"SELECT tiger.topology_load_tiger('topo_boston', 'place', '2507000'); \n" +"-- topology_loader_tiger --\n" +"29722 edges holding in temporary. 11108 faces added. 1875 edges of faces " +"added. 20576 nodes added. \n" +"19962 nodes contained in a face. 0 edge start end corrected. 31597 edges " +"added. \n" +" \n" +"-- 41 ms --\n" +"SELECT topology.TopologySummary('topo_boston');\n" +" -- topologysummary--\n" +"Topology topo_boston (15), SRID 2249, precision 0.25\n" +"20576 nodes, 31597 edges, 11109 faces, 0 topogeoms in 0 layers\n" +"\n" +"-- 28,797 ms to validate yeh returned no errors --\n" +"SELECT * FROM \n" +" topology.ValidateTopology('topo_boston'); \n" +" \n" +" error | id1 | id2\n" +"-------------------+----------+-----------" +msgstr "" + +#. Tag: title +#: extras_tigergeocoder.xml:883 +#, no-c-format +msgid "Example: Suffolk, Massachusetts Topology" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:884 +#, no-c-format +msgid "" +"Create a topology for Suffolk, Massachusetts in Mass State Plane Meters " +"(26986) with tolerance 0.25 meters and then load in Suffolk county tiger " +"faces, edges, nodes." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:886 +#, no-c-format +msgid "" +"SELECT topology.CreateTopology('topo_suffolk', 26986, 0.25);\n" +"-- this took 56,275 ms ~ 1 minute on Windows 7 32-bit with 5 states of tiger " +"loaded\n" +"-- must have been warmed up after loading boston\n" +"SELECT tiger.topology_load_tiger('topo_suffolk', 'county', '25025'); \n" +"-- topology_loader_tiger --\n" +" 36003 edges holding in temporary. 13518 faces added. 2172 edges of faces " +"added. \n" +" 24761 nodes added. 24075 nodes contained in a face. 0 edge start end " +"corrected. 38175 edges added. \n" +"-- 31 ms --\n" +"SELECT topology.TopologySummary('topo_suffolk');\n" +" -- topologysummary--\n" +" Topology topo_suffolk (14), SRID 26986, precision 0.25\n" +"24761 nodes, 38175 edges, 13519 faces, 0 topogeoms in 0 layers\n" +"\n" +"-- 33,606 ms to validate --\n" +"SELECT * FROM \n" +" topology.ValidateTopology('topo_suffolk'); \n" +" \n" +" error | id1 | id2\n" +"-------------------+----------+-----------\n" +" coincident nodes | 81045651 | 81064553\n" +" edge crosses node | 81045651 | 85737793\n" +" edge crosses node | 81045651 | 85742215\n" +" edge crosses node | 81045651 | 620628939\n" +" edge crosses node | 81064553 | 85697815\n" +" edge crosses node | 81064553 | 85728168\n" +" edge crosses node | 81064553 | 85733413" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:890 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: extras_tigergeocoder.xml:896 +#, no-c-format +msgid "Set_Geocode_Setting" +msgstr "" + +#. Tag: refpurpose +#: extras_tigergeocoder.xml:898 +#, no-c-format +msgid "Sets a setting that affects behavior of geocoder functions." +msgstr "" + +#. Tag: funcprototype +#: extras_tigergeocoder.xml:903 +#, no-c-format +msgid "" +"text Set_Geocode_Setting " +"text setting_name " +"text setting_value" +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:914 +#, no-c-format +msgid "" +"Sets value of specific setting stored in tiger.geocode_settings table. Settings allow you to toggle debugging of functions. Later " +"plans will be to control rating with settings. Current list of settings are " +"listed in ." +msgstr "" + +#. Tag: para +#: extras_tigergeocoder.xml:923 +#, no-c-format +msgid "" +"If you run when this function is true, the " +"NOTICE log will output timing and queries." +msgstr "" + +#. Tag: programlisting +#: extras_tigergeocoder.xml:924 +#, no-c-format +msgid "" +"SELECT set_geocode_setting('debug_geocode_address', 'true') As result;\n" +"result\n" +"---------\n" +"true" +msgstr "" diff --git a/doc/po/pl/extras_topology.xml.po b/doc/po/pl/extras_topology.xml.po new file mode 100644 index 000000000..abc21f07b --- /dev/null +++ b/doc/po/pl/extras_topology.xml.po @@ -0,0 +1,4230 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-10-11 21:39+0000\n" +"PO-Revision-Date: 2014-01-02 21:58+0000\n" +"Last-Translator: Jakub Bobrowski \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: extras_topology.xml:3 +#, no-c-format +msgid "Topology" +msgstr "Topologia" + +#. Tag: para +#: extras_topology.xml:4 +#, no-c-format +msgid "" +"The PostGIS Topology types and functions are used to manage topological " +"objects such as faces, edges and nodes." +msgstr "" + +#. Tag: para +#: extras_topology.xml:5 +#, no-c-format +msgid "" +"Sandro Santilli's presentation at PostGIS Day Paris 2011 conference gives a " +"good synopsis of PostGIS Topology and where it is headed Topology with PostGIS 2.0 slide deck." +msgstr "" + +#. Tag: para +#: extras_topology.xml:6 +#, no-c-format +msgid "" +"Vincent Picavet provides a good synopsis and overview of what is Topology, " +"how is it used, and various FOSS4G tools that support it in State of the art of FOSS4G " +"for topology and network analysis." +msgstr "" + +#. Tag: para +#: extras_topology.xml:7 +#, no-c-format +msgid "" +"An example of a topologically based GIS database is the US Census Topologically " +"Integrated Geographic Encoding and Reference System (TIGER) " +"database. If you want to experiment with PostGIS topology and need some " +"data, check out ." +msgstr "" + +#. Tag: para +#: extras_topology.xml:8 +#, no-c-format +msgid "" +"The PostGIS topology module has existed in prior versions of PostGIS but was " +"never part of the Official PostGIS documentation. In PostGIS 2.0.0 major " +"cleanup is going on to remove use of all deprecated functions in it, fix " +"known usability issues, better document the features and functions, add new " +"functions, and enhance to closer conform to SQL-MM standards." +msgstr "" + +#. Tag: para +#: extras_topology.xml:10 +#, no-c-format +msgid "" +"Details of this project can be found at PostGIS Topology Wiki" +msgstr "" +"Szczegóły tego projektu można znaleźć pod adresem PostGIS Topology Wiki" + +#. Tag: para +#: extras_topology.xml:11 +#, no-c-format +msgid "" +"All functions and tables associated with this module are installed in a " +"schema called topology." +msgstr "" + +#. Tag: para +#: extras_topology.xml:12 +#, no-c-format +msgid "" +"Functions that are defined in SQL/MM standard are prefixed with ST_ and " +"functions specific to PostGIS are not prefixed." +msgstr "" + +#. Tag: para +#: extras_topology.xml:13 +#, no-c-format +msgid "" +"To build PostGIS 2.0 with topology support, compile with the --with-topology " +"option as described in . Some " +"functions depend on GEOS 3.3+ so you should compile with GEOS 3.3+ to fully " +"utilize the topology support." +msgstr "" + +#. Tag: para +#: extras_topology.xml:18 +#, no-c-format +msgid "" +"This section lists the PostgreSQL data types installed by PostGIS Topology. " +"Note we describe the casting behavior of these which is very important " +"especially when designing your own functions." +msgstr "" + +#. Tag: title +#: extras_topology.xml:23 +#, no-c-format +msgid "Topology Types" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:27 +#, no-c-format +msgid "getfaceedges_returntype" +msgstr "getfaceedges_returntype" + +#. Tag: refpurpose +#: extras_topology.xml:28 +#, no-c-format +msgid "" +"A composite type that consists of a sequence number and edge number. This is " +"the return type for ST_GetFaceEdges" +msgstr "" + +#. Tag: title +#: extras_topology.xml:31 extras_topology.xml:50 extras_topology.xml:99 +#: extras_topology.xml:138 extras_topology.xml:159 extras_topology.xml:236 +#: extras_topology.xml:283 extras_topology.xml:324 extras_topology.xml:363 +#: extras_topology.xml:400 extras_topology.xml:470 extras_topology.xml:518 +#: extras_topology.xml:566 extras_topology.xml:610 extras_topology.xml:658 +#: extras_topology.xml:704 extras_topology.xml:750 extras_topology.xml:805 +#: extras_topology.xml:851 extras_topology.xml:898 extras_topology.xml:955 +#: extras_topology.xml:1013 extras_topology.xml:1085 extras_topology.xml:1153 +#: extras_topology.xml:1219 extras_topology.xml:1273 extras_topology.xml:1321 +#: extras_topology.xml:1368 extras_topology.xml:1411 extras_topology.xml:1465 +#: extras_topology.xml:1559 extras_topology.xml:1654 extras_topology.xml:1696 +#: extras_topology.xml:1738 extras_topology.xml:1781 extras_topology.xml:1830 +#: extras_topology.xml:1874 extras_topology.xml:1926 extras_topology.xml:1984 +#: extras_topology.xml:2025 extras_topology.xml:2082 extras_topology.xml:2128 +#: extras_topology.xml:2219 extras_topology.xml:2281 extras_topology.xml:2329 +#: extras_topology.xml:2377 extras_topology.xml:2425 extras_topology.xml:2519 +#, no-c-format +msgid "Description" +msgstr "Opis" + +#. Tag: para +#: extras_topology.xml:32 +#, no-c-format +msgid "" +"A composite type that consists of a sequence number and edge number. This is " +"the return type for ST_GetFaceEdges function." +msgstr "" + +#. Tag: para +#: extras_topology.xml:35 +#, no-c-format +msgid "" +"sequence is an integer: Refers to a topology defined in " +"the topology.topology table which defines the topology schema and srid." +msgstr "" + +#. Tag: para +#: extras_topology.xml:38 +#, no-c-format +msgid "edge is an integer: The identifier of an edge." +msgstr "" + +#. Tag: refname +#: extras_topology.xml:46 +#, no-c-format +msgid "topogeometry" +msgstr "topogeometry" + +#. Tag: refpurpose +#: extras_topology.xml:47 +#, no-c-format +msgid "" +"A composite type that refers to a topology geometry in a specific topology, " +"layer, having specific type (1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:" +"collection) with specific identifier id in the topology. The id uniquely " +"defines the topogeometry in the topology." +msgstr "" + +#. Tag: para +#: extras_topology.xml:51 +#, no-c-format +msgid "" +"A composite type that refers to a topology geometry in a specific topology, " +"layer, having specific type with specific id. The elements of a topogeometry " +"are the properties: topology_id,layer_id,id integer,type integer." +msgstr "" + +#. Tag: para +#: extras_topology.xml:54 +#, no-c-format +msgid "" +"topology_id is an integer: Refers to a topology defined " +"in the topology.topology table which defines the topology schema and srid." +msgstr "" + +#. Tag: para +#: extras_topology.xml:57 +#, no-c-format +msgid "" +"layer_id is an integer: The layer_id in the layers table " +"that hte topogeometry belongs to. The combination of topology_id, layer_id " +"provides a unique reference in the topology.layers table." +msgstr "" + +#. Tag: para +#: extras_topology.xml:60 +#, no-c-format +msgid "" +"type integer between 1 - 4 that defines the geometry " +"type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection" +msgstr "" + +#. Tag: para +#: extras_topology.xml:63 +#, no-c-format +msgid "" +"id is an integer: The id is the autogenerated sequence " +"number that uniquely defines the topogeometry in the respective topology." +msgstr "" + +#. Tag: title +#: extras_topology.xml:69 +#, no-c-format +msgid "Casting Behavior" +msgstr "" + +#. Tag: para +#: extras_topology.xml:70 +#, no-c-format +msgid "" +"This section lists the automatic as well as explicit casts allowed for this " +"data type" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:75 +#, no-c-format +msgid "Cast To" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:76 +#, no-c-format +msgid "Behavior" +msgstr "" + +#. Tag: entry +#: extras_topology.xml:79 +#, no-c-format +msgid "geometry" +msgstr "geometry" + +#. Tag: entry +#: extras_topology.xml:80 +#, no-c-format +msgid "automatic" +msgstr "" + +#. Tag: title +#: extras_topology.xml:88 extras_topology.xml:116 extras_topology.xml:148 +#: extras_topology.xml:169 extras_topology.xml:261 extras_topology.xml:301 +#: extras_topology.xml:341 extras_topology.xml:378 extras_topology.xml:419 +#: extras_topology.xml:495 extras_topology.xml:544 extras_topology.xml:583 +#: extras_topology.xml:632 extras_topology.xml:673 extras_topology.xml:719 +#: extras_topology.xml:765 extras_topology.xml:826 extras_topology.xml:873 +#: extras_topology.xml:929 extras_topology.xml:986 extras_topology.xml:1058 +#: extras_topology.xml:1126 extras_topology.xml:1193 extras_topology.xml:1241 +#: extras_topology.xml:1290 extras_topology.xml:1340 extras_topology.xml:1388 +#: extras_topology.xml:1437 extras_topology.xml:1483 extras_topology.xml:1537 +#: extras_topology.xml:1581 extras_topology.xml:1631 extras_topology.xml:1669 +#: extras_topology.xml:1711 extras_topology.xml:1753 extras_topology.xml:1803 +#: extras_topology.xml:1848 extras_topology.xml:1898 extras_topology.xml:1951 +#: extras_topology.xml:2000 extras_topology.xml:2059 extras_topology.xml:2102 +#: extras_topology.xml:2177 extras_topology.xml:2249 extras_topology.xml:2307 +#: extras_topology.xml:2343 extras_topology.xml:2396 extras_topology.xml:2443 +#: extras_topology.xml:2551 +#, no-c-format +msgid "See Also" +msgstr "Zobacz także" + +#. Tag: refname +#: extras_topology.xml:95 +#, no-c-format +msgid "validatetopology_returntype" +msgstr "validatetopology_returntype" + +#. Tag: refpurpose +#: extras_topology.xml:96 +#, no-c-format +msgid "" +"A composite type that consists of an error message and id1 and id2 to denote " +"location of error. This is the return type for ValidateTopology" +msgstr "" + +#. Tag: para +#: extras_topology.xml:100 +#, no-c-format +msgid "" +"A composite type that consists of an error message and two integers. The " +" function returns a set of these to " +"denote validation errors and the id1 and id2 to denote the ids of the " +"topology objects involved in the error." +msgstr "" + +#. Tag: para +#: extras_topology.xml:103 +#, no-c-format +msgid "error is varchar: Denotes type of error." +msgstr "" + +#. Tag: para +#: extras_topology.xml:104 +#, no-c-format +msgid "" +"Current error descriptors are: coincident nodes, edge crosses node, edge not " +"simple, edge end node geometry mis-match, edge start node geometry mismatch, " +"face overlaps face,face within face," +msgstr "" + +#. Tag: para +#: extras_topology.xml:107 +#, no-c-format +msgid "" +"id1 is an integer: Denotes identifier of edge / face / " +"nodes in error." +msgstr "" + +#. Tag: para +#: extras_topology.xml:110 +#, no-c-format +msgid "" +"id2 is an integer: For errors that involve 2 objects " +"denotes the secondary edge / or node" +msgstr "" + +#. Tag: para +#: extras_topology.xml:125 +#, no-c-format +msgid "" +"This section lists the PostgreSQL domains installed by PostGIS Topology. " +"Domains can be used like object types as return objects of functions or " +"table columns. The distinction between a domain and a type is that a domain " +"is an existing type with a check constraint bound to it." +msgstr "" + +#. Tag: title +#: extras_topology.xml:130 +#, no-c-format +msgid "Topology Domains" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:134 +#, no-c-format +msgid "TopoElement" +msgstr "TopoElement" + +#. Tag: refpurpose +#: extras_topology.xml:135 +#, no-c-format +msgid "" +"An array of 2 integers generally used to identify a TopoGeometry component." +msgstr "" + +#. Tag: para +#: extras_topology.xml:139 +#, no-c-format +msgid "" +"An array of 2 integers used to represent the id and type of a topology " +"primitive or the id and layer of a TopoGeometry. Sets of such pairs are used " +"to define TopoGeometry objects (either simple or hierarchical)." +msgstr "" + +#. Tag: title +#: extras_topology.xml:142 extras_topology.xml:163 extras_topology.xml:254 +#: extras_topology.xml:294 extras_topology.xml:335 extras_topology.xml:373 +#: extras_topology.xml:413 extras_topology.xml:484 extras_topology.xml:534 +#: extras_topology.xml:577 extras_topology.xml:626 extras_topology.xml:819 +#: extras_topology.xml:866 extras_topology.xml:922 extras_topology.xml:979 +#: extras_topology.xml:1051 extras_topology.xml:1119 extras_topology.xml:1187 +#: extras_topology.xml:1235 extras_topology.xml:1382 extras_topology.xml:1431 +#: extras_topology.xml:1477 extras_topology.xml:1529 extras_topology.xml:1574 +#: extras_topology.xml:1623 extras_topology.xml:1663 extras_topology.xml:1705 +#: extras_topology.xml:1747 extras_topology.xml:1796 extras_topology.xml:1842 +#: extras_topology.xml:2053 extras_topology.xml:2096 extras_topology.xml:2171 +#: extras_topology.xml:2300 extras_topology.xml:2339 extras_topology.xml:2389 +#: extras_topology.xml:2436 extras_topology.xml:2542 +#, no-c-format +msgid "Examples" +msgstr "Przykłady" + +#. Tag: programlisting +#: extras_topology.xml:143 +#, no-c-format +msgid "" +"SELECT ARRAY[1,2]::topology.topoelement;\n" +" te\n" +"-------\n" +" {1,2}" +msgstr "" +"SELECT ARRAY[1,2]::topology.topoelement;\n" +" te\n" +"-------\n" +" {1,2}" + +#. Tag: programlisting +#: extras_topology.xml:144 +#, no-c-format +msgid "" +"--Example of what happens when you try to case a 3 element array to " +"topoelement\n" +"-- NOTE: topoement has to be a 2 element array so fails dimension check\n" +"SELECT ARRAY[1,2,3]::topology.topoelement;\n" +"ERROR: value for domain topology.topoelement violates check constraint " +"\"dimensions\"" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:155 +#, no-c-format +msgid "TopoElementArray" +msgstr "TopoElementArray" + +#. Tag: refpurpose +#: extras_topology.xml:156 +#, no-c-format +msgid "An array of TopoElement objects" +msgstr "Tablica obiektów TopoElement" + +#. Tag: para +#: extras_topology.xml:160 +#, no-c-format +msgid "" +"An array of 1 or more TopoElement objects, generally used to pass around " +"components of TopoGeometry objects." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:164 +#, no-c-format +msgid "" +"SELECT '{{1,2},{4,3}}'::topology.topoelementarray As tea;\n" +" tea\n" +"-------\n" +"{{1,2},{4,3}}\n" +"\n" +"-- more verbose equivalent --\n" +"SELECT ARRAY[ARRAY[1,2], ARRAY[4,3]]::topology.topoelementarray As tea;\n" +"\n" +" tea\n" +"-------\n" +"{{1,2},{4,3}}\n" +"\n" +"--using the array agg function packaged with topology --\n" +"SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n" +" FROM generate_series(1,4) As e CROSS JOIN generate_series(1,3) As t;\n" +" tea\n" +"--------------------------------------------------------------------------\n" +"{{1,1},{1,2},{1,3},{2,1},{2,2},{2,3},{3,1},{3,2},{3,3},{4,1},{4,2},{4,3}}" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:165 +#, no-c-format +msgid "" +"SELECT '{{1,2,4},{3,4,5}}'::topology.topoelementarray As tea;\n" +"ERROR: value for domain topology.topoelementarray violates check constraint " +"\"dimensions\"" +msgstr "" + +#. Tag: para +#: extras_topology.xml:170 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: para +#: extras_topology.xml:182 +#, no-c-format +msgid "" +"This section lists the Topology functions for building new Topology schemas, " +"validating topologies, and managing TopoGeometry Columns" +msgstr "" + +#. Tag: title +#: extras_topology.xml:185 +#, no-c-format +msgid "Topology and TopoGeometry Management" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:188 +#, no-c-format +msgid "AddTopoGeometryColumn" +msgstr "AddTopoGeometryColumn" + +#. Tag: refpurpose +#: extras_topology.xml:189 +#, no-c-format +msgid "" +"Adds a topogeometry column to an existing table, registers this new column " +"as a layer in topology.layer and returns the new layer_id." +msgstr "" + +#. Tag: funcsynopsis +#: extras_topology.xml:193 +#, no-c-format +msgid "" +" text AddTopoGeometryColumn varchar topology_name varchar " +"schema_name varchar table_name varchar column_name varchar " +" feature_type " +" text AddTopoGeometryColumn varchar topology_name varchar " +"schema_name varchar table_name varchar column_name varchar " +" feature_type " +"integer child_layer " +msgstr "" +" text AddTopoGeometryColumn varchar topology_name varchar " +"schema_name varchar table_name varchar column_name varchar " +" feature_type " +" text AddTopoGeometryColumn varchar topology_name varchar " +"schema_name varchar table_name varchar column_name varchar " +" feature_type " +"integer child_layer " + +#. Tag: para +#: extras_topology.xml:238 +#, no-c-format +msgid "" +"Each TopoGeometry object belongs to a specific Layer of a specific Topology. " +"Before creating a TopoGeometry object you need to create its TopologyLayer. " +"A Topology Layer is an association of a feature-table with the topology. It " +"also contain type and hierarchy information. We create a layer using the " +"AddTopoGeometryColumn() function:" +msgstr "" + +#. Tag: para +#: extras_topology.xml:240 +#, no-c-format +msgid "" +"This function will both add the requested column to the table and add a " +"record to the topology.layer table with all the given info." +msgstr "" + +#. Tag: para +#: extras_topology.xml:241 +#, no-c-format +msgid "" +"If you don't specify [child_layer] (or set it to NULL) this layer would " +"contain Basic TopoGeometries (composed by primitive topology elements). " +"Otherwise this layer will contain hierarchical TopoGeometries (composed by " +"TopoGeometries from the child_layer)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:244 +#, no-c-format +msgid "" +"Once the layer is created (it's id is returned by the AddTopoGeometryColumn " +"function) you're ready to construct TopoGeometry objects in it" +msgstr "" + +#. Tag: para +#: extras_topology.xml:245 +#, no-c-format +msgid "" +"Valid feature_types are: POINT, LINE, POLYGON, COLLECTION" +msgstr "" +"Prawidłowymi feature_type są: POINT, LINE, POLYGON, " +"COLLECTION" + +#. Tag: para +#: extras_topology.xml:248 extras_topology.xml:289 extras_topology.xml:330 +#: extras_topology.xml:406 extras_topology.xml:479 extras_topology.xml:571 +#: extras_topology.xml:813 extras_topology.xml:860 extras_topology.xml:1228 +#: extras_topology.xml:1376 extras_topology.xml:1425 extras_topology.xml:1471 +#: extras_topology.xml:1658 extras_topology.xml:1742 extras_topology.xml:1836 +#: extras_topology.xml:2227 extras_topology.xml:2384 extras_topology.xml:2431 +#, no-c-format +msgid "Availability: 1.?" +msgstr "Dostępność: 1.?" + +#. Tag: programlisting +#: extras_topology.xml:255 +#, no-c-format +msgid "" +"-- Note for this example we created our new table in the ma_topo schema \n" +"-- though we could have created it in a different schema -- in which case " +"topology_name and schema_name would be different \n" +"CREATE SCHEMA ma;\n" +"CREATE TABLE ma.parcels(gid serial, parcel_id varchar(20) PRIMARY KEY, " +"address text);\n" +"SELECT topology.AddTopoGeometryColumn('ma_topo', 'ma', 'parcels', 'topo', " +"'POLYGON');" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:256 +#, no-c-format +msgid "" +"CREATE SCHEMA ri;\n" +"CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);\n" +"SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', " +"'LINE');" +msgstr "" +"CREATE SCHEMA ri;\n" +"CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);\n" +"SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', " +"'LINE');" + +#. Tag: para +#: extras_topology.xml:263 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:268 +#, no-c-format +msgid "DropTopology" +msgstr "DropTopology" + +#. Tag: refpurpose +#: extras_topology.xml:270 +#, no-c-format +msgid "" +"Use with caution: Drops a topology schema and deletes its reference from " +"topology.topology table and references to tables in that schema from the " +"geometry_columns table." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:275 +#, no-c-format +msgid "" +"integer DropTopology " +"varchar topology_schema_name" +msgstr "" +"integer DropTopology " +"varchar topology_schema_name" + +#. Tag: para +#: extras_topology.xml:285 +#, no-c-format +msgid "" +"Drops a topology schema and deletes its reference from topology.topology " +"table and references to tables in that schema from the geometry_columns " +"table. This function should be USED WITH CAUTION, as it could destroy data " +"you care about. If the schema does not exist, it just removes reference " +"entries the named schema." +msgstr "" + +#. Tag: para +#: extras_topology.xml:295 +#, no-c-format +msgid "" +"Cascade drops the ma_topo schema and removes all references to it in " +"topology.topology and geometry_columns." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:296 +#, no-c-format +msgid "SELECT topology.DropTopology('ma_topo');" +msgstr "SELECT topology.DropTopology('ma_topo');" + +#. Tag: refname +#: extras_topology.xml:307 +#, no-c-format +msgid "DropTopoGeometryColumn" +msgstr "DropTopoGeometryColumn" + +#. Tag: refpurpose +#: extras_topology.xml:309 +#, no-c-format +msgid "" +"Drops the topogeometry column from the table named table_name in schema schema_name and unregisters the " +"columns from topology.layer table." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:314 +#, no-c-format +msgid "" +"text DropTopoGeometryColumn " +"varchar schema_name varchar table_name varchar column_name" +msgstr "" +"text DropTopoGeometryColumn " +"varchar schema_name varchar table_name varchar column_name" + +#. Tag: para +#: extras_topology.xml:326 +#, no-c-format +msgid "" +"Drops the topogeometry column from the table named table_name in schema schema_name and unregisters the " +"columns from topology.layer table. Returns summary of drop status. NOTE: it " +"first sets all values to NULL before dropping to bypass referential " +"integrity checks." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:336 +#, no-c-format +msgid "" +"SELECT topology.DropTopoGeometryColumn('ma_topo', 'parcel_topo', 'topo');" +msgstr "" +"SELECT topology.DropTopoGeometryColumn('ma_topo', 'parcel_topo', 'topo');" + +#. Tag: refname +#: extras_topology.xml:348 +#, no-c-format +msgid "TopologySummary" +msgstr "TopologySummary" + +#. Tag: refpurpose +#: extras_topology.xml:350 +#, no-c-format +msgid "" +"Takes a topology name and provides summary totals of types of objects in " +"topology" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:355 +#, no-c-format +msgid "" +"text TopologySummary " +"varchar topology_schema_name" +msgstr "" +"text TopologySummary " +"varchar topology_schema_name" + +#. Tag: para +#: extras_topology.xml:365 +#, no-c-format +msgid "" +"Takes a topology name and provides summary totals of types of objects in " +"topology." +msgstr "" + +#. Tag: para +#: extras_topology.xml:368 extras_topology.xml:529 extras_topology.xml:667 +#: extras_topology.xml:713 extras_topology.xml:759 extras_topology.xml:1700 +#: extras_topology.xml:1995 extras_topology.xml:2048 extras_topology.xml:2166 +#: extras_topology.xml:2334 extras_topology.xml:2537 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "Dostępność: 2.0.0" + +#. Tag: programlisting +#: extras_topology.xml:374 +#, no-c-format +msgid "" +"SELECT topology.topologysummary('city_data');\n" +" topologysummary \n" +"--------------------------------------------------------\n" +" Topology city_data (329), SRID 4326, precision: 0\n" +" 22 nodes, 24 edges, 10 faces, 29 topogeoms in 5 layers\n" +" Layer 1, type Polygonal (3), 9 topogeoms\n" +" Deploy: features.land_parcels.feature\n" +" Layer 2, type Puntal (1), 8 topogeoms\n" +" Deploy: features.traffic_signs.feature\n" +" Layer 3, type Lineal (2), 8 topogeoms\n" +" Deploy: features.city_streets.feature\n" +" Layer 4, type Polygonal (3), 3 topogeoms\n" +" Hierarchy level 1, child layer 1\n" +" Deploy: features.big_parcels.feature\n" +" Layer 5, type Puntal (1), 1 topogeoms\n" +" Hierarchy level 1, child layer 2\n" +" Deploy: features.big_signs.feature" +msgstr "" +"SELECT topology.topologysummary('city_data');\n" +" topologysummary \n" +"--------------------------------------------------------\n" +" Topology city_data (329), SRID 4326, precision: 0\n" +" 22 nodes, 24 edges, 10 faces, 29 topogeoms in 5 layers\n" +" Layer 1, type Polygonal (3), 9 topogeoms\n" +" Deploy: features.land_parcels.feature\n" +" Layer 2, type Puntal (1), 8 topogeoms\n" +" Deploy: features.traffic_signs.feature\n" +" Layer 3, type Lineal (2), 8 topogeoms\n" +" Deploy: features.city_streets.feature\n" +" Layer 4, type Polygonal (3), 3 topogeoms\n" +" Hierarchy level 1, child layer 1\n" +" Deploy: features.big_parcels.feature\n" +" Layer 5, type Puntal (1), 1 topogeoms\n" +" Hierarchy level 1, child layer 2\n" +" Deploy: features.big_signs.feature" + +#. Tag: refname +#: extras_topology.xml:385 +#, no-c-format +msgid "ValidateTopology" +msgstr "ValidateTopology" + +#. Tag: refpurpose +#: extras_topology.xml:387 +#, no-c-format +msgid "" +"Returns a set of validatetopology_returntype objects detailing issues with " +"topology" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:392 +#, no-c-format +msgid "" +"setof validatetopology_returntype ValidateTopology varchar " +"topology_schema_name" +msgstr "" +"setof validatetopology_returntype ValidateTopology varchar " +"topology_schema_name" + +#. Tag: para +#: extras_topology.xml:402 +#, no-c-format +msgid "" +"Returns a set of objects " +"detailing issues with topology. Refer to for listing of possible errors." +msgstr "" + +#. Tag: para +#: extras_topology.xml:408 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false " +"positives that were existent in prior versions." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:414 +#, no-c-format +msgid "" +"SELECT * FROM topology.ValidateTopology('ma_topo');\n" +" error | id1 | id2\n" +"-------------------+-----+-----\n" +"face without edges | 0 |" +msgstr "" +"SELECT * FROM topology.ValidateTopology('ma_topo');\n" +" error | id1 | id2\n" +"-------------------+-----+-----\n" +"face without edges | 0 |" + +#. Tag: para +#: extras_topology.xml:420 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: para +#: extras_topology.xml:428 +#, no-c-format +msgid "This section covers the topology functions for creating new topologies." +msgstr "" + +#. Tag: title +#: extras_topology.xml:431 +#, no-c-format +msgid "Topology Constructors" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:435 +#, no-c-format +msgid "CreateTopology" +msgstr "CreateTopology" + +#. Tag: refpurpose +#: extras_topology.xml:436 +#, no-c-format +msgid "" +"Creates a new topology schema and registers this new schema in the topology." +"topology table." +msgstr "" + +#. Tag: funcsynopsis +#: extras_topology.xml:440 +#, no-c-format +msgid "" +" integer CreateTopology varchar topology_schema_name integer " +"CreateTopology varchar topology_schema_name " +"integer srid integer CreateTopology varchar " +"topology_schema_name " +"integer srid " +"double precision tolerance integer " +"CreateTopology varchar topology_schema_name " +"integer srid " +"double precision tolerance boolean hasz " +msgstr "" +" integer CreateTopology varchar topology_schema_name integer " +"CreateTopology varchar topology_schema_name " +"integer srid integer CreateTopology varchar " +"topology_schema_name " +"integer srid " +"double precision tolerance integer " +"CreateTopology varchar topology_schema_name " +"integer srid " +"double precision tolerance boolean hasz " + +#. Tag: para +#: extras_topology.xml:472 +#, no-c-format +msgid "" +"Creates a new schema with name topology_name consisting " +"of tables (edge_data,face," +"node, relation and registers this new " +"topology in the topology.topology table. It returns the id of the topology " +"in the topology table. The srid is the spatial reference identified as " +"defined in spatial_ref_sys table for that topology. Topologies must be " +"uniquely named. The tolerance is measured in the units of the spatial " +"reference system. If the tolerance is not specified defaults to 0." +msgstr "" + +#. Tag: para +#: extras_topology.xml:476 +#, no-c-format +msgid "" +"This is similar to the SQL/MM but a bit " +"more functional. hasz defaults to false if not specified." +msgstr "" + +#. Tag: para +#: extras_topology.xml:485 +#, no-c-format +msgid "" +"This example creates a new schema called ma_topo that will store edges, " +"faces, and relations in Massachusetts State Plane meters. The tolerance " +"represents 1/2 meter since the spatial reference system is a meter based " +"spatial reference system" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:487 +#, no-c-format +msgid "SELECT topology.CreateTopology('ma_topo',26986, 0.5);" +msgstr "SELECT topology.CreateTopology('ma_topo',26986, 0.5);" + +#. Tag: para +#: extras_topology.xml:489 +#, no-c-format +msgid "Create Rhode Island topology in State Plane ft" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:490 +#, no-c-format +msgid "" +"SELECT topology.CreateTopology('ri_topo',3438) As topoid;\n" +"topoid\n" +"------\n" +"2" +msgstr "" +"SELECT topology.CreateTopology('ri_topo',3438) As topoid;\n" +"topoid\n" +"------\n" +"2" + +#. Tag: para +#: extras_topology.xml:497 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: extras_topology.xml:503 +#, no-c-format +msgid "CopyTopology" +msgstr "CopyTopology" + +#. Tag: refpurpose +#: extras_topology.xml:504 +#, no-c-format +msgid "" +"Makes a copy of a topology structure (nodes, edges, faces, layers and " +"TopoGeometries)." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:509 +#, no-c-format +msgid "" +"integer CopyTopology " +"varchar existing_topology_name varchar new_name" +msgstr "" +"integer CopyTopology " +"varchar existing_topology_name varchar new_name" + +#. Tag: para +#: extras_topology.xml:520 +#, no-c-format +msgid "" +"Creates a new topology with name new_topology_name and " +"SRID and precision taken from existing_topology_name, " +"copies all nodes, edges and faces in there, copies layers and their " +"TopoGeometries too." +msgstr "" + +#. Tag: para +#: extras_topology.xml:524 +#, no-c-format +msgid "" +"The new rows in topology.layer will contain synthesized values for " +"schema_name, table_name and feature_column. This is because the TopoGeometry " +"will only exist as a definition but won't be available in any user-level " +"table yet." +msgstr "" + +#. Tag: para +#: extras_topology.xml:535 +#, no-c-format +msgid "This example makes a backup of a topology called ma_topo" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:538 +#, no-c-format +msgid "SELECT topology.CopyTopology('ma_topo', 'ma_topo_bakup');" +msgstr "SELECT topology.CopyTopology('ma_topo', 'ma_topo_bakup');" + +#. Tag: para +#: extras_topology.xml:546 extras_topology.xml:2060 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:552 +#, no-c-format +msgid "ST_InitTopoGeo" +msgstr "ST_InitTopoGeo" + +#. Tag: refpurpose +#: extras_topology.xml:553 +#, no-c-format +msgid "" +"Creates a new topology schema and registers this new schema in the topology." +"topology table and details summary of process." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:558 +#, no-c-format +msgid "" +"text ST_InitTopoGeo " +"varchar topology_schema_name" +msgstr "" +"text ST_InitTopoGeo " +"varchar topology_schema_name" + +#. Tag: para +#: extras_topology.xml:568 +#, no-c-format +msgid "" +"This is an SQL-MM equivalent of CreateTopology but lacks the spatial " +"reference and tolerance options of CreateTopology and outputs a text " +"description of creation instead of topology id." +msgstr "" + +#. Tag: para +#: extras_topology.xml:572 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.17" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:578 +#, no-c-format +msgid "" +"SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;\n" +" astopocreation\n" +"------------------------------------------------------------\n" +" Topology-Geometry 'topo_schema_to_create' (id:7) created." +msgstr "" +"SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;\n" +" astopocreation\n" +"------------------------------------------------------------\n" +" Topology-Geometry 'topo_schema_to_create' (id:7) created." + +#. Tag: refname +#: extras_topology.xml:592 +#, no-c-format +msgid "ST_CreateTopoGeo" +msgstr "ST_CreateTopoGeo" + +#. Tag: refpurpose +#: extras_topology.xml:594 +#, no-c-format +msgid "" +"Adds a collection of geometries to a given empty topology and " +"returns a message detailing success." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:601 +#, no-c-format +msgid "" +"text ST_CreateTopoGeo " +"varchar atopology " +"geometry acollection" +msgstr "" +"text ST_CreateTopoGeo " +"varchar atopology " +"geometry acollection" + +#. Tag: para +#: extras_topology.xml:612 +#, no-c-format +msgid "" +"Adds a collection of geometries to a given empty topology and returns " +"a message detailing success." +msgstr "" + +#. Tag: para +#: extras_topology.xml:616 +#, no-c-format +msgid "Useful for populating an empty topology." +msgstr "" + +#. Tag: para +#: extras_topology.xml:620 extras_topology.xml:916 extras_topology.xml:973 +#: extras_topology.xml:1045 extras_topology.xml:1113 extras_topology.xml:1283 +#: extras_topology.xml:1333 extras_topology.xml:1790 extras_topology.xml:1892 +#: extras_topology.xml:1946 extras_topology.xml:2297 +#, no-c-format +msgid "Availability: 2.0" +msgstr "Dostępność: 2.0" + +#. Tag: para +#: extras_topology.xml:621 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:627 +#, no-c-format +msgid "" +"-- Populate topology --\n" +"SELECT topology.ST_CreateTopoGeo('ri_topo', \n" +" ST_GeomFromText('MULTILINESTRING((384744 236928,384750 236923,384769 " +"236911,384799 236895,384811 236890,384833 236884,\n" +" 384844 236882,384866 236881,384879 236883,384954 236898,385087 " +"236932,385117 236938,\n" +" 385167 236938,385203 236941,385224 236946,385233 236950,385241 " +"236956,385254 236971,\n" +" 385260 236979,385268 236999,385273 237018,385273 237037,385271 " +"237047,385267 237057,\n" +" 385225 237125,385210 237144,385192 237161,385167 237192,385162 " +"237202,385159 237214,\n" +" 385159 237227,385162 237241,385166 237256,385196 237324,385209 " +"237345,385234 237375,\n" +" 385237 237383,385238 237399,385236 237407,385227 237419,385213 " +"237430,385193 237439,\n" +" 385174 237451,385170 237455,385169 237460,385171 237475,385181 " +"237503,385190 237521,\n" +" 385200 237533,385206 237538,385213 237541,385221 237542,385235 " +"237540,385242 237541,\n" +" 385249 237544,385260 237555,385270 237570,385289 237584,385292 " +"237589,385291 237596,385284 237630))',3438) \n" +" );\n" +"\n" +" st_createtopogeo\n" +"----------------------------\n" +" Topology ri_topo populated\n" +" \n" +" \n" +"-- create tables and topo geometries --\n" +"CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);\n" +"\n" +"SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', " +"'LINE');" +msgstr "" + +#. Tag: para +#: extras_topology.xml:633 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: extras_topology.xml:639 +#, no-c-format +msgid "TopoGeo_AddPoint" +msgstr "TopoGeo_AddPoint" + +#. Tag: refpurpose +#: extras_topology.xml:641 +#, no-c-format +msgid "" +"Adds a point to an existing topology using a tolerance and possibly " +"splitting an existing edge." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:648 +#, no-c-format +msgid "" +"integer TopoGeo_AddPoint " +"varchar toponame " +"geometry apoint " +"float8 tolerance" +msgstr "" +"integer TopoGeo_AddPoint " +"varchar toponame " +"geometry apoint " +"float8 tolerance" + +#. Tag: para +#: extras_topology.xml:660 +#, no-c-format +msgid "" +"Adds a point to an existing topology and return its identifier. The given " +"point will snap to existing nodes or edges within given tolerance. An " +"existing edge may be split by the snapped point." +msgstr "" + +#. Tag: para +#: extras_topology.xml:674 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: extras_topology.xml:685 +#, no-c-format +msgid "TopoGeo_AddLineString" +msgstr "TopoGeo_AddLineString" + +#. Tag: refpurpose +#: extras_topology.xml:687 +#, no-c-format +msgid "" +"Adds a linestring to an existing topology using a tolerance and possibly " +"splitting existing edges/faces." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:694 +#, no-c-format +msgid "" +"integer TopoGeo_AddLineString " +"varchar toponame " +"geometry aline " +"float8 tolerance" +msgstr "" +"integer TopoGeo_AddLineString " +"varchar toponame " +"geometry aline " +"float8 tolerance" + +#. Tag: para +#: extras_topology.xml:706 +#, no-c-format +msgid "" +"Adds a linestring to an existing topology and return a set of edge " +"identifiers forming it up. The given line will snap to existing nodes or " +"edges within given tolerance. Existing edges and faces may be split by the " +"line." +msgstr "" + +#. Tag: para +#: extras_topology.xml:720 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: extras_topology.xml:731 +#, no-c-format +msgid "TopoGeo_AddPolygon" +msgstr "TopoGeo_AddPolygon" + +#. Tag: refpurpose +#: extras_topology.xml:733 +#, no-c-format +msgid "" +"Adds a polygon to an existing topology using a tolerance and possibly " +"splitting existing edges/faces." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:740 +#, no-c-format +msgid "" +"integer TopoGeo_AddPolygon " +"varchar atopology " +"geometry aline " +"float8 atolerance" +msgstr "" +"integer TopoGeo_AddPolygon " +"varchar atopology " +"geometry aline " +"float8 atolerance" + +#. Tag: para +#: extras_topology.xml:752 +#, no-c-format +msgid "" +"Adds a polygon to an existing topology and return a set of face identifiers " +"forming it up. The boundary of the given polygon will snap to existing nodes " +"or edges within given tolerance. Existing edges and faces may be split by " +"the boundary of the new polygon." +msgstr "" + +#. Tag: para +#: extras_topology.xml:766 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" +", , , " +"" + +#. Tag: para +#: extras_topology.xml:781 +#, no-c-format +msgid "" +"This section covers topology functions for adding, moving, deleting, and " +"splitting edges, faces, and nodes. All of these functions are defined by ISO " +"SQL/MM." +msgstr "" + +#. Tag: title +#: extras_topology.xml:784 +#, no-c-format +msgid "Topology Editors" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:788 +#, no-c-format +msgid "ST_AddIsoNode" +msgstr "ST_AddIsoNode" + +#. Tag: refpurpose +#: extras_topology.xml:790 +#, no-c-format +msgid "" +"Adds an isolated node to a face in a topology and returns the nodeid of the " +"new node. If face is null, the node is still created." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:795 +#, no-c-format +msgid "" +"integer ST_AddIsoNode " +"varchar atopology " +"integer aface " +"geometry apoint" +msgstr "" +"integer ST_AddIsoNode " +"varchar atopology " +"integer aface " +"geometry apoint" + +#. Tag: para +#: extras_topology.xml:807 +#, no-c-format +msgid "" +"Adds an isolated node with point location apoint to an " +"existing face with faceid aface to a topology " +"atopology and returns the nodeid of the new node." +msgstr "" + +#. Tag: para +#: extras_topology.xml:808 +#, no-c-format +msgid "" +"If the spatial reference system (srid) of the point geometry is not the same " +"as the topology, the apoint is not a point geometry, the " +"point is null, or the point intersects an existing edge (even at the " +"boundaries) then an exception is thrown. If the point already exists as a " +"node, an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:810 +#, no-c-format +msgid "" +"If aface is not null and the apoint is " +"not within the face, then an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:814 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1" +msgstr "" + +#. Tag: para +#: extras_topology.xml:827 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" +", , , " +"" + +#. Tag: refname +#: extras_topology.xml:833 +#, no-c-format +msgid "ST_AddIsoEdge" +msgstr "ST_AddIsoEdge" + +#. Tag: refpurpose +#: extras_topology.xml:835 +#, no-c-format +msgid "" +"Adds an isolated edge defined by geometry alinestring to a topology connecting two existing isolated nodes " +"anode and anothernode and returns the " +"edge id of the new edge." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:840 +#, no-c-format +msgid "" +"integer ST_AddIsoEdge " +"varchar atopology " +"integer anode " +"integer anothernode geometry alinestring" +msgstr "" +"integer ST_AddIsoEdge " +"varchar atopology " +"integer anode " +"integer anothernode geometry alinestring" + +#. Tag: para +#: extras_topology.xml:853 +#, no-c-format +msgid "" +"Adds an isolated edge defined by geometry alinestring to a topology connecting two existing isolated nodes " +"anode and anothernode and returns the " +"edge id of the new edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:854 +#, no-c-format +msgid "" +"If the spatial reference system (srid) of the alinestring " +"geometry is not the same as the topology, any of the input arguments are " +"null, or the nodes are contained in more than one face, or the nodes are " +"start or end nodes of an existing edge, then an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:856 +#, no-c-format +msgid "" +"If the alinestring is not within the face of the face the " +"anode and anothernode belong to, then " +"an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:857 +#, no-c-format +msgid "" +"If the anode and anothernode are not " +"the start and end points of the alinestring then an " +"exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:861 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4" +msgstr "" + +#. Tag: para +#: extras_topology.xml:874 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: extras_topology.xml:880 +#, no-c-format +msgid "ST_AddEdgeNewFaces" +msgstr "ST_AddEdgeNewFaces" + +#. Tag: refpurpose +#: extras_topology.xml:882 +#, no-c-format +msgid "" +"Add a new edge and, if in doing so it splits a face, delete the original " +"face and replace it with two new faces." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:887 +#, no-c-format +msgid "" +"integer ST_AddEdgeNewFaces " +"varchar atopology " +"integer anode " +"integer anothernode geometry acurve" +msgstr "" +"integer ST_AddEdgeNewFaces " +"varchar atopology " +"integer anode " +"integer anothernode geometry acurve" + +#. Tag: para +#: extras_topology.xml:900 +#, no-c-format +msgid "" +"Add a new edge and, if in doing so it splits a face, delete the original " +"face and replace it with two new faces. Returns the id of the newly added " +"edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:906 extras_topology.xml:964 extras_topology.xml:1027 +#: extras_topology.xml:1095 +#, no-c-format +msgid "Updates all existing joined edges and relationships accordingly." +msgstr "" + +#. Tag: para +#: extras_topology.xml:910 extras_topology.xml:968 +#, no-c-format +msgid "" +"If any arguments are null, the given nodes are unknown (must already exist " +"in the node table of the topology schema) , the " +"acurve is not a LINESTRING, the " +"anode and anothernode are not the " +"start and endpoints of acurve then an error is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:913 extras_topology.xml:971 extras_topology.xml:1166 +#, no-c-format +msgid "" +"If the spatial reference system (srid) of the acurve " +"geometry is not the same as the topology an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:917 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:937 +#, no-c-format +msgid "ST_AddEdgeModFace" +msgstr "ST_AddEdgeModFace" + +#. Tag: refpurpose +#: extras_topology.xml:939 +#, no-c-format +msgid "" +"Add a new edge and, if in doing so it splits a face, modify the original " +"face and add a new face." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:944 +#, no-c-format +msgid "" +"integer ST_AddEdgeModFace " +"varchar atopology " +"integer anode " +"integer anothernode geometry acurve" +msgstr "" +"integer ST_AddEdgeModFace " +"varchar atopology " +"integer anode " +"integer anothernode geometry acurve" + +#. Tag: para +#: extras_topology.xml:957 +#, no-c-format +msgid "" +"Add a new edge and, if in doing so it splits a face, modify the original " +"face and add a new face. Unless the face being split is the Universal Face, " +"the new face will be on the right side of the newly added edge. Returns the " +"id of the newly added edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:974 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:994 +#, no-c-format +msgid "ST_RemEdgeNewFace" +msgstr "ST_RemEdgeNewFace" + +#. Tag: refpurpose +#: extras_topology.xml:996 +#, no-c-format +msgid "" +"Removes an edge and, if the removed edge separated two faces, " +"delete the original faces and replace them with a new face." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1004 +#, no-c-format +msgid "" +"integer ST_RemEdgeNewFace " +"varchar atopology " +"integer anedge" +msgstr "" +"integer ST_RemEdgeNewFace " +"varchar atopology " +"integer anedge" + +#. Tag: para +#: extras_topology.xml:1015 +#, no-c-format +msgid "" +"Removes an edge and, if the removed edge separated two faces, delete " +"the original faces and replace them with a new face." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1020 +#, no-c-format +msgid "" +"Returns the id of a newly created face or NULL, if no new face is created. " +"No new face is created when the removed edge is dangling or isolated or " +"confined with the universe face (possibly making the universe flood into the " +"face on the other side)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1031 extras_topology.xml:1099 +#, no-c-format +msgid "" +"Refuses to remove an edge partecipating in the definition of an existing " +"TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by " +"only one of them (and not the other)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1038 extras_topology.xml:1106 +#, no-c-format +msgid "" +"If any arguments are null, the given edge is unknown (must already exist in " +"the edge table of the topology schema), the topology name " +"is invalid then an error is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1046 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1066 +#, no-c-format +msgid "ST_RemEdgeModFace" +msgstr "ST_RemEdgeModFace" + +#. Tag: refpurpose +#: extras_topology.xml:1068 +#, no-c-format +msgid "" +"Removes an edge and, if the removed edge separated two faces, delete one of " +"the them and modify the other to take the space of both." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1076 +#, no-c-format +msgid "" +"integer ST_RemEdgeModFace " +"varchar atopology " +"integer anedge" +msgstr "" +"integer ST_RemEdgeModFace " +"varchar atopology " +"integer anedge" + +#. Tag: para +#: extras_topology.xml:1087 +#, no-c-format +msgid "" +"Removes an edge and, if the removed edge separated two faces, delete one of " +"the them and modify the other to take the space of both. Preferentially " +"keeps the face on the right, to be symmetric with ST_AddEdgeModFace also " +"keeping it. Returns the id of the face remaining in place of the removed " +"edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1114 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1134 +#, no-c-format +msgid "ST_ChangeEdgeGeom" +msgstr "ST_ChangeEdgeGeom" + +#. Tag: refpurpose +#: extras_topology.xml:1136 +#, no-c-format +msgid "" +"Changes the shape of an edge without affecting the topology " +"structure." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1143 +#, no-c-format +msgid "" +"integer ST_ChangeEdgeGeom " +"varchar atopology " +"integer anedge " +"geometry acurve" +msgstr "" +"integer ST_ChangeEdgeGeom " +"varchar atopology " +"integer anedge " +"geometry acurve" + +#. Tag: para +#: extras_topology.xml:1155 +#, no-c-format +msgid "" +"Changes the shape of an edge without affecting the topology structure." +"" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1158 +#, no-c-format +msgid "" +"If any arguments are null, the given edge does not exist in the " +"node table of the topology schema, the acurve is not a LINESTRING, the anode and anothernode are not the start and endpoints " +"of acurve or the modification would change the underlying " +"topology then an error is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1167 +#, no-c-format +msgid "" +"If the new acurve is not simple, then an error is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1169 +#, no-c-format +msgid "" +"If moving the edge from old to new position would hit an obstacle then an " +"error is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1175 +#, no-c-format +msgid "Availability: 1.1.0" +msgstr "Dostępność: 1.1.0" + +#. Tag: para +#: extras_topology.xml:1178 +#, no-c-format +msgid "Enhanced: 2.0.0 adds topological consistency enforcement" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1182 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1188 +#, no-c-format +msgid "" +"SELECT topology.ST_ChangeEdgeGeom('ma_topo', 1, \n" +" ST_GeomFromText('LINESTRING(227591.9 893900.4,227622.6 " +"893844.3,227641.6 893816.6, 227704.5 893778.5)', 26986) );\n" +" ----\n" +" Edge 1 changed" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1202 +#, no-c-format +msgid "ST_ModEdgeSplit" +msgstr "ST_ModEdgeSplit" + +#. Tag: refpurpose +#: extras_topology.xml:1204 +#, no-c-format +msgid "" +"Split an edge by creating a new node along an existing edge, modifying the " +"original edge and adding a new edge." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1209 +#, no-c-format +msgid "" +"text ST_ModEdgeSplit " +"varchar atopology " +"integer anedge " +"geometry apoint" +msgstr "" +"text ST_ModEdgeSplit " +"varchar atopology " +"integer anedge " +"geometry apoint" + +#. Tag: para +#: extras_topology.xml:1221 +#, no-c-format +msgid "" +"Split an edge by creating a new node along an existing edge, modifying the " +"original edge and adding a new edge. Updates all existing joined edges and " +"relationships accordingly." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1229 +#, no-c-format +msgid "Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1230 extras_topology.xml:1284 extras_topology.xml:1334 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1236 +#, no-c-format +msgid "" +"-- Add an edge --\n" +" SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227592 " +"893910, 227600 893910)', 26986) ) As edgeid;\n" +" \n" +"-- edgeid-\n" +"3\n" +"\n" +"\n" +"-- Split the edge --\n" +"SELECT topology.ST_ModEdgeSplit('ma_topo', 3, " +"ST_SetSRID(ST_Point(227594,893910),26986) ) As result;\n" +" result\n" +"-------------------------\n" +"7" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1242 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" +", , , " +"" + +#. Tag: refname +#: extras_topology.xml:1253 +#, no-c-format +msgid "ST_ModEdgeHeal" +msgstr "ST_ModEdgeHeal" + +#. Tag: refpurpose +#: extras_topology.xml:1255 +#, no-c-format +msgid "" +"Heal two edges by deleting the node connecting them, modifying the first " +"edge and deleting the second edge. Returns the id of the deleted node." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1263 +#, no-c-format +msgid "" +"int ST_ModEdgeHeal " +"varchar atopology " +"integer anedge " +"integer anotheredge" +msgstr "" +"int ST_ModEdgeHeal " +"varchar atopology " +"integer anedge " +"integer anotheredge" + +#. Tag: para +#: extras_topology.xml:1275 +#, no-c-format +msgid "" +"Heal two edges by deleting the node connecting them, modifying the first " +"edge and deleting the second edge. Returns the id of the deleted node. " +"Updates all existing joined edges and relationships accordingly." +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1300 +#, no-c-format +msgid "ST_NewEdgeHeal" +msgstr "ST_NewEdgeHeal" + +#. Tag: refpurpose +#: extras_topology.xml:1302 +#, no-c-format +msgid "" +"Heal two edges by deleting the node connecting them, deleting both edges, " +"and replacing them with an edge whose direction is the same as the first " +"edge provided." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1311 +#, no-c-format +msgid "" +"int ST_NewEdgeHeal " +"varchar atopology " +"integer anedge " +"integer anotheredge" +msgstr "" +"int ST_NewEdgeHeal " +"varchar atopology " +"integer anedge " +"integer anotheredge" + +#. Tag: para +#: extras_topology.xml:1323 +#, no-c-format +msgid "" +"Heal two edges by deleting the node connecting them, deleting both edges, " +"and replacing them with an edge whose direction is the same as the first " +"edge provided. Returns the id of the new edge replacing the healed ones. " +"Updates all existing joined edges and relationships accordingly." +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1351 +#, no-c-format +msgid "ST_MoveIsoNode" +msgstr "ST_MoveIsoNode" + +#. Tag: refpurpose +#: extras_topology.xml:1353 +#, no-c-format +msgid "" +"Moves an isolated node in a topology from one point to another. If new " +"apoint geometry exists as a node an error is thrown. " +"REturns description of move." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1358 +#, no-c-format +msgid "" +"text ST_MoveIsoNode " +"varchar atopology " +"integer anedge " +"geometry apoint" +msgstr "" +"text ST_MoveIsoNode " +"varchar atopology " +"integer anedge " +"geometry apoint" + +#. Tag: para +#: extras_topology.xml:1370 +#, no-c-format +msgid "" +"Moves an isolated node in a topology from one point to another. If new " +"apoint geometry exists as a node an error is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1371 +#, no-c-format +msgid "" +"If any arguments are null, the apoint is not a point, the " +"existing node is not isolated (is a start or end point of an existing edge), " +"new node location intersects an existing edge (even at the end points) then " +"an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1372 +#, no-c-format +msgid "" +"If the spatial reference system (srid) of the point geometry is not the same " +"as the topology an exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1377 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.2" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1383 +#, no-c-format +msgid "" +"-- Add an isolated node with no face --\n" +"SELECT topology.ST_AddIsoNode('ma_topo', NULL, " +"ST_GeomFromText('POINT(227579 893916)', 26986) ) As nodeid;\n" +" nodeid\n" +"--------\n" +" 7\n" +"-- Move the new node --\n" +"SELECT topology.ST_MoveIsoNode('ma_topo', 7, " +"ST_GeomFromText('POINT(227579.5 893916.5)', 26986) ) As descrip; \n" +" descrip\n" +"----------------------------------------------------\n" +"Isolated Node 7 moved to location 227579.5,893916.5" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1394 +#, no-c-format +msgid "ST_NewEdgesSplit" +msgstr "ST_NewEdgesSplit" + +#. Tag: refpurpose +#: extras_topology.xml:1396 +#, no-c-format +msgid "" +"Split an edge by creating a new node along an existing edge, deleting the " +"original edge and replacing it with two new edges. Returns the id of the new " +"node created that joins the new edges." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1401 +#, no-c-format +msgid "" +"integer ST_NewEdgesSplit " +"varchar atopology " +"integer anedge " +"geometry apoint" +msgstr "" +"integer ST_NewEdgesSplit " +"varchar atopology " +"integer anedge " +"geometry apoint" + +#. Tag: para +#: extras_topology.xml:1413 +#, no-c-format +msgid "" +"Split an edge with edge id anedge by creating a new node " +"with point location apoint along current edge, deleting " +"the original edge and replacing it with two new edges. Returns the id of the " +"new node created that joins the new edges. Updates all existing joined edges " +"and relationships accordingly." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1421 +#, no-c-format +msgid "" +"If the spatial reference system (srid) of the point geometry is not the same " +"as the topology, the apoint is not a point geometry, the " +"point is null, the point already exists as a node, the edge does not " +"correspond to an existing edge or the point is not within the edge then an " +"exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1426 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.8" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1432 +#, no-c-format +msgid "" +"-- Add an edge --\n" +"SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575 " +"893917,227592 893900)', 26986) ) As edgeid;\n" +"-- result-\n" +"edgeid\n" +"------\n" +" 2\n" +"-- Split the new edge --\n" +"SELECT topology.ST_NewEdgesSplit('ma_topo', 2, " +"ST_GeomFromText('POINT(227578.5 893913.5)', 26986) ) As newnodeid; \n" +" newnodeid\n" +"---------\n" +" 6" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1449 +#, no-c-format +msgid "ST_RemoveIsoNode" +msgstr "ST_RemoveIsoNode" + +#. Tag: refpurpose +#: extras_topology.xml:1451 +#, no-c-format +msgid "" +"Removes an isolated node and returns description of action. If " +"the node is not isolated (is start or end of an edge), then an exception is " +"thrown." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1456 +#, no-c-format +msgid "" +"text ST_RemoveIsoNode " +"varchar atopology " +"integer anode" +msgstr "" +"text ST_RemoveIsoNode " +"varchar atopology " +"integer anode" + +#. Tag: para +#: extras_topology.xml:1467 +#, no-c-format +msgid "" +"Removes an isolated node and returns description of action. If the " +"node is not isolated (is start or end of an edge), then an exception is " +"thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1472 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1478 +#, no-c-format +msgid "" +"-- Add an isolated node with no face --\n" +"SELECT topology.ST_RemoveIsoNode('ma_topo', 7 ) As result;\n" +" result\n" +"-------------------------\n" +" Isolated node 7 removed" +msgstr "" + +#. Tag: title +#: extras_topology.xml:1490 +#, no-c-format +msgid "Topology Accessors" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1493 +#, no-c-format +msgid "GetEdgeByPoint" +msgstr "GetEdgeByPoint" + +#. Tag: refpurpose +#: extras_topology.xml:1495 +#, no-c-format +msgid "Find the edge-id of an edge that intersects a given point" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1500 +#, no-c-format +msgid "" +"integer GetEdgeByPoint " +"varchar atopology " +"geometry apoint " +"float8 tol" +msgstr "" +"integer GetEdgeByPoint " +"varchar atopology " +"geometry apoint " +"float8 tol" + +#. Tag: title +#: extras_topology.xml:1511 +#, no-c-format +msgid "Retrieve the id of an edge that intersects a Point" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1513 +#, no-c-format +msgid "" +"The function returns an integer (id-edge) given a topology, a POINT and a " +"tolerance. If tolerance = 0 then the point has to intersect the edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1514 extras_topology.xml:1562 +#, no-c-format +msgid "" +"If the point is the location of a node, then an exception is thrown. To " +"avoid this run the GetNodeByPoint function." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1515 +#, no-c-format +msgid "If the point doesn't intersect an edge, returns 0 (zero)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1516 +#, no-c-format +msgid "" +"If use tolerance > 0 and there is more than one edge near the point then an " +"exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1521 +#, no-c-format +msgid "" +"If tolerance = 0, the function use ST_Intersects otherwise uses ST_DWithin." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1524 extras_topology.xml:1571 extras_topology.xml:1618 +#, no-c-format +msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." +msgstr "Dostępność: 2.0.0 - wymaga GEOS >= 3.3.0." + +#. Tag: para +#: extras_topology.xml:1530 extras_topology.xml:1624 +#, no-c-format +msgid "These examples use edges we created in " +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1531 +#, no-c-format +msgid "" +"SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology." +"GetEdgeByPoint('ma_topo',geom,0) As withnotol\n" +"FROM ST_GeomFromEWKT('SRID=26986;POINT(227622.6 893843)') As geom;\n" +" with1mtol | withnotol\n" +"-----------+-----------\n" +" 2 | 0" +msgstr "" +"SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology." +"GetEdgeByPoint('ma_topo',geom,0) As withnotol\n" +"FROM ST_GeomFromEWKT('SRID=26986;POINT(227622.6 893843)') As geom;\n" +" with1mtol | withnotol\n" +"-----------+-----------\n" +" 2 | 0" + +#. Tag: programlisting +#: extras_topology.xml:1532 +#, no-c-format +msgid "" +"SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As nearnode\n" +"FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n" +"\n" +"-- get error --\n" +"ERROR: Two or more edges found" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1539 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:1545 +#, no-c-format +msgid "GetFaceByPoint" +msgstr "GetFaceByPoint" + +#. Tag: refpurpose +#: extras_topology.xml:1546 +#, no-c-format +msgid "Find the face-id of a face that intersects a given point" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1550 +#, no-c-format +msgid "" +"integer GetFaceByPoint " +"varchar atopology " +"geometry apoint " +"float8 tol" +msgstr "" +"integer GetFaceByPoint " +"varchar atopology " +"geometry apoint " +"float8 tol" + +#. Tag: para +#: extras_topology.xml:1560 +#, no-c-format +msgid "Retrieve the id of a face that intersects a Point." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1561 +#, no-c-format +msgid "" +"The function returns an integer (id-face) given a topology, a POINT and a " +"tolerance. If tolerance = 0 then the point has to intersect the face." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1563 +#, no-c-format +msgid "If the point doesn't intersect a face, returns 0 (zero)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1564 +#, no-c-format +msgid "" +"If use tolerance > 0 and there is more than one face near the point then an " +"exception is thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1568 +#, no-c-format +msgid "" +"If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1575 +#, no-c-format +msgid "These examples use edges faces created in " +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1576 +#, no-c-format +msgid "" +"SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology." +"GetFaceByPoint('ma_topo',geom,0) As withnotol\n" +" FROM ST_GeomFromEWKT('POINT(234604.6 899382.0)') As geom;\n" +" \n" +" with1mtol | withnotol\n" +" -----------+-----------\n" +" 1 | 0" +msgstr "" +"SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology." +"GetFaceByPoint('ma_topo',geom,0) As withnotol\n" +" FROM ST_GeomFromEWKT('POINT(234604.6 899382.0)') As geom;\n" +" \n" +" with1mtol | withnotol\n" +" -----------+-----------\n" +" 1 | 0" + +#. Tag: programlisting +#: extras_topology.xml:1577 +#, no-c-format +msgid "" +"SELECT topology.GetFaceByPoint('ma_topo',geom, 1) As nearnode\n" +" FROM ST_GeomFromEWKT('POINT(227591.9 893900.4)') As geom;\n" +" \n" +"-- get error --\n" +"ERROR: Two or more faces found" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1582 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: extras_topology.xml:1588 +#, no-c-format +msgid "GetNodeByPoint" +msgstr "GetNodeByPoint" + +#. Tag: refpurpose +#: extras_topology.xml:1590 +#, no-c-format +msgid "Find the id of a node at a point location" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1595 +#, no-c-format +msgid "" +"integer GetNodeByPoint " +"varchar atopology " +"geometry point " +"float8 tol" +msgstr "" +"integer GetNodeByPoint " +"varchar atopology " +"geometry point " +"float8 tol" + +#. Tag: title +#: extras_topology.xml:1606 +#, no-c-format +msgid "Retrieve the id of a node at a point location" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1608 +#, no-c-format +msgid "" +"The function return an integer (id-node) given a topology, a POINT and a " +"tolerance. If tolerance = 0 mean exactly intersection otherwise retrieve the " +"node from an interval." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1609 +#, no-c-format +msgid "If there isn't a node at the point, it return 0 (zero)." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1610 +#, no-c-format +msgid "" +"If use tolerance > 0 and near the point there are more than one node it " +"throw an exception." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1615 +#, no-c-format +msgid "" +"If tolerance = 0, the function use ST_Intersects otherwise will use " +"ST_DWithin." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1625 +#, no-c-format +msgid "" +"SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode \n" +" FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n" +" nearnode\n" +"----------\n" +" 2" +msgstr "" +"SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode \n" +" FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n" +" nearnode\n" +"----------\n" +" 2" + +#. Tag: programlisting +#: extras_topology.xml:1626 +#, no-c-format +msgid "" +"SELECT topology.GetNodeByPoint('ma_topo',geom, 1000) As too_much_tolerance\n" +" FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;\n" +" \n" +" ----get error--\n" +" ERROR: Two or more nodes found" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1633 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:1639 +#, no-c-format +msgid "GetTopologyID" +msgstr "GetTopologyID" + +#. Tag: refpurpose +#: extras_topology.xml:1641 +#, no-c-format +msgid "" +"Returns the id of a topology in the topology.topology table " +"given the name of the topology." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1646 extras_topology.xml:1688 +#, no-c-format +msgid "" +"integer GetTopologyID " +"varchar toponame" +msgstr "" +"integer GetTopologyID " +"varchar toponame" + +#. Tag: para +#: extras_topology.xml:1656 +#, no-c-format +msgid "" +"Returns the id of a topology in the topology.topology table given the " +"name of the topology." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1664 +#, no-c-format +msgid "" +"SELECT topology.GetTopologyID('ma_topo') As topo_id;\n" +" topo_id\n" +"---------\n" +" 1" +msgstr "" +"SELECT topology.GetTopologyID('ma_topo') As topo_id;\n" +" topo_id\n" +"---------\n" +" 1" + +#. Tag: para +#: extras_topology.xml:1670 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" +", , , " +"" + +#. Tag: refname +#: extras_topology.xml:1681 +#, no-c-format +msgid "GetTopologySRID" +msgstr "GetTopologySRID" + +#. Tag: refpurpose +#: extras_topology.xml:1683 +#, no-c-format +msgid "" +"Returns the SRID of a topology in the topology.topology table given the name " +"of the topology." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1698 +#, no-c-format +msgid "" +"Returns the spatial reference id of a topology in the topology.topology " +"table given the name of the topology." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1706 +#, no-c-format +msgid "" +"SELECT topology.GetTopologySRID('ma_topo') As SRID;\n" +" SRID\n" +"-------\n" +" 4326" +msgstr "" +"SELECT topology.GetTopologySRID('ma_topo') As SRID;\n" +" SRID\n" +"-------\n" +" 4326" + +#. Tag: para +#: extras_topology.xml:1712 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" +", , , " +"" + +#. Tag: refname +#: extras_topology.xml:1723 +#, no-c-format +msgid "GetTopologyName" +msgstr "GetTopologyName" + +#. Tag: refpurpose +#: extras_topology.xml:1725 +#, no-c-format +msgid "Returns the name of a topology (schema) given the id of the topology." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1730 +#, no-c-format +msgid "" +"varchar GetTopologyName " +"integer topology_id" +msgstr "" +"varchar GetTopologyName " +"integer topology_id" + +#. Tag: para +#: extras_topology.xml:1740 +#, no-c-format +msgid "" +"Returns the topology name (schema) of a topology from the topology.topology " +"table given the topology id of the topology." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1748 +#, no-c-format +msgid "" +"SELECT topology.GetTopologyName(1) As topo_name;\n" +" topo_name\n" +"-----------\n" +" ma_topo" +msgstr "" +"SELECT topology.GetTopologyName(1) As topo_name;\n" +" topo_name\n" +"-----------\n" +" ma_topo" + +#. Tag: para +#: extras_topology.xml:1754 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: extras_topology.xml:1765 +#, no-c-format +msgid "ST_GetFaceEdges" +msgstr "ST_GetFaceEdges" + +#. Tag: refpurpose +#: extras_topology.xml:1767 +#, no-c-format +msgid "" +"Returns a set of ordered edges that bound aface includes " +"the sequence order." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1772 +#, no-c-format +msgid "" +"getfaceedges_returntype ST_GetFaceEdges varchar atopology integer aface" +msgstr "" +"getfaceedges_returntype ST_GetFaceEdges varchar atopology integer aface" + +#. Tag: para +#: extras_topology.xml:1783 +#, no-c-format +msgid "" +"Returns a set of ordered edges that bound aface includes " +"the sequence order. Each output consists of a sequence and edgeid. Sequence " +"numbers start with value 1." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1785 +#, no-c-format +msgid "" +"Enumeration of each ring edges start from the edge with smallest identifier." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1791 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1797 +#, no-c-format +msgid "" +"-- Returns the edges bounding face 1\n" +"SELECT (topology.ST_GetFaceEdges('tt', 1)).*;\n" +"-- result --\n" +" sequence | edge\n" +"----------+------\n" +" 1 | -4\n" +" 2 | 5\n" +" 3 | 7\n" +" 4 | -6\n" +" 5 | 1\n" +" 6 | 2\n" +" 7 | 3\n" +"(7 rows)" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1798 +#, no-c-format +msgid "" +"-- Returns the sequenc, edge id\n" +"-- , and geometry of the edges that bound face 1\n" +"-- If you just need geom and seq, can use ST_GetFaceGeometry\n" +"SELECT t.seq, t.edge, geom\n" +"FROM topology.ST_GetFaceEdges('tt',1) As t(seq,edge)\n" +" INNER JOIN tt.edge AS e ON abs(t.edge) = e.edge_id;" +msgstr "" + +#. Tag: para +#: extras_topology.xml:1804 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: extras_topology.xml:1814 +#, no-c-format +msgid "ST_GetFaceGeometry" +msgstr "ST_GetFaceGeometry" + +#. Tag: refpurpose +#: extras_topology.xml:1816 +#, no-c-format +msgid "Returns the polygon in the given topology with the specified face id." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1821 +#, no-c-format +msgid "" +"geometry ST_GetFaceGeometry " +"varchar atopology " +"integer aface" +msgstr "" +"geometry ST_GetFaceGeometry " +"varchar atopology " +"integer aface" + +#. Tag: para +#: extras_topology.xml:1832 +#, no-c-format +msgid "" +"Returns the polygon in the given topology with the specified face id. Builds " +"the polygon from the edges making up the face." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1837 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:1843 +#, no-c-format +msgid "" +"-- Returns the wkt of the polygon added with AddFace\n" +"SELECT ST_AsText(topology.ST_GetFaceGeometry('ma_topo', 1)) As facegeomwkt;\n" +"-- result --\n" +" facegeomwkt\n" +"\n" +"--------------------------------------------------------------------------------\n" +" POLYGON((234776.9 899563.7,234896.5 899456.7,234914 899436.4,234946.6 " +"899356.9,\n" +"234872.5 899328.7,234891 899285.4,234992.5 899145,234890.6 899069,\n" +"234755.2 899255.4,234612.7 899379.4,234776.9 899563.7))" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1855 +#, no-c-format +msgid "GetRingEdges" +msgstr "GetRingEdges" + +#. Tag: refpurpose +#: extras_topology.xml:1857 +#, no-c-format +msgid "Returns an ordered set of edges forming a ring with the given edge ." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1864 +#, no-c-format +msgid "" +"getfaceedges_returntype GetRingEdges " +"varchar atopology " +"integer aring " +"integer max_edges=null" +msgstr "" +"getfaceedges_returntype GetRingEdges " +"varchar atopology " +"integer aring " +"integer max_edges=null" + +#. Tag: para +#: extras_topology.xml:1876 +#, no-c-format +msgid "" +"Returns an ordered set of edges forming a ring with the given edge. Each " +"output consists of a sequence and a signed edge id. Sequence numbers start " +"with value 1. A negative edge identifier means that the given edge is taken " +"backward. You can pass a negative edge id to start walking backward." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1884 +#, no-c-format +msgid "" +"If max_edges is not null no more than those records are " +"returned by that function. This is meant to be a safety parameter when " +"dealing with possibly invalid topologies." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1899 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:1908 +#, no-c-format +msgid "GetNodeEdges" +msgstr "GetNodeEdges" + +#. Tag: refpurpose +#: extras_topology.xml:1910 +#, no-c-format +msgid "Returns an ordered set of edges incident to the given node." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1917 +#, no-c-format +msgid "" +"getfaceedges_returntype GetNodeEdges " +"varchar atopology " +"integer anode" +msgstr "" +"getfaceedges_returntype GetNodeEdges " +"varchar atopology " +"integer anode" + +#. Tag: para +#: extras_topology.xml:1928 +#, no-c-format +msgid "" +"Returns an ordered set of edges incident to the given node. Each output " +"consists of a sequence and a signed edge id. Sequence numbers start with " +"value 1. A positive edge starts at the given node. A negative edge ends into " +"the given node. Closed edges will appear twice (with both signs). Order is " +"clockwise starting from northbound." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1939 +#, no-c-format +msgid "" +"This function computes ordering rather than deriving from metadata and is " +"thus usable to build edge ring linking." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1952 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: para +#: extras_topology.xml:1965 +#, no-c-format +msgid "" +"This section covers the functions for processing topologies in non-standard " +"ways." +msgstr "" + +#. Tag: title +#: extras_topology.xml:1968 +#, no-c-format +msgid "Topology Processing" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:1971 +#, no-c-format +msgid "Polygonize" +msgstr "" + +#. Tag: refpurpose +#: extras_topology.xml:1972 +#, no-c-format +msgid "Find and register all faces defined by topology edges" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:1976 +#, no-c-format +msgid "" +"text Polygonize " +"varchar toponame" +msgstr "" +"text Polygonize " +"varchar toponame" + +#. Tag: para +#: extras_topology.xml:1986 +#, no-c-format +msgid "Register all faces that can be built out a topology edge primitives." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1987 +#, no-c-format +msgid "The target topology is assumed to contain no self-intersecting edges." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1988 +#, no-c-format +msgid "" +"Already known faces are recognized, so it is safe to call Polygonize " +"multiple times on the same topology." +msgstr "" + +#. Tag: para +#: extras_topology.xml:1989 extras_topology.xml:2142 +#, no-c-format +msgid "" +"This function does not use nor set the next_left_edge and next_right_edge " +"fields of the edge table." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2001 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:2007 +#, no-c-format +msgid "AddNode" +msgstr "AddNode" + +#. Tag: refpurpose +#: extras_topology.xml:2009 +#, no-c-format +msgid "" +"Adds a point node to the node table in the specified topology schema and " +"returns the nodeid of new node. If point already exists as node, the " +"existing nodeid is returned." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2014 +#, no-c-format +msgid "" +"integer AddNode " +"varchar toponame " +"geometry apoint " +"boolean " +"allowEdgeSplitting=false boolean computeContainingFace=false" +msgstr "" +"integer AddNode " +"varchar toponame " +"geometry apoint " +"boolean " +"allowEdgeSplitting=false boolean computeContainingFace=false" + +#. Tag: para +#: extras_topology.xml:2027 +#, no-c-format +msgid "" +"Adds a point node to the node table in the specified topology schema. The " +" function automatically adds start and end points " +"of an edge when called so not necessary to explicitly add nodes of an edge." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2034 +#, no-c-format +msgid "" +"If any edge crossing the node is found either an exception is raised or the " +"edge is splitted, depending on the allowEdgeSplitting " +"parameter value." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2040 +#, no-c-format +msgid "" +"If computeContainingFace is true a newly added node would " +"get the correct containing face computed." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2045 +#, no-c-format +msgid "" +"If the apoint geometry already exists as a node, the node " +"is not added but the existing nodeid is returned." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2054 +#, no-c-format +msgid "" +"SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 " +"893816.5)', 26986) ) As nodeid;\n" +"-- result --\n" +"nodeid\n" +"--------\n" +" 4" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:2066 +#, no-c-format +msgid "AddEdge" +msgstr "AddEdge" + +#. Tag: refpurpose +#: extras_topology.xml:2068 +#, no-c-format +msgid "" +"Adds a linestring edge to the edge table and associated start and end points " +"to the point nodes table of the specified topology schema using the " +"specified linestring geometry and returns the edgeid of the new (or " +"existing) edge." +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2073 +#, no-c-format +msgid "" +"integer AddEdge " +"varchar toponame " +"geometry aline" +msgstr "" +"integer AddEdge " +"varchar toponame " +"geometry aline" + +#. Tag: para +#: extras_topology.xml:2084 +#, no-c-format +msgid "" +"Adds an edge to the edge table and associated nodes to the nodes table of " +"the specified toponame schema using the specified " +"linestring geometry and returns the edgeid of the new or existing record. " +"The newly added edge has \"universe\" face on both sides and links to itself." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2086 +#, no-c-format +msgid "" +"If the aline geometry crosses, overlaps, contains or is " +"contained by an existing linestring edge, then an error is thrown and the " +"edge is not added." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2087 +#, no-c-format +msgid "" +"The geometry of aline must have the same srid as defined for the topology otherwise an invalid spatial reference " +"sys error will be thrown." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2091 +#, no-c-format +msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." +msgstr "Dostępność: 2.0.0 wymaga GEOS >= 3.3.0." + +#. Tag: programlisting +#: extras_topology.xml:2097 +#, no-c-format +msgid "" +"SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575.8 " +"893917.2,227591.9 893900.4)', 26986) ) As edgeid;\n" +"-- result-\n" +"edgeid\n" +"--------\n" +" 1\n" +" \n" +"SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227591.9 " +"893900.4,227622.6 893844.2,227641.6 893816.5,\n" +" 227704.5 893778.5)', 26986) ) As edgeid;\n" +"-- result --\n" +"edgeid\n" +"--------\n" +" 2\n" +" \n" +" SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227591.2 " +"893900, 227591.9 893900.4,\n" +" 227704.5 893778.5)', 26986) ) As edgeid;\n" +" -- gives error --\n" +" ERROR: Edge intersects (not on endpoints) with existing edge 1" +msgstr "" + +#. Tag: para +#: extras_topology.xml:2103 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: extras_topology.xml:2109 +#, no-c-format +msgid "AddFace" +msgstr "AddFace" + +#. Tag: refpurpose +#: extras_topology.xml:2111 +#, no-c-format +msgid "" +"Registers a face primitive to a topology and get it's identifier." +"" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2118 +#, no-c-format +msgid "" +"integer AddFace " +"varchar toponame " +"geometry apolygon " +"boolean force_new=false" +msgstr "" +"integer AddFace " +"varchar toponame " +"geometry apolygon " +"boolean force_new=false" + +#. Tag: para +#: extras_topology.xml:2130 +#, no-c-format +msgid "" +"Registers a face primitive to a topology and get it's identifier." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2134 +#, no-c-format +msgid "" +"For a newly added face, the edges forming its boundaries and the ones " +"contained in the face will be updated to have correct values in the " +"left_face and right_face fields. Isolated nodes contained in the face will " +"also be updated to have a correct containing_face field value." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2146 +#, no-c-format +msgid "" +"The target topology is assumed to be valid (containing no self-intersecting " +"edges). An exception is raised if: The polygon boundary is not fully defined " +"by existing edges or the polygon overlaps an existing face." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2148 +#, no-c-format +msgid "" +"If the apolygon geometry already exists as a face, then: " +"if force_new is false (the default) the face id of the " +"existing face is returned; if force_new is true a new id " +"will be assigned to the newly registered face." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2156 +#, no-c-format +msgid "" +"When a new registration of an existing face is performed (force_new=true), " +"no action will be taken to resolve dangling references to the existing face " +"in the edge, node an relation tables, nor will the MBR field of the existing " +"face record be updated. It is up to the caller to deal with that." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2163 +#, no-c-format +msgid "" +"The apolygon geometry must have the same srid as defined for the topology otherwise an invalid spatial reference " +"sys error will be thrown." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2172 +#, no-c-format +msgid "" +"-- first add the edges we use generate_series as an iterator (the below \n" +"-- will only work for polygons with < 10000 points because of our max in " +"gs) \n" +"SELECT topology.AddEdge('ma_topo', ST_MakeLine(ST_PointN(geom,i), " +"ST_PointN(geom, i + 1) )) As edgeid\n" +" FROM (SELECT ST_NPoints(geom) AS npt, geom\n" +" FROM \n" +" (SELECT ST_Boundary(ST_GeomFromText('POLYGON((234896.5 " +"899456.7,234914 899436.4,234946.6 899356.9,234872.5 899328.7,\n" +" 234891 899285.4,234992.5 899145, 234890.6 899069,234755.2 " +"899255.4,\n" +" 234612.7 899379.4,234776.9 899563.7,234896.5 899456.7))', " +"26986) ) As geom\n" +" ) As geoms) As facen CROSS JOIN generate_series(1,10000) As i\n" +" WHERE i < npt;\n" +"-- result --\n" +" edgeid\n" +"--------\n" +" 3\n" +" 4\n" +" 5\n" +" 6\n" +" 7\n" +" 8\n" +" 9\n" +" 10\n" +" 11\n" +" 12\n" +"(10 rows)\n" +"-- then add the face -\n" +" \n" +"SELECT topology.AddFace('ma_topo', \n" +" ST_GeomFromText('POLYGON((234896.5 899456.7,234914 899436.4,234946.6 " +"899356.9,234872.5 899328.7,\n" +" 234891 899285.4,234992.5 899145, 234890.6 899069,234755.2 899255.4,\n" +" 234612.7 899379.4,234776.9 899563.7,234896.5 899456.7))', 26986) ) As " +"faceid;\n" +"-- result --\n" +"faceid\n" +"--------\n" +" 1" +msgstr "" + +#. Tag: para +#: extras_topology.xml:2178 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: para +#: extras_topology.xml:2188 +#, no-c-format +msgid "" +"This section covers the topology functions for creating new topogeometries." +msgstr "" + +#. Tag: title +#: extras_topology.xml:2191 +#, no-c-format +msgid "TopoGeometry Constructors" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:2194 +#, no-c-format +msgid "CreateTopoGeom" +msgstr "CreateTopoGeom" + +#. Tag: refpurpose +#: extras_topology.xml:2196 +#, no-c-format +msgid "" +"Creates a new topo geometry object from topo element array - tg_type: 1:" +"[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection" +msgstr "" + +#. Tag: funcsynopsis +#: extras_topology.xml:2200 +#, no-c-format +msgid "" +" topogeometry CreateTopoGeom varchar toponame integer tg_type integer layer_id topoelementarray tg_objs topogeometry " +"CreateTopoGeom varchar toponame integer tg_type integer layer_id " +msgstr "" +" topogeometry CreateTopoGeom varchar toponame integer tg_type integer layer_id topoelementarray tg_objs topogeometry " +"CreateTopoGeom varchar toponame integer tg_type integer layer_id " + +#. Tag: para +#: extras_topology.xml:2221 extras_topology.xml:2283 +#, no-c-format +msgid "" +"Creates a topogeometry object for layer denoted by layer_id and registers it " +"in the relations table in the toponame schema." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2222 +#, no-c-format +msgid "" +"tg_type is an integer: 1:[multi]point (punctal), 2:[multi]line (lineal), 3:" +"[multi]poly (areal), 4:collection. layer_id is the layer id in the topology." +"layer table." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2223 +#, no-c-format +msgid "" +"punctal layers are formed from set of nodes, lineal layers are formed from a " +"set of edges, areal layers are formed from a set of faces, and collections " +"can be formed from a mixture of nodes, edges, and faces." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2225 +#, no-c-format +msgid "" +"Omitting the array of components generates an empty TopoGeometry object." +msgstr "" + +#. Tag: title +#: extras_topology.xml:2232 +#, no-c-format +msgid "Examples: Form from existing edges" +msgstr "" + +#. Tag: para +#: extras_topology.xml:2233 +#, no-c-format +msgid "" +"Create a topogeom in ri_topo schema for layer 2 (our ri_roads), of type (2) " +"LINE, for the first edge (we loaded in ST_CreateTopoGeo." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2234 +#, no-c-format +msgid "" +"INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology." +"CreateTopoGeom('ri_topo',2,2,'{{1,2}}'::topology.topoelementarray);" +msgstr "" +"INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology." +"CreateTopoGeom('ri_topo',2,2,'{{1,2}}'::topology.topoelementarray);" + +#. Tag: title +#: extras_topology.xml:2239 +#, no-c-format +msgid "Examples: Convert an areal geometry to best guess topogeometry" +msgstr "" + +#. Tag: para +#: extras_topology.xml:2240 +#, no-c-format +msgid "" +"Lets say we have geometries that should be formed from a collection of " +"faces. We have for example blockgroups table and want to know the topo " +"geometry of each block group. If our data was perfectly aligned, we could do " +"this:" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2242 +#, no-c-format +msgid "" +"-- create our topo geometry column --\n" +"SELECT topology.AddTopoGeometryColumn(\n" +" 'topo_boston', \n" +" 'boston', 'blockgroups', 'topo', 'POLYGON');\n" +" \n" +"-- addtopgeometrycolumn --\n" +"1\n" +" \n" +"-- update our column assuming \n" +"-- everything is perfectly aligned with our edges\n" +"UPDATE boston.blockgroups AS bg\n" +" SET topo = topology.CreateTopoGeom('topo_boston'\n" +" ,3,1\n" +" , foo.bfaces)\n" +"FROM (SELECT b.gid, topology.TopoElementArray_Agg(ARRAY[f.face_id,3]) As " +"bfaces\n" +" FROM boston.blockgroups As b\n" +" INNER JOIN topo_boston.face As f ON b.geom && f.mbr\n" +" WHERE ST_Covers(b.geom, topology.ST_GetFaceGeometry('topo_boston', f." +"face_id))\n" +" GROUP BY b.gid) As foo\n" +"WHERE foo.gid = bg.gid;" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2244 +#, no-c-format +msgid "" +"--the world is rarely perfect allow for some error\n" +"--count the face if 50% of it falls \n" +"-- within what we think is our blockgroup boundary\n" +"UPDATE boston.blockgroups AS bg\n" +" SET topo = topology.CreateTopoGeom('topo_boston'\n" +" ,3,1\n" +" , foo.bfaces)\n" +"FROM (SELECT b.gid, topology.TopoElementArray_Agg(ARRAY[f.face_id,3]) As " +"bfaces\n" +" FROM boston.blockgroups As b\n" +" INNER JOIN topo_boston.face As f ON b.geom && f.mbr\n" +" WHERE ST_Covers(b.geom, topology.ST_GetFaceGeometry('topo_boston', f." +"face_id))\n" +" OR\n" +" ( ST_Intersects(b.geom, topology.ST_GetFaceGeometry('topo_boston', f." +"face_id))\n" +" AND ST_Area(ST_Intersection(b.geom, topology." +"ST_GetFaceGeometry('topo_boston', f.face_id) ) ) > \n" +" ST_Area(topology.ST_GetFaceGeometry('topo_boston', f." +"face_id))*0.5\n" +" )\n" +" GROUP BY b.gid) As foo\n" +"WHERE foo.gid = bg.gid; \n" +"\n" +"-- and if we wanted to convert our topogeometry back\n" +"-- to a denomalized geometry aligned with our faces and edges \n" +"-- cast the topo to a geometry\n" +"-- The really cool thing is my new geometries\n" +"-- are now aligned with my tiger street centerlines\n" +"UPDATE boston.blockgroups SET new_geom = topo::geometry;" +msgstr "" + +#. Tag: para +#: extras_topology.xml:2250 +#, no-c-format +msgid "" +", , , , " +"" +msgstr "" +", , , , " +"" + +#. Tag: refname +#: extras_topology.xml:2263 +#, no-c-format +msgid "toTopoGeom" +msgstr "toTopoGeom" + +#. Tag: refpurpose +#: extras_topology.xml:2265 +#, no-c-format +msgid "Creates a new topo geometry from a simple geometry" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2270 +#, no-c-format +msgid "" +"topogeometry toTopoGeom " +"geometry geom " +"varchar toponame " +"integer layer_id " +"float8 tolerance" +msgstr "" +"topogeometry toTopoGeom " +"geometry geom " +"varchar toponame " +"integer layer_id " +"float8 tolerance" + +#. Tag: para +#: extras_topology.xml:2287 +#, no-c-format +msgid "" +"Topological primitives required to represent the input geometry will be " +"added, possibly splitting existing ones. Pre-existing TopoGeometry objects " +"will retain their shapes." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2292 +#, no-c-format +msgid "" +"When tolerance is given it will be used to snap the input " +"geometry to existing primitives." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2301 +#, no-c-format +msgid "This is a full self-contained workflow" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2302 +#, no-c-format +msgid "" +"-- do this if you don't have a topology setup already\n" +"-- creates topology not allowing any tolerance\n" +"SELECT topology.CreateTopology('topo_boston_test', 2249);\n" +"-- create a new table\n" +"CREATE TABLE nei_topo(gid serial primary key, nei varchar(30));\n" +"--add a topogeometry column to it\n" +"SELECT topology.AddTopoGeometryColumn('topo_boston_test', 'public', " +"'nei_topo', 'topo', 'MULTIPOLYGON') As new_layer_id;\n" +"new_layer_id\n" +"-----------\n" +"1\n" +"\n" +"--use new layer id in populating the new topogeometry column\n" +"-- we add the topogeoms to the new layer with 0 tolerance\n" +"INSERT INTO nei_topo(nei, topo)\n" +"SELECT nei, topology.toTopoGeom(geom, 'topo_boston_test', 1)\n" +"FROM neighborhoods\n" +"WHERE gid BETWEEN 1 and 15;\n" +"\n" +"--use to verify what has happened --\n" +"SELECT * FROM \n" +" topology.TopologySummary('topo_boston_test'); \n" +" \n" +"-- summary--\n" +"Topology topo_boston_test (5), SRID 2249, precision 0\n" +"61 nodes, 87 edges, 35 faces, 15 topogeoms in 1 layers\n" +"Layer 1, type Polygonal (3), 15 topogeoms\n" +" Deploy: public.nei_topo.topo" +msgstr "" + +#. Tag: para +#: extras_topology.xml:2308 +#, no-c-format +msgid "" +",, , " +msgstr "" +",, , " + +#. Tag: refname +#: extras_topology.xml:2315 +#, no-c-format +msgid "TopoElementArray_Agg" +msgstr "TopoElementArray_Agg" + +#. Tag: refpurpose +#: extras_topology.xml:2316 +#, no-c-format +msgid "" +"Returns a topoelementarray for a set of element_id, type " +"arrays (topoelements)" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2321 +#, no-c-format +msgid "" +"topoelementarray TopoElementArray_Agg topoelement set tefield" +msgstr "" +"topoelementarray TopoElementArray_Agg topoelement set tefield" + +#. Tag: para +#: extras_topology.xml:2331 +#, no-c-format +msgid "" +"Used to create a from a set of ." +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2340 +#, no-c-format +msgid "" +"SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n" +" FROM generate_series(1,3) As e CROSS JOIN generate_series(1,4) As t;\n" +" tea\n" +"--------------------------------------------------------------------------\n" +"{{1,1},{1,2},{1,3},{1,4},{2,1},{2,2},{2,3},{2,4},{3,1},{3,2},{3,3},{3,4}}" +msgstr "" +"SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea\n" +" FROM generate_series(1,3) As e CROSS JOIN generate_series(1,4) As t;\n" +" tea\n" +"--------------------------------------------------------------------------\n" +"{{1,1},{1,2},{1,3},{1,4},{2,1},{2,2},{2,3},{2,4},{3,1},{3,2},{3,3},{3,4}}" + +#. Tag: para +#: extras_topology.xml:2344 extras_topology.xml:2397 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: title +#: extras_topology.xml:2350 +#, no-c-format +msgid "TopoGeometry Accessors" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:2354 +#, no-c-format +msgid "GetTopoGeomElementArray" +msgstr "GetTopoGeomElementArray" + +#. Tag: refpurpose +#: extras_topology.xml:2356 +#, no-c-format +msgid "" +"Returns a topoelementarray (an array of topoelements) " +"containing the topological elements and type of the given TopoGeometry " +"(primitive elements)" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2361 +#, no-c-format +msgid "" +"topoelementarray GetTopoGeomElementArray varchar toponame integer layer_id integer tg_id" +msgstr "" +"topoelementarray GetTopoGeomElementArray varchar toponame integer layer_id integer tg_id" + +#. Tag: funcprototype +#: extras_topology.xml:2369 +#, no-c-format +msgid "" +"topoelementarray topoelement GetTopoGeomElementArray topogeometry tg" +msgstr "" +"topoelementarray topoelement GetTopoGeomElementArray topogeometry tg" + +#. Tag: para +#: extras_topology.xml:2379 +#, no-c-format +msgid "" +"Returns a containing the topological " +"elements and type of the given TopoGeometry (primitive elements). This is " +"similar to GetTopoGeomElements except it returns the elements as an array " +"rather than as a dataset." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2381 extras_topology.xml:2428 +#, no-c-format +msgid "" +"tg_id is the topogeometry id of the topogeometry object in the topology in " +"the layer denoted by layer_id in the topology.layer table." +msgstr "" + +#. Tag: refname +#: extras_topology.xml:2402 +#, no-c-format +msgid "GetTopoGeomElements" +msgstr "GetTopoGeomElements" + +#. Tag: refpurpose +#: extras_topology.xml:2404 +#, no-c-format +msgid "" +"Returns a set of topoelement objects containing the " +"topological element_id,element_type of the given TopoGeometry (primitive " +"elements)" +msgstr "" + +#. Tag: funcprototype +#: extras_topology.xml:2409 +#, no-c-format +msgid "" +"setof topoelement GetTopoGeomElements varchar toponame integer layer_id integer tg_id" +msgstr "" +"setof topoelement GetTopoGeomElements varchar toponame integer layer_id integer tg_id" + +#. Tag: funcprototype +#: extras_topology.xml:2417 +#, no-c-format +msgid "" +"setof topoelement GetTopoGeomElements topogeometry tg" +msgstr "" +"setof topoelement GetTopoGeomElements topogeometry tg" + +#. Tag: para +#: extras_topology.xml:2427 +#, no-c-format +msgid "" +"Returns a set of element_id,element_type (topoelements) for a given " +"topogeometry object in toponame schema." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2444 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: title +#: extras_topology.xml:2451 +#, no-c-format +msgid "TopoGeometry Outputs" +msgstr "" + +#. Tag: refname +#: extras_topology.xml:2454 +#, no-c-format +msgid "AsGML" +msgstr "AsGML" + +#. Tag: refpurpose +#: extras_topology.xml:2456 +#, no-c-format +msgid "Returns the GML representation of a topogeometry." +msgstr "" + +#. Tag: funcsynopsis +#: extras_topology.xml:2460 +#, no-c-format +msgid "" +" text AsGML " +"topogeometry tg text AsGML topogeometry tg text nsprefix_in text AsGML topogeometry tg regclass " +"visitedTable " +" text AsGML " +"topogeometry tg " +"regclass visitedTable text nsprefix text AsGML topogeometry tg text nsprefix_in integer precision integer options text " +"AsGML topogeometry " +"tg text " +"nsprefix_in integer precision integer options regclass visitedTable " +" text AsGML " +"topogeometry tg " +"text nsprefix_in " +"integer precision " +"integer options " +"regclass visitedTable text idprefix text AsGML topogeometry tg text nsprefix_in integer precision integer options regclass " +"visitedTable text " +"idprefix int " +"gmlversion " +msgstr "" +" text AsGML " +"topogeometry tg text AsGML topogeometry tg text nsprefix_in text AsGML topogeometry tg regclass " +"visitedTable " +" text AsGML " +"topogeometry tg " +"regclass visitedTable text nsprefix text AsGML topogeometry tg text nsprefix_in integer precision integer options text " +"AsGML topogeometry " +"tg text " +"nsprefix_in integer precision integer options regclass visitedTable " +" text AsGML " +"topogeometry tg " +"text nsprefix_in " +"integer precision " +"integer options " +"regclass visitedTable text idprefix text AsGML topogeometry tg text nsprefix_in integer precision integer options regclass " +"visitedTable text " +"idprefix int " +"gmlversion " + +#. Tag: para +#: extras_topology.xml:2521 +#, no-c-format +msgid "" +"Returns the GML representation of a topogeometry in version GML3 format. If " +"no nsprefix_in is specified then gml " +"is used. Pass in an empty string for nsprefix to get a non-qualified name " +"space. The precision (default: 15) and options (default 1) parameters, if " +"given, are passed untouched to the underlying call to ST_AsGML." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2523 +#, no-c-format +msgid "" +"The visitedTable parameter, if given, is used for keeping " +"track of the visited Node and Edge elements so to use cross-references " +"(xlink:xref) rather than duplicating definitions. The table is expected to " +"have (at least) two integer fields: 'element_type' and 'element_id'. The " +"calling user must have both read and write privileges on the given table. " +"For best performance, an index should be defined on element_type and element_id, in that order. Such index would " +"be created automatically by adding a unique constraint to the fields. " +"Example:" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2529 +#, no-c-format +msgid "" +"CREATE TABLE visited (\n" +" element_type integer, element_id integer,\n" +" unique(element_type, element_id)\n" +");" +msgstr "" +"CREATE TABLE visited (\n" +" element_type integer, element_id integer,\n" +" unique(element_type, element_id)\n" +");" + +#. Tag: para +#: extras_topology.xml:2532 +#, no-c-format +msgid "" +"The idprefix parameter, if given, will be prepended to " +"Edge and Node tag identifiers." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2534 +#, no-c-format +msgid "" +"The gmlver parameter, if given, will be passed to the " +"underlying ST_AsGML. Defaults to 3." +msgstr "" + +#. Tag: para +#: extras_topology.xml:2543 +#, no-c-format +msgid "" +"This uses the topo geometry we created in " +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2544 +#, no-c-format +msgid "" +"SELECT topology.AsGML(topo) As rdgml \n" +" FROM ri.roads \n" +" WHERE road_name = 'Unknown';\n" +" \n" +"-- rdgml--\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 384744 236928 " +"384750 236923 384769 236911 384799 236895 384811 236890 \n" +" 384833 236884 384844 236882 384866 236881 384879 " +"236883 384954 236898 385087 236932 385117 236938 \n" +" 385167 236938 385203 236941 385224 236946 385233 " +"236950 385241 236956 385254 236971 \n" +" 385260 236979 385268 236999 385273 237018 385273 " +"237037 385271 237047 385267 237057 385225 237125 \n" +" 385210 237144 385192 237161 385167 237192 385162 " +"237202 385159 237214 385159 237227 385162 237241 \n" +" 385166 237256 385196 237324 385209 237345 385234 " +"237375 385237 237383 385238 237399 385236 237407 \n" +" 385227 237419 385213 237430 385193 237439 385174 " +"237451 385170 237455 385169 237460 385171 237475 \n" +" 385181 237503 385190 237521 385200 237533 385206 " +"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n" +" 385249 237544 385260 237555 385270 237570 385289 " +"237584 385292 237589 385291 237596 385284 237630\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +"]]>" +msgstr "" +"SELECT topology.AsGML(topo) As rdgml \n" +" FROM ri.roads \n" +" WHERE road_name = 'Unknown';\n" +" \n" +"-- rdgml--\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 384744 236928 " +"384750 236923 384769 236911 384799 236895 384811 236890 \n" +" 384833 236884 384844 236882 384866 236881 384879 " +"236883 384954 236898 385087 236932 385117 236938 \n" +" 385167 236938 385203 236941 385224 236946 385233 " +"236950 385241 236956 385254 236971 \n" +" 385260 236979 385268 236999 385273 237018 385273 " +"237037 385271 237047 385267 237057 385225 237125 \n" +" 385210 237144 385192 237161 385167 237192 385162 " +"237202 385159 237214 385159 237227 385162 237241 \n" +" 385166 237256 385196 237324 385209 237345 385234 " +"237375 385237 237383 385238 237399 385236 237407 \n" +" 385227 237419 385213 237430 385193 237439 385174 " +"237451 385170 237455 385169 237460 385171 237475 \n" +" 385181 237503 385190 237521 385200 237533 385206 " +"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n" +" 385249 237544 385260 237555 385270 237570 385289 " +"237584 385292 237589 385291 237596 385284 237630\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +"]]>" + +#. Tag: para +#: extras_topology.xml:2545 +#, no-c-format +msgid "Same exercise as previous without namespace" +msgstr "" + +#. Tag: programlisting +#: extras_topology.xml:2546 +#, no-c-format +msgid "" +"SELECT topology.AsGML(topo,'') As rdgml \n" +" FROM ri.roads \n" +" WHERE road_name = 'Unknown';\n" +" \n" +"-- rdgml--\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 384744 236928 384750 " +"236923 384769 236911 384799 236895 384811 236890 \n" +" 384833 236884 384844 236882 384866 236881 384879 " +"236883 384954 236898 385087 236932 385117 236938 \n" +" 385167 236938 385203 236941 385224 236946 385233 " +"236950 385241 236956 385254 236971 \n" +" 385260 236979 385268 236999 385273 237018 385273 " +"237037 385271 237047 385267 237057 385225 237125 \n" +" 385210 237144 385192 237161 385167 237192 385162 " +"237202 385159 237214 385159 237227 385162 237241 \n" +" 385166 237256 385196 237324 385209 237345 385234 " +"237375 385237 237383 385238 237399 385236 237407 \n" +" 385227 237419 385213 237430 385193 237439 385174 " +"237451 385170 237455 385169 237460 385171 237475 \n" +" 385181 237503 385190 237521 385200 237533 385206 " +"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n" +" 385249 237544 385260 237555 385270 237570 385289 " +"237584 385292 237589 385291 237596 385284 237630\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +"]]>" +msgstr "" +"SELECT topology.AsGML(topo,'') As rdgml \n" +" FROM ri.roads \n" +" WHERE road_name = 'Unknown';\n" +" \n" +"-- rdgml--\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 384744 236928 384750 " +"236923 384769 236911 384799 236895 384811 236890 \n" +" 384833 236884 384844 236882 384866 236881 384879 " +"236883 384954 236898 385087 236932 385117 236938 \n" +" 385167 236938 385203 236941 385224 236946 385233 " +"236950 385241 236956 385254 236971 \n" +" 385260 236979 385268 236999 385273 237018 385273 " +"237037 385271 237047 385267 237057 385225 237125 \n" +" 385210 237144 385192 237161 385167 237192 385162 " +"237202 385159 237214 385159 237227 385162 237241 \n" +" 385166 237256 385196 237324 385209 237345 385234 " +"237375 385237 237383 385238 237399 385236 237407 \n" +" 385227 237419 385213 237430 385193 237439 385174 " +"237451 385170 237455 385169 237460 385171 237475 \n" +" 385181 237503 385190 237521 385200 237533 385206 " +"237538 385213 237541 385221 237542 385235 237540 385242 237541 \n" +" 385249 237544 385260 237555 385270 237570 385289 " +"237584 385292 237589 385291 237596 385284 237630\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +"]]>" + +#. Tag: para +#: extras_topology.xml:2552 +#, no-c-format +msgid ", " +msgstr ", " diff --git a/doc/po/pl/faq.xml.po b/doc/po/pl/faq.xml.po new file mode 100644 index 000000000..36068ac58 --- /dev/null +++ b/doc/po/pl/faq.xml.po @@ -0,0 +1,669 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: faq.xml:3 +#, no-c-format +msgid "PostGIS Frequently Asked Questions" +msgstr "" + +#. Tag: para +#: faq.xml:8 +#, no-c-format +msgid "" +"My applications and desktop tools worked with PostGIS 1.5,but they don't " +"work with PostGIS 2.0. How do I fix this?" +msgstr "" + +#. Tag: para +#: faq.xml:12 +#, no-c-format +msgid "" +"A lot of deprecated functions were removed from the PostGIS code base in " +"PostGIS 2.0. This has affected applications in addition to third-party tools " +"such as Geoserver, MapServer, QuantumGIS, and OpenJump to name a few. There " +"are a couple of ways to resolve this. For the third-party apps, you can try " +"to upgrade to the latest versions of these which have many of these issues " +"fixed. For your own code, you can change your code to not use the functions " +"removed. Most of these functions are non ST_ aliases of ST_Union, ST_Length " +"etc. and as a last resort, install the whole of legacy.sql or just the portions of legacy.sql you need." +msgstr "" + +#. Tag: para +#: faq.xml:18 +#, no-c-format +msgid "" +"The legacy.sql file is located in the same folder as " +"postgis.sql. You can install this file after you have installed postgis.sql " +"and spatial_ref_sys.sql to get back all the 200 some-odd old functions we " +"removed." +msgstr "" + +#. Tag: para +#: faq.xml:24 +#, no-c-format +msgid "" +"I'm running PostgreSQL 9.0 and I can no longer read/view geometries in " +"OpenJump, Safe FME, and some other tools?" +msgstr "" + +#. Tag: para +#: faq.xml:28 +#, no-c-format +msgid "" +"In PostgreSQL 9.0+, the default encoding for bytea data has been changed to " +"hex and older JDBC drivers still assume escape format. This has affected " +"some applications such as Java applications using older JDBC drivers or .NET " +"applications that use the older npgsql driver that expect the old behavior " +"of ST_AsBinary. There are two approaches to getting this to work again." +msgstr "" + +#. Tag: para +#: faq.xml:32 +#, no-c-format +msgid "" +"You can upgrade your JDBC driver to the latest PostgreSQL 9.0 version which " +"you can get from http://jdbc.postgresql.org/download.html" +msgstr "" + +#. Tag: para +#: faq.xml:34 +#, no-c-format +msgid "" +"If you are running a .NET app, you can use Npgsql 2.0.11 or higher which you " +"can download from http://pgfoundry.org/frs/?group_id=1000140 and as " +"described on Francisco Figueiredo's NpgSQL 2.0.11 released blog entry" +msgstr "" + +#. Tag: para +#: faq.xml:38 +#, no-c-format +msgid "" +"If upgrading your PostgreSQL driver is not an option, then you can set the " +"default back to the old behavior with the following change:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:39 +#, no-c-format +msgid "ALTER DATABASE mypostgisdb SET bytea_output='escape';" +msgstr "" + +#. Tag: para +#: faq.xml:46 +#, no-c-format +msgid "" +"I tried to use PgAdmin to view my geometry column and it is blank, what " +"gives?" +msgstr "" + +#. Tag: para +#: faq.xml:50 +#, no-c-format +msgid "" +"PgAdmin doesn't show anything for large geometries. The best ways to verify " +"you do have data in your geometry columns are?" +msgstr "" + +#. Tag: programlisting +#: faq.xml:53 +#, no-c-format +msgid "" +"-- this should return no records if all your geom fields are filled " +"in \n" +"SELECT somefield FROM mytable WHERE geom IS NULL;" +msgstr "" + +#. Tag: programlisting +#: faq.xml:55 +#, no-c-format +msgid "" +"-- To tell just how large your geometry is do a query of the form\n" +"--which will tell you the most number of points you have in any of your " +"geometry columns\n" +"SELECT MAX(ST_NPoints(geom)) FROM sometable;" +msgstr "" + +#. Tag: para +#: faq.xml:61 +#, no-c-format +msgid "What kind of geometric objects can I store?" +msgstr "" + +#. Tag: para +#: faq.xml:65 +#, no-c-format +msgid "" +"You can store point, line, polygon, multipoint, multiline, multipolygon, and " +"geometrycollections. In PostGIS 2.0 and above you can also store TINS and " +"Polyhedral Surfaces in the basic geometry type. These are specified in the " +"Open GIS Well Known Text Format (with XYZ,XYM,XYZM extensions). There are " +"three data types currently supported. The standard OGC geometry data type " +"which uses a planar coordinate system for measurement, the geography data " +"type which uses a geodetic coordinate system (not OGC, but you'll find a " +"similar type in Microsoft SQL Server 2008+). Only WGS 84 long lat " +"(SRID:4326) is supported by the geography data type. The newest family " +"member of the PostGIS spatial type family is raster for storing and " +"analyzing raster data. Raster has its very own FAQ. Refer to and for more details." +msgstr "" + +#. Tag: para +#: faq.xml:78 +#, no-c-format +msgid "I'm all confused. Which data store should I use geometry or geography?" +msgstr "" + +#. Tag: para +#: faq.xml:82 +#, no-c-format +msgid "" +"Short Answer: geography is a new data type that supports long range " +"distances measurements, but most computations on it are currently slower " +"than they are on geometry. If you use geography -- you don't need to learn " +"much about planar coordinate systems. Geography is generally best if all you " +"care about is measuring distances and lengths and you have data from all " +"over the world. Geometry data type is an older data type that has many more " +"functions supporting it, enjoys greater support from third party tools, and " +"operations on it are generally faster -- sometimes as much as 10 fold faster " +"for larger geometries. Geometry is best if you are pretty comfortable with " +"spatial reference systems or you are dealing with localized data where all " +"your data fits in a single spatial " +"reference system (SRID), or you need to do a lot of spatial " +"processing. Note: It is fairly easy to do one-off conversions between the " +"two types to gain the benefits of each. Refer to to see what is currently supported and what " +"is not." +msgstr "" + +#. Tag: para +#: faq.xml:93 +#, no-c-format +msgid "" +"Long Answer: Refer to our more lengthy discussion in the and function type matrix." +msgstr "" + +#. Tag: para +#: faq.xml:101 +#, no-c-format +msgid "" +"I have more intense questions about geography, such as how big of a " +"geographic region can I stuff in a geography column and still get reasonable " +"answers. Are there limitations such as poles, everything in the field must " +"fit in a hemisphere (like SQL Server 2008 has), speed etc?" +msgstr "" + +#. Tag: para +#: faq.xml:105 +#, no-c-format +msgid "" +"Your questions are too deep and complex to be adequately answered in this " +"section. Please refer to our ." +msgstr "" + +#. Tag: para +#: faq.xml:112 +#, no-c-format +msgid "How do I insert a GIS object into the database?" +msgstr "" + +#. Tag: para +#: faq.xml:116 +#, no-c-format +msgid "" +"First, you need to create a table with a column of type \"geometry\" or " +"\"geography\" to hold your GIS data. Storing geography type data is a little " +"different than storing geometry. Refer to for details on storing geography." +msgstr "" + +#. Tag: para +#: faq.xml:120 +#, no-c-format +msgid "" +"For geometry: Connect to your database with psql and " +"try the following SQL:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:124 +#, no-c-format +msgid "" +"CREATE TABLE gtest ( ID int4, NAME varchar(20) );\n" +"SELECT AddGeometryColumn('', 'gtest','geom',-1,'LINESTRING',2);" +msgstr "" + +#. Tag: para +#: faq.xml:126 +#, no-c-format +msgid "" +"If the geometry column addition fails, you probably have not loaded the " +"PostGIS functions and objects into this database. See the ." +msgstr "" + +#. Tag: para +#: faq.xml:130 +#, no-c-format +msgid "" +"Then, you can insert a geometry into the table using a SQL insert statement. " +"The GIS object itself is formatted using the OpenGIS Consortium \"well-known " +"text\" format:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:134 +#, no-c-format +msgid "" +"INSERT INTO gtest (ID, NAME, GEOM) \n" +"VALUES (\n" +" 1, \n" +" 'First Geometry', \n" +" ST_GeomFromText('LINESTRING(2 3,4 5,6 5,7 8)', -1)\n" +");" +msgstr "" + +#. Tag: para +#: faq.xml:136 +#, no-c-format +msgid "" +"For more information about other GIS objects, see the object reference." +msgstr "" + +#. Tag: para +#: faq.xml:139 +#, no-c-format +msgid "To view your GIS data in the table:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:141 +#, no-c-format +msgid "SELECT id, name, ST_AsText(geom) AS geom FROM gtest;" +msgstr "" + +#. Tag: para +#: faq.xml:143 +#, no-c-format +msgid "The return value should look something like this:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:145 +#, no-c-format +msgid "" +"id | name | geom\n" +"----+----------------+-----------------------------\n" +" 1 | First Geometry | LINESTRING(2 3,4 5,6 5,7 8) \n" +"(1 row)" +msgstr "" + +#. Tag: para +#: faq.xml:151 +#, no-c-format +msgid "How do I construct a spatial query?" +msgstr "" + +#. Tag: para +#: faq.xml:155 +#, no-c-format +msgid "" +"The same way you construct any other database query, as an SQL combination " +"of return values, functions, and boolean tests." +msgstr "" + +#. Tag: para +#: faq.xml:158 +#, no-c-format +msgid "" +"For spatial queries, there are two issues that are important to keep in mind " +"while constructing your query: is there a spatial index you can make use of; " +"and, are you doing expensive calculations on a large number of geometries." +msgstr "" + +#. Tag: para +#: faq.xml:163 +#, no-c-format +msgid "" +"In general, you will want to use the \"intersects operator\" (&&) " +"which tests whether the bounding boxes of features intersect. The reason the " +"&& operator is useful is because if a spatial index is available to " +"speed up the test, the && operator will make use of this. This can " +"make queries much much faster." +msgstr "" + +#. Tag: para +#: faq.xml:170 +#, no-c-format +msgid "" +"You will also make use of spatial functions, such as Distance(), " +"ST_Intersects(), ST_Contains() and ST_Within(), among others, to narrow down " +"the results of your search. Most spatial queries include both an indexed " +"test and a spatial function test. The index test serves to limit the number " +"of return tuples to only tuples that might meet the " +"condition of interest. The spatial functions are then use to test the " +"condition exactly." +msgstr "" + +#. Tag: programlisting +#: faq.xml:178 +#, no-c-format +msgid "" +"SELECT id, the_geom \n" +"FROM thetable \n" +"WHERE \n" +" ST_Contains(the_geom,'POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))');" +msgstr "" + +#. Tag: para +#: faq.xml:184 +#, no-c-format +msgid "How do I speed up spatial queries on large tables?" +msgstr "" + +#. Tag: para +#: faq.xml:188 +#, no-c-format +msgid "" +"Fast queries on large tables is the raison d'etre of " +"spatial databases (along with transaction support) so having a good index is " +"important." +msgstr "" + +#. Tag: para +#: faq.xml:192 +#, no-c-format +msgid "" +"To build a spatial index on a table with a geometry " +"column, use the \"CREATE INDEX\" function as follows:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:196 +#, no-c-format +msgid "" +"CREATE INDEX [indexname] ON [tablename] USING GIST ( [geometrycolumn] );" +msgstr "" + +#. Tag: para +#: faq.xml:198 +#, no-c-format +msgid "" +"The \"USING GIST\" option tells the server to use a GiST (Generalized Search " +"Tree) index." +msgstr "" + +#. Tag: para +#: faq.xml:202 +#, no-c-format +msgid "" +"GiST indexes are assumed to be lossy. Lossy indexes uses a proxy object (in " +"the spatial case, a bounding box) for building the index." +msgstr "" + +#. Tag: para +#: faq.xml:207 +#, no-c-format +msgid "" +"You should also ensure that the PostgreSQL query planner has enough " +"information about your index to make rational decisions about when to use " +"it. To do this, you have to \"gather statistics\" on your geometry tables." +msgstr "" + +#. Tag: para +#: faq.xml:212 +#, no-c-format +msgid "" +"For PostgreSQL 8.0.x and greater, just run the VACUUM ANALYZE command." +msgstr "" + +#. Tag: para +#: faq.xml:215 +#, no-c-format +msgid "" +"For PostgreSQL 7.4.x and below, run the SELECT " +"UPDATE_GEOMETRY_STATS() command." +msgstr "" + +#. Tag: para +#: faq.xml:222 +#, no-c-format +msgid "Why aren't PostgreSQL R-Tree indexes supported?" +msgstr "" + +#. Tag: para +#: faq.xml:226 +#, no-c-format +msgid "" +"Early versions of PostGIS used the PostgreSQL R-Tree indexes. However, " +"PostgreSQL R-Trees have been completely discarded since version 0.6, and " +"spatial indexing is provided with an R-Tree-over-GiST scheme." +msgstr "" + +#. Tag: para +#: faq.xml:231 +#, no-c-format +msgid "" +"Our tests have shown search speed for native R-Tree and GiST to be " +"comparable. Native PostgreSQL R-Trees have two limitations which make them " +"undesirable for use with GIS features (note that these limitations are due " +"to the current PostgreSQL native R-Tree implementation, not the R-Tree " +"concept in general):" +msgstr "" + +#. Tag: para +#: faq.xml:239 +#, no-c-format +msgid "" +"R-Tree indexes in PostgreSQL cannot handle features which are larger than 8K " +"in size. GiST indexes can, using the \"lossy\" trick of substituting the " +"bounding box for the feature itself." +msgstr "" + +#. Tag: para +#: faq.xml:246 +#, no-c-format +msgid "" +"R-Tree indexes in PostgreSQL are not \"null safe\", so building an index on " +"a geometry column which contains null geometries will fail." +msgstr "" + +#. Tag: para +#: faq.xml:256 +#, no-c-format +msgid "" +"Why should I use the AddGeometryColumn() function and all " +"the other OpenGIS stuff?" +msgstr "" + +#. Tag: para +#: faq.xml:261 +#, no-c-format +msgid "" +"If you do not want to use the OpenGIS support functions, you do not have to. " +"Simply create tables as in older versions, defining your geometry columns in " +"the CREATE statement. All your geometries will have SRIDs of -1, and the " +"OpenGIS meta-data tables will not be filled in " +"properly. However, this will cause most applications based on PostGIS to " +"fail, and it is generally suggested that you do use " +"AddGeometryColumn() to create geometry tables." +msgstr "" + +#. Tag: para +#: faq.xml:270 +#, no-c-format +msgid "" +"MapServer is one application which makes use of the " +"geometry_columns meta-data. Specifically, MapServer can " +"use the SRID of the geometry column to do on-the-fly reprojection of " +"features into the correct map projection." +msgstr "" + +#. Tag: para +#: faq.xml:279 +#, no-c-format +msgid "" +"What is the best way to find all objects within a radius of another object?" +msgstr "" + +#. Tag: para +#: faq.xml:284 +#, no-c-format +msgid "" +"To use the database most efficiently, it is best to do radius queries which " +"combine the radius test with a bounding box test: the bounding box test uses " +"the spatial index, giving fast access to a subset of data which the radius " +"test is then applied to." +msgstr "" + +#. Tag: para +#: faq.xml:289 +#, no-c-format +msgid "" +"The ST_DWithin(geometry, geometry, distance) function is " +"a handy way of performing an indexed distance search. It works by creating a " +"search rectangle large enough to enclose the distance radius, then " +"performing an exact distance search on the indexed subset of results." +msgstr "" + +#. Tag: para +#: faq.xml:295 +#, no-c-format +msgid "" +"For example, to find all objects with 100 meters of POINT(1000 1000) the " +"following query would work well:" +msgstr "" + +#. Tag: programlisting +#: faq.xml:298 +#, no-c-format +msgid "" +"SELECT * FROM geotable \n" +"WHERE ST_DWithin(geocolumn, 'POINT(1000 1000)', 100.0);" +msgstr "" + +#. Tag: para +#: faq.xml:304 +#, no-c-format +msgid "How do I perform a coordinate reprojection as part of a query?" +msgstr "" + +#. Tag: para +#: faq.xml:309 +#, no-c-format +msgid "" +"To perform a reprojection, both the source and destination coordinate " +"systems must be defined in the SPATIAL_REF_SYS table, and the geometries " +"being reprojected must already have an SRID set on them. Once that is done, " +"a reprojection is as simple as referring to the desired destination SRID. " +"The below projects a geometry to NAD 83 long lat. The below will only work " +"if the srid of the_geom is not -1 (not undefined spatial ref)" +msgstr "" + +#. Tag: programlisting +#: faq.xml:316 +#, no-c-format +msgid "SELECT ST_Transform(the_geom,4269) FROM geotable;" +msgstr "" + +#. Tag: para +#: faq.xml:322 +#, no-c-format +msgid "" +"I did an ST_AsEWKT and ST_AsText on my rather large geometry and it returned " +"blank field. What gives?" +msgstr "" + +#. Tag: para +#: faq.xml:326 +#, no-c-format +msgid "" +"You are probably using PgAdmin or some other tool that doesn't output large " +"text. If your geometry is big enough, it will appear blank in these tools. " +"Use PSQL if you really need to see it or output it in WKT." +msgstr "" + +#. Tag: programlisting +#: faq.xml:329 +#, no-c-format +msgid "" +"--To check number of geometries are really blank\n" +" SELECT count(gid) FROM geotable WHERE " +"the_geom IS NULL;" +msgstr "" + +#. Tag: para +#: faq.xml:335 +#, no-c-format +msgid "" +"When I do an ST_Intersects, it says my two geometries don't intersect when I " +"KNOW THEY DO. What gives?" +msgstr "" + +#. Tag: para +#: faq.xml:339 +#, no-c-format +msgid "" +"This generally happens in two common cases. Your geometry is invalid -- " +"check or you are assuming they intersect " +"because ST_AsText truncates the numbers and you have lots of decimals after " +"it is not showing you." +msgstr "" + +#. Tag: para +#: faq.xml:347 +#, no-c-format +msgid "" +"I am releasing software that uses PostGIS, does that mean my software has to " +"be licensed using the GPL like PostGIS? Will I have to publish all my code " +"if I use PostGIS?" +msgstr "" + +#. Tag: para +#: faq.xml:351 +#, no-c-format +msgid "" +"Almost certainly not. As an example, consider Oracle database running on " +"Linux. Linux is GPL, Oracle is not, does Oracle running on Linux have to be " +"distributed using the GPL? No. So your software can use a PostgreSQL/PostGIS " +"database as much as it wants and be under any license you like." +msgstr "" + +#. Tag: para +#: faq.xml:352 +#, no-c-format +msgid "" +"The only exception would be if you made changes to the PostGIS source code, " +"and distributed your changed version of PostGIS. In that case you would have " +"to share the code of your changed PostGIS (but not the code of applications " +"running on top of it). Even in this limited case, you would still only have " +"to distribute source code to people you distributed binaries to. The GPL " +"does not require that you publish your source code, " +"only that you share it with people you give binaries to." +msgstr "" diff --git a/doc/po/pl/faq_raster.xml.po b/doc/po/pl/faq_raster.xml.po new file mode 100644 index 000000000..97b01f105 --- /dev/null +++ b/doc/po/pl/faq_raster.xml.po @@ -0,0 +1,660 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: faq_raster.xml:3 +#, no-c-format +msgid "PostGIS Raster Frequently Asked Questions" +msgstr "" + +#. Tag: para +#: faq_raster.xml:9 +#, no-c-format +msgid "Where can I find out more about the PostGIS Raster Project?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:13 +#, no-c-format +msgid "" +"Refer to the PostGIS Raster home page." +msgstr "" + +#. Tag: para +#: faq_raster.xml:19 +#, no-c-format +msgid "" +"Are there any books or tutorials to get me started with this wonderful " +"invention?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:23 +#, no-c-format +msgid "" +"There is a full length beginner tutorial Intersecting vector buffers with large " +"raster coverage using PostGIS Raster. Jorge has a series of blog " +"articles on PostGIS Raster that demonstrate how to load raster data as well " +"as cross compare to same tasks in Oracle GeoRaster. Check out Jorge's PostGIS " +"Raster / Oracle GeoRaster Series. There is a whole chapter (more " +"than 35 pages of content) dedicated to PostGIS Raster with free code and " +"data downloads at PostGIS in " +"Action - Raster chapter. You can buy PostGIS in Action now from Manning in hard-copy " +"(significant discounts for bulk purchases) or just the E-book format. You " +"can also buy from Amazon and various other book distributors. All hard-copy " +"books come with a free coupon to download the E-book version." +msgstr "" + +#. Tag: para +#: faq_raster.xml:30 +#, no-c-format +msgid "" +"Here is a review from a PostGIS Raster user PostGIS raster applied to " +"land classification urban forestry" +msgstr "" + +#. Tag: para +#: faq_raster.xml:37 +#, no-c-format +msgid "How do I install Raster support in my PostGIS database?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:41 +#, no-c-format +msgid "" +"The easiest is to download binaries for PostGIS and Raster which are " +"currently available for windows and latest versions of Mac OSX. First you " +"need a working PostGIS 2.0.0 or above and be running PostgreSQL 8.4, 9.0, or " +"9.1. Note in PostGIS 2.0 PostGIS Raster is fully integrated, so it will be " +"compiled when you compile PostGIS." +msgstr "" + +#. Tag: para +#: faq_raster.xml:43 +#, no-c-format +msgid "" +"Instructions for installing and running under windows are available at " +"How to Install and Configure PostGIS " +"raster on windows" +msgstr "" + +#. Tag: para +#: faq_raster.xml:44 +#, no-c-format +msgid "" +"If you are on windows, you can compile yourself, or use the pre-" +"compiled PostGIS Raster windows binaries. If you are on Mac OSX " +"Leopard or Snow Leopard, there are binaries available at Kyng Chaos Mac OSX PostgreSQL/GIS " +"binaries." +msgstr "" + +#. Tag: para +#: faq_raster.xml:50 +#, no-c-format +msgid "" +"Then to enable raster support in your database, run the rtpostgis.sql file " +"in your database. To upgrade an existing install use " +"rtpostgis_upgrade_minor..sql instead of rtpostgis.sql" +msgstr "" + +#. Tag: para +#: faq_raster.xml:51 +#, no-c-format +msgid "" +"For other platforms, you generally need to compile yourself. Dependencies " +"are PostGIS and GDAL. For more details about compiling from source, please " +"refer to Installing PostGIS " +"Raster from source (in prior versions of PostGIS)" +msgstr "" + +#. Tag: para +#: faq_raster.xml:57 +#, no-c-format +msgid "" +"I get error could not load library \"C:/Program Files/PostgreSQL/8.4/lib/" +"rtpostgis.dll\": The specified module could not be found. or could not load " +"library on Linux when trying to run rtpostgis.sql" +msgstr "" + +#. Tag: para +#: faq_raster.xml:62 +#, no-c-format +msgid "" +"rtpostgis.so/dll is built with dependency on libgdal.dll/so. Make sure for " +"Windows you have libgdal-1.dll in the bin folder of your PostgreSQL install. " +"For Linux libgdal has to be in your path or bin folder." +msgstr "" + +#. Tag: para +#: faq_raster.xml:64 +#, no-c-format +msgid "" +"You may also run into different errors if you don't have PostGIS installed " +"in your database. Make sure to install PostGIS first in your database before " +"trying to install the raster support." +msgstr "" + +#. Tag: para +#: faq_raster.xml:71 +#, no-c-format +msgid "How do I load Raster data into PostGIS?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:75 +#, no-c-format +msgid "" +"The latest version of PostGIS comes packaged with a raster2pgsql raster loader executable capable of loading many kinds of rasters " +"and also generating lower resolution overviews without any additional " +"software. Please refer to for more " +"details. Pre-2.0 versions came with a raster2pgsql.py " +"that required python with numpy and GDAL. This is no longer needed." +msgstr "" + +#. Tag: para +#: faq_raster.xml:81 +#, no-c-format +msgid "What kind of raster file formats can I load into my database?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:85 +#, no-c-format +msgid "" +"Any that your GDAL library supports. GDAL supported formats are documented " +"GDAL File Formats." +msgstr "" + +#. Tag: para +#: faq_raster.xml:86 +#, no-c-format +msgid "" +"Your particular GDAL install may not support all formats. To verify the ones " +"supported by your particular GDAL install, you can use" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:87 +#, no-c-format +msgid "raster2pgsql -G" +msgstr "" + +#. Tag: para +#: faq_raster.xml:93 +#, no-c-format +msgid "Can I export my PostGIS raster data to other raster formats?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:97 +#, no-c-format +msgid "Yes" +msgstr "" + +#. Tag: para +#: faq_raster.xml:98 +#, no-c-format +msgid "" +"GDAL 1.7+ has a PostGIS raster driver, but is only compiled in if you choose " +"to compile with PostgreSQL support." +msgstr "" + +#. Tag: para +#: faq_raster.xml:99 +#, no-c-format +msgid "" +"The driver currently doesn't support irregularly blocked rasters, although " +"you can store irregularly blocked rasters in PostGIS raster data type." +msgstr "" + +#. Tag: para +#: faq_raster.xml:101 +#, no-c-format +msgid "" +"If you are compiling from source, you need to include in your configure " +"--with-pg=path/to/pg_config to enable the " +"driver. Refer to GDAL Build Hints for tips on building GDAL against in various OS " +"platforms." +msgstr "" + +#. Tag: para +#: faq_raster.xml:106 +#, no-c-format +msgid "" +"If your version of GDAL is compiled with the PostGIS Raster driver you " +"should see PostGIS Raster in list when you do" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:108 +#, no-c-format +msgid "gdalinfo --formats" +msgstr "" + +#. Tag: para +#: faq_raster.xml:110 +#, no-c-format +msgid "To get a summary about your raster via GDAL use gdalinfo:" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:111 +#, no-c-format +msgid "" +"gdalinfo \"PG:host=localhost port=5432 dbname='mygisdb' user='postgres' " +"password='whatever' schema='someschema' table=sometable\"" +msgstr "" + +#. Tag: para +#: faq_raster.xml:114 +#, no-c-format +msgid "" +"To export data to other raster formats, use gdal_translate the below will " +"export all data from a table to a PNG file at 10% size." +msgstr "" + +#. Tag: para +#: faq_raster.xml:116 +#, no-c-format +msgid "" +"Depending on your pixel band types, some translations may not work if the " +"export format does not support that Pixel type. For example floating point " +"band types and 32 bit unsigned ints will not translate easily to JPG or some " +"others." +msgstr "" + +#. Tag: para +#: faq_raster.xml:119 +#, no-c-format +msgid "Here is an example simple translation" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:120 +#, no-c-format +msgid "" +"gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost dbname='mygisdb' " +"user='postgres' password=whatever' schema='someschema' table=sometable\" C:" +"\\somefile.png" +msgstr "" + +#. Tag: para +#: faq_raster.xml:121 +#, no-c-format +msgid "" +"You can also use SQL where clauses in your export using the where=... in " +"your driver connection string. Below are some using a where clause" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:123 +#, no-c-format +msgid "" +"gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost dbname='mygisdb' " +"user='postgres' password=whatever' schema='someschema' table=sometable where=" +"\"owner='jimmy'\" \" C:\\somefile.png" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:124 +#, no-c-format +msgid "" +"gdal_translate -of PNG -outsize 10% 10% \"PG:host=localhost dbname='mygisdb' " +"user='postgres' password=whatever' schema='someschema' table=sometable " +"where='ST_Intersects(rast, ST_SetSRID(ST_Point(-71.032,42.3793),4326) )' \" " +"C:\\intersectregion.png" +msgstr "" + +#. Tag: para +#: faq_raster.xml:125 +#, no-c-format +msgid "" +"To see more examples and syntax refer to Reading Raster Data of PostGIS Raster section" +msgstr "" + +#. Tag: para +#: faq_raster.xml:130 +#, no-c-format +msgid "" +"Are their binaries of GDAL available already compiled with PostGIS Raster " +"suppport?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:132 +#, no-c-format +msgid "" +"Yes. Check out the page GDAL Binaries page. Any compiled with " +"PostgreSQL support should have PostGIS Raster in them." +msgstr "" + +#. Tag: para +#: faq_raster.xml:134 +#, no-c-format +msgid "" +"We know for sure the following windows binaries have PostGIS Raster built in." +msgstr "" + +#. Tag: para +#: faq_raster.xml:135 +#, no-c-format +msgid "" +"FWTools latest stable version " +"for Windows is compiled with Raster support." +msgstr "" + +#. Tag: para +#: faq_raster.xml:136 +#, no-c-format +msgid "" +"PostGIS Raster is undergoing many changes. If you want to get the latest " +"nightly build for Windows -- then check out the Tamas Szekeres nightly " +"builds built with Visual Studio which contain GDAL trunk, Python Bindings " +"and MapServer executables and PostGIS Raster driver built-in. Just click the " +"SDK bat and run your commands from there. http://vbkto.dyndns.org/sdk/. Also available are VS " +"project files." +msgstr "" + +#. Tag: para +#: faq_raster.xml:145 +#, no-c-format +msgid "What tools can I use to view PostGIS raster data?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:149 +#, no-c-format +msgid "" +"You can use MapServer compiled with GDAL 1.7+ and PostGIS Raster driver " +"support to view Raster data. QuantumGIS (QGIS) now supports viewing of " +"PostGIS Raster if you have PostGIS raster driver installed." +msgstr "" + +#. Tag: para +#: faq_raster.xml:151 +#, no-c-format +msgid "" +"In theory any tool that renders data using GDAL can support PostGIS raster " +"data or support it with fairly minimal effort. Again for Windows, Tamas' " +"binaries http://vbkto.dyndns.org/" +"sdk/ are a good choice if you don't want the hassle of having to " +"setup to compile your own." +msgstr "" + +#. Tag: para +#: faq_raster.xml:158 +#, no-c-format +msgid "How can I add a PostGIS raster layer to my MapServer map?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:162 +#, no-c-format +msgid "" +"First you need GDAL 1.7 or higher compiled with PostGIS raster support. GDAL " +"1.8 or above is preferred since many issues have been fixed in 1.8 and more " +"PostGIS raster issues fixed in trunk version." +msgstr "" + +#. Tag: para +#: faq_raster.xml:164 +#, no-c-format +msgid "" +"You can much like you can with any other raster. Refer to MapServer Raster processing " +"options for list of various processing functions you can use with " +"MapServer raster layers." +msgstr "" + +#. Tag: para +#: faq_raster.xml:167 +#, no-c-format +msgid "" +"What makes PostGIS raster data particularly interesting, is that since each " +"tile can have various standard database columns, you can segment it in your " +"data source" +msgstr "" + +#. Tag: para +#: faq_raster.xml:169 +#, no-c-format +msgid "" +"Below is an example of how you would define a PostGIS raster layer in " +"MapServer." +msgstr "" + +#. Tag: para +#: faq_raster.xml:170 +#, no-c-format +msgid "" +"The mode=2 is required for tiled rasters and was added in PostGIS 2.0 and " +"GDAL 1.8 drivers. This does not exist in GDAL 1.7 drivers." +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:171 +#, no-c-format +msgid "" +"-- displaying raster with standard raster options\n" +"LAYER\n" +" NAME coolwktraster\n" +" TYPE raster\n" +" STATUS ON\n" +" DATA \"PG:host=localhost port=5432 dbname='somedb' user='someuser' " +"password='whatever' \n" +" schema='someschema' table='cooltable' mode='2'\" \n" +" PROCESSING \"NODATA=0\"\n" +" PROCESSING \"SCALE=AUTO\"\n" +" #... other standard raster processing functions here\n" +" #... classes are optional but useful for 1 band data\n" +" CLASS\n" +" NAME \"boring\"\n" +" EXPRESSION ([pixel] < 20)\n" +" COLOR 250 250 250\n" +" END\n" +" CLASS\n" +" NAME \"mildly interesting\"\n" +" EXPRESSION ([pixel] > 20 AND [pixel] < 1000)\n" +" COLOR 255 0 0\n" +" END\n" +" CLASS\n" +" NAME \"very interesting\"\n" +" EXPRESSION ([pixel] >= 1000)\n" +" COLOR 0 255 0\n" +" END\n" +"END" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:173 +#, no-c-format +msgid "" +"-- displaying raster with standard raster options and a where clause\n" +"LAYER\n" +" NAME soil_survey2009\n" +" TYPE raster\n" +" STATUS ON\n" +" DATA \"PG:host=localhost port=5432 dbname='somedb' user='someuser' " +"password='whatever' \n" +" schema='someschema' table='cooltable' " +"where='survey_year=2009' mode='2'\" \n" +" PROCESSING \"NODATA=0\"\n" +" #... other standard raster processing functions here\n" +" #... classes are optional but useful for 1 band data\n" +"END" +msgstr "" + +#. Tag: para +#: faq_raster.xml:181 +#, no-c-format +msgid "What functions can I currently use with my raster data?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:185 +#, no-c-format +msgid "" +"Refer to the list of . There are more, but " +"this is still a work in progress." +msgstr "" + +#. Tag: para +#: faq_raster.xml:187 +#, no-c-format +msgid "" +"Refer to the PostGIS Raster roadmap page for details of what " +"you can expect in the future." +msgstr "" + +#. Tag: para +#: faq_raster.xml:195 +#, no-c-format +msgid "" +"I am getting error ERROR: function st_intersects(raster, unknown) is not " +"unique or st_union(geometry,text) is not unique. How do I fix?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:199 +#, no-c-format +msgid "" +"The function is not unique error happens if one of your arguments is a " +"textual representation of a geometry instead of a geometry. In these cases, " +"PostgreSQL marks the textual representation as an unknown type, which means " +"it can fall into the st_intersects(raster, geometry) or st_intersects(raster," +"raster) thus resulting in a non-unique case since both functions can in " +"theory support your request. To prevent this, you need to cast the geometry " +"to a geometry." +msgstr "" + +#. Tag: para +#: faq_raster.xml:200 +#, no-c-format +msgid "For example if your code looks like this:" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:201 +#, no-c-format +msgid "" +"SELECT rast\n" +" FROM my_raster\n" +" WHERE ST_Intersects(rast, 'SRID=4326;POINT(-10 10)');" +msgstr "" + +#. Tag: para +#: faq_raster.xml:202 +#, no-c-format +msgid "" +"Cast the textual geometry representation to a geometry by changing your code " +"to this:" +msgstr "" + +#. Tag: programlisting +#: faq_raster.xml:203 +#, no-c-format +msgid "" +"SELECT rast\n" +" FROM my_raster\n" +" WHERE ST_Intersects(rast, 'SRID=4326;POINT(-10 10)'::geometry);" +msgstr "" + +#. Tag: para +#: faq_raster.xml:211 +#, no-c-format +msgid "" +"How is PostGIS Raster different from Oracle GeoRaster (SDO_GEORASTER) and " +"SDO_RASTER types?" +msgstr "" + +#. Tag: para +#: faq_raster.xml:215 +#, no-c-format +msgid "" +"For a more extensive discussion on this topic, check out Jorge Arévalo " +"Oracle GeoRaster and PostGIS Raster: First impressions " +msgstr "" + +#. Tag: para +#: faq_raster.xml:216 +#, no-c-format +msgid "" +"The major advantage of one-georeference-by-raster over one-georeference-by-" +"layer is to allow:" +msgstr "" + +#. Tag: para +#: faq_raster.xml:217 +#, no-c-format +msgid "" +"* coverages to be not necessarily rectangular (which is often the case of " +"raster coverage covering large extents. See the possible raster arrangements " +"in the documentation)" +msgstr "" + +#. Tag: para +#: faq_raster.xml:218 +#, no-c-format +msgid "" +"* rasters to overlaps (which is necessary to implement lossless vector to " +"raster conversion)" +msgstr "" + +#. Tag: para +#: faq_raster.xml:219 +#, no-c-format +msgid "" +"These arrangements are possible in Oracle as well, but they imply the " +"storage of multiple SDO_GEORASTER objects linked to as many SDO_RASTER " +"tables. A complex coverage can lead to hundreds of tables in the database. " +"With PostGIS Raster you can store a similar raster arrangement into a unique " +"table." +msgstr "" + +#. Tag: para +#: faq_raster.xml:224 +#, no-c-format +msgid "" +"It's a bit like if PostGIS would force you to store only full rectangular " +"vector coverage without gaps or overlaps (a perfect rectangular topological " +"layer). This is very practical in some applications but practice has shown " +"that it is not realistic or desirable for most geographical coverages. " +"Vector structures needs the flexibility to store discontinuous and non-" +"rectangular coverages. We think it is a big advantage that raster structure " +"should benefit as well." +msgstr "" diff --git a/doc/po/pl/installation.xml.po b/doc/po/pl/installation.xml.po new file mode 100644 index 000000000..c6ad92ee0 --- /dev/null +++ b/doc/po/pl/installation.xml.po @@ -0,0 +1,2254 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-10-12 07:23+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: installation.xml:3 installation.xml:231 installation.xml:640 +#, no-c-format +msgid "Installation" +msgstr "" + +#. Tag: para +#: installation.xml:5 +#, no-c-format +msgid "This chapter details the steps required to install PostGIS." +msgstr "" + +#. Tag: title +#: installation.xml:10 +#, no-c-format +msgid "Short Version" +msgstr "" + +#. Tag: para +#: installation.xml:11 +#, no-c-format +msgid "" +"The raster support is currently optional, but installed by default. For " +"installing using the PostgreSQL 9.1+ extensions model it is required. Please " +"refer to if you are " +"using PostgreSQL 9.1+." +msgstr "" + +#. Tag: para +#: installation.xml:13 +#, no-c-format +msgid "" +"All the .sql files once installed will be installed in share/contrib/postgis-" +"&last_release_version; folder of your PostgreSQL install" +msgstr "" + +#. Tag: para +#: installation.xml:15 +#, no-c-format +msgid "" +"The postgis_comments.sql, raster_comments.sql, topology_comments.sql generate quick help tips " +"for each function that can be accessed via pgAdmin III or psql. In psql with " +"a command of the form e.g.\\dd ST_SetPoint" +msgstr "" + +#. Tag: programlisting +#: installation.xml:17 +#, no-c-format +msgid "" +"tar xvfz postgis-&last_release_version;.tar.gz\n" +"cd postgis-&last_release_version;\n" +"./configure --with-raster --with-topology --with-gui\n" +"make\n" +"make install\n" +"createdb yourdatabase\n" +"createlang plpgsql yourdatabase\n" +"psql -d yourdatabase -f postgis.sql\n" +"psql -d yourdatabase -f postgis_comments.sql\n" +"psql -d yourdatabase -f spatial_ref_sys.sql\n" +"psql -d yourdatabase -f rtpostgis.sql\n" +"psql -d yourdatabase -f raster_comments.sql\n" +"psql -d yourdatabase -f topology/topology.sql\n" +"psql -d yourdatabase -f doc/topology_comments.sql" +msgstr "" + +#. Tag: para +#: installation.xml:18 +#, no-c-format +msgid "" +"topology_comments.sql since its an optional feature is " +"not installed by make install or make comments-" +"install. However if you do a make comments or " +"make topology_comments.sql, it will be generated in the " +"docs folder" +msgstr "" + +#. Tag: para +#: installation.xml:27 +#, no-c-format +msgid "" +"The rest of this chapter goes into detail each of the above installation " +"steps." +msgstr "" + +#. Tag: title +#: installation.xml:34 +#, no-c-format +msgid "Requirements" +msgstr "" + +#. Tag: para +#: installation.xml:36 +#, no-c-format +msgid "PostGIS has the following requirements for building and usage:" +msgstr "" + +#. Tag: emphasis +#: installation.xml:41 +#, no-c-format +msgid "Required" +msgstr "" + +#. Tag: para +#: installation.xml:46 +#, no-c-format +msgid "" +"PostgreSQL &min_postgres_version; or higher. A complete installation of " +"PostgreSQL (including server headers) is required. PostgreSQL is available " +"from http://www.postgresql.org ." +msgstr "" + +#. Tag: para +#: installation.xml:55 +#, no-c-format +msgid "" +"For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support " +"matrix refer to http://trac.osgeo.org/postgis/wiki/" +"UsersWikiPostgreSQLPostGIS" +msgstr "" + +#. Tag: para +#: installation.xml:61 +#, no-c-format +msgid "" +"GNU C compiler (gcc). Some other ANSI C compilers can " +"be used to compile PostGIS, but we find far fewer problems when compiling " +"with gcc." +msgstr "" + +#. Tag: para +#: installation.xml:69 +#, no-c-format +msgid "" +"GNU Make (gmake or make). For many " +"systems, GNU make is the default version of make. Check " +"the version by invoking make -v. Other versions of " +"make may not process the PostGIS Makefile properly." +msgstr "" + +#. Tag: para +#: installation.xml:79 +#, no-c-format +msgid "" +"Proj4 reprojection library, version 4.6.0 or greater. The Proj4 library is " +"used to provide coordinate reprojection support within PostGIS. Proj4 is " +"available for download from " +"http://trac.osgeo.org/proj/ ." +msgstr "" + +#. Tag: para +#: installation.xml:91 +#, no-c-format +msgid "" +"GEOS geometry library, version 3.3 or greater, but GEOS 3.4+ is recommended " +"to take full advantage of all the new functions and features. Without GEOS " +"3.4, you will be missing some major enhancements such as ST_Triangles and " +"long-running function interruption, and improvements to geometry validation " +"and making geometries valid such as ST_ValidDetail and ST_MakeValid. GEOS " +"3.3.2+ is also required for topology support. GEOS is available for download " +"from http://trac.osgeo.org/geos/ " +" and 3.4+ is backward-compatible with older versions so fairly safe " +"to upgrade." +msgstr "" + +#. Tag: para +#: installation.xml:101 +#, no-c-format +msgid "" +"LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports " +"functions (ST_GeomFromGML and ST_GeomFromKML). LibXML2 is available for " +"download from http://" +"xmlsoft.org/downloads.html." +msgstr "" + +#. Tag: para +#: installation.xml:108 +#, no-c-format +msgid "" +"JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON " +"via the function ST_GeomFromGeoJson. JSON-C is available for download from " +"http://oss.metaparadigm." +"com/json-c/." +msgstr "" + +#. Tag: para +#: installation.xml:116 +#, no-c-format +msgid "" +"GDAL, version 1.8 or higher (1.9 or higher is strongly recommended since " +"some things will not work well or behavior differently with lower versions). " +"This is required for raster support. http://trac.osgeo.org/gdal/wiki/DownloadSource." +msgstr "" + +#. Tag: emphasis +#: installation.xml:124 +#, no-c-format +msgid "Optional" +msgstr "" + +#. Tag: para +#: installation.xml:129 +#, no-c-format +msgid "" +"GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. " +" http://www.gtk.org/ ." +msgstr "" + +#. Tag: para +#: installation.xml:139 +#, no-c-format +msgid "" +"CUnit (CUnit). This is needed for regression testing. " +"http://cunit.sourceforge.net/" +msgstr "" + +#. Tag: para +#: installation.xml:145 +#, no-c-format +msgid "" +"Apache Ant (ant) is required for building any of the " +"drivers under the java directory. Ant is available from " +" http://ant.apache.org ." +msgstr "" + +#. Tag: para +#: installation.xml:157 +#, no-c-format +msgid "" +"DocBook (xsltproc) is required for building the " +"documentation. Docbook is available from http://www.docbook.org/ ." +msgstr "" + +#. Tag: para +#: installation.xml:168 +#, no-c-format +msgid "" +"DBLatex (dblatex) is required for building the " +"documentation in PDF format. DBLatex is available from http://dblatex.sourceforge.net/ ." +msgstr "" + +#. Tag: para +#: installation.xml:179 +#, no-c-format +msgid "" +"ImageMagick (convert) is required to generate the " +"images used in the documentation. ImageMagick is available from http://www.imagemagick.org/ ." +msgstr "" + +#. Tag: title +#: installation.xml:192 +#, no-c-format +msgid "Getting the Source" +msgstr "" + +#. Tag: para +#: installation.xml:194 +#, no-c-format +msgid "" +"Retrieve the PostGIS source archive from the downloads website " +"http://www.postgis.org/download/postgis-&last_release_version;.tar.gz " +msgstr "" + +#. Tag: programlisting +#: installation.xml:201 +#, no-c-format +msgid "" +"wget http://www.postgis.org/download/postgis-&last_release_version;.tar.gz\n" +"tar -xvzf postgis-&last_release_version;.tar.gz" +msgstr "" + +#. Tag: para +#: installation.xml:203 +#, no-c-format +msgid "" +"This will create a directory called postgis-&last_release_version; in the current working directory." +msgstr "" + +#. Tag: para +#: installation.xml:209 +#, no-c-format +msgid "" +"Alternatively, checkout the source from the svn repository http://svn.osgeo.org/postgis/trunk/ ." +msgstr "" + +#. Tag: programlisting +#: installation.xml:221 +#, no-c-format +msgid "" +"svn checkout http://svn.osgeo.org/postgis/trunk/ postgis-" +"&last_release_version;" +msgstr "" + +#. Tag: para +#: installation.xml:223 +#, no-c-format +msgid "" +"Change into the newly created postgis-&last_release_version; directory to continue the installation." +msgstr "" + +#. Tag: para +#: installation.xml:234 +#, no-c-format +msgid "" +"Many OS systems now include pre-built packages for PostgreSQL/PostGIS. In " +"many cases compilation is only necessary if you want the most bleeding edge " +"versions or you are a package maintainer." +msgstr "" + +#. Tag: para +#: installation.xml:239 +#, no-c-format +msgid "" +"This section includes general compilation instructions, if you are compiling " +"for Windows etc or another OS, you may find additional more detailed help at " +"PostGIS " +"User contributed compile guides and PostGIS Dev Wiki." +msgstr "" + +#. Tag: para +#: installation.xml:241 +#, no-c-format +msgid "" +"Pre-Built Packages for various OS are listed in PostGIS Pre-built Packages" +msgstr "" + +#. Tag: para +#: installation.xml:242 +#, no-c-format +msgid "" +"If you are a windows user, you can get stable builds via Stackbuilder or " +"PostGIS Windows " +"download site We also have very bleeding-edge windows experimental " +"builds that are built usually once or twice a week or whenever " +"anything exciting happens. You can use these to experiment with the in " +"progress releases of PostGIS" +msgstr "" + +#. Tag: para +#: installation.xml:247 +#, no-c-format +msgid "" +"The PostGIS module is an extension to the PostgreSQL backend server. As " +"such, PostGIS &last_release_version; requires full " +"PostgreSQL server headers access in order to compile. It can be built " +"against PostgreSQL versions &min_postgres_version; or higher. Earlier " +"versions of PostgreSQL are not supported." +msgstr "" + +#. Tag: para +#: installation.xml:255 +#, no-c-format +msgid "" +"Refer to the PostgreSQL installation guides if you haven't already installed " +"PostgreSQL. http://www.postgresql." +"org ." +msgstr "" + +#. Tag: para +#: installation.xml:265 +#, no-c-format +msgid "" +"For GEOS functionality, when you install PostgresSQL you may need to " +"explicitly link PostgreSQL against the standard C++ library:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:270 +#, no-c-format +msgid "LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE]" +msgstr "" + +#. Tag: para +#: installation.xml:272 +#, no-c-format +msgid "" +"This is a workaround for bogus C++ exceptions interaction with older " +"development tools. If you experience weird problems (backend unexpectedly " +"closed or similar things) try this trick. This will require recompiling your " +"PostgreSQL from scratch, of course." +msgstr "" + +#. Tag: para +#: installation.xml:280 +#, no-c-format +msgid "" +"The following steps outline the configuration and compilation of the PostGIS " +"source. They are written for Linux users and will not work on Windows or Mac." +msgstr "" + +#. Tag: title +#: installation.xml:287 +#, no-c-format +msgid "Configuration" +msgstr "" + +#. Tag: para +#: installation.xml:289 +#, no-c-format +msgid "" +"As with most linux installations, the first step is to generate the Makefile " +"that will be used to build the source code. This is done by running the " +"shell script" +msgstr "" + +#. Tag: para +#: installation.xml:299 +#, no-c-format +msgid "" +"With no additional parameters, this command will attempt to automatically " +"locate the required components and libraries needed to build the PostGIS " +"source code on your system. Although this is the most common usage of " +"./configure, the script accepts several parameters for " +"those who have the required libraries and programs in non-standard locations." +msgstr "" + +#. Tag: para +#: installation.xml:308 +#, no-c-format +msgid "" +"The following list shows only the most commonly used parameters. For a " +"complete list, use the --help or --help=short parameters." +msgstr "" + +#. Tag: para +#: installation.xml:318 +#, no-c-format +msgid "" +"This is the location the PostGIS libraries and SQL scripts will be installed " +"to. By default, this location is the same as the detected PostgreSQL " +"installation." +msgstr "" + +#. Tag: para +#: installation.xml:325 +#, no-c-format +msgid "" +"This parameter is currently broken, as the package will only install into " +"the PostgreSQL installation directory. Visit http://trac.osgeo.org/postgis/ticket/635 " +"to track this bug." +msgstr "" + +#. Tag: para +#: installation.xml:340 +#, no-c-format +msgid "" +"PostgreSQL provides a utility called pg_config to enable " +"extensions like PostGIS to locate the PostgreSQL installation directory. Use " +"this parameter (--with-pgconfig=/path/to/pg_config) to " +"manually specify a particular PostgreSQL installation that PostGIS will " +"build against." +msgstr "" + +#. Tag: para +#: installation.xml:354 +#, no-c-format +msgid "" +"GDAL, a required library, provides functionality needed for raster support " +"gdal-config to enable software installations to locate " +"the GDAL installation directory. Use this parameter (--with-" +"gdalconfig=/path/to/gdal-config) to manually specify a particular " +"GDAL installation that PostGIS will build against." +msgstr "" + +#. Tag: para +#: installation.xml:368 +#, no-c-format +msgid "" +"GEOS, a required geometry library, provides a utility called geos-" +"config to enable software installations to locate the GEOS " +"installation directory. Use this parameter (--with-geosconfig=/path/" +"to/geos-config) to manually specify a particular GEOS installation " +"that PostGIS will build against." +msgstr "" + +#. Tag: para +#: installation.xml:382 +#, no-c-format +msgid "" +"LibXML is the library required for doing GeomFromKML/GML processes. It " +"normally is found if you have libxml installed, but if not or you want a " +"specific version used, you'll need to point PostGIS at a specific " +"xml2-config confi file to enable software installations " +"to locate the LibXML installation directory. Use this parameter (>--" +"with-xml2config=/path/to/xml2-config) to manually specify a " +"particular LibXML installation that PostGIS will build against." +msgstr "" + +#. Tag: para +#: installation.xml:400 +#, no-c-format +msgid "" +"Proj4 is a reprojection library required by PostGIS. Use this parameter " +"(--with-projdir=/path/to/projdir) to manually specify a " +"particular Proj4 installation directory that PostGIS will build against." +msgstr "" + +#. Tag: para +#: installation.xml:412 +#, no-c-format +msgid "Directory where iconv is installed." +msgstr "" + +#. Tag: para +#: installation.xml:421 +#, no-c-format +msgid "" +"JSON-C is an MIT-" +"licensed JSON library required by PostGIS ST_GeomFromJSON support. Use this " +"parameter (--with-jsondir=/path/to/jsondir) to manually " +"specify a particular JSON-C installation directory that PostGIS will build " +"against." +msgstr "" + +#. Tag: para +#: installation.xml:433 +#, no-c-format +msgid "" +"Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-" +"gui graphical interface to shp2pgsql." +msgstr "" + +#. Tag: para +#: installation.xml:442 +#, no-c-format +msgid "" +"Compile with raster support. This will build rtpostgis-" +"&last_release_version; library and rtpostgis.sql file. This may not be " +"required in final release as plan is to build in raster support by default." +msgstr "" + +#. Tag: para +#: installation.xml:451 +#, no-c-format +msgid "" +"Compile with topology support. This will build the topology.sql file. There " +"is no corresponding library as all logic needed for topology is in postgis-" +"&last_release_version; library." +msgstr "" + +#. Tag: para +#: installation.xml:460 +#, no-c-format +msgid "" +"By default PostGIS will try to detect gettext support and compile with it, " +"however if you run into incompatibility issues that cause breakage of " +"loader, you can disable it entirely with this command. Refer to ticket " +"http://trac.osgeo." +"org/postgis/ticket/748 for an example issue solved by configuring " +"with this. NOTE: that you aren't missing much by turning this off. This is " +"used for international help/label support for the GUI loader which is not " +"yet documented and still experimental." +msgstr "" + +#. Tag: para +#: installation.xml:470 +#, no-c-format +msgid "" +"If you obtained PostGIS from the SVN repository , the first step is really to run the " +"script" +msgstr "" + +#. Tag: para +#: installation.xml:482 +#, no-c-format +msgid "" +"This script will generate the configure script that in " +"turn is used to customize the installation of PostGIS." +msgstr "" + +#. Tag: para +#: installation.xml:487 +#, no-c-format +msgid "" +"If you instead obtained PostGIS as a tarball, running ./autogen.sh is not necessary as configure has already been " +"generated." +msgstr "" + +#. Tag: title +#: installation.xml:496 +#, no-c-format +msgid "Building" +msgstr "" + +#. Tag: para +#: installation.xml:498 +#, no-c-format +msgid "" +"Once the Makefile has been generated, building PostGIS is as simple as " +"running" +msgstr "" + +#. Tag: para +#: installation.xml:507 +#, no-c-format +msgid "" +"The last line of the output should be \"PostGIS was built " +"successfully. Ready to install.\"" +msgstr "" + +#. Tag: para +#: installation.xml:512 +#, no-c-format +msgid "" +"As of PostGIS v1.4.0, all the functions have comments generated from the " +"documentation. If you wish to install these comments into your spatial " +"databases later, run the command which requires docbook. The " +"postgis_comments.sql and other package comments files raster_comments.sql, " +"topology_comments.sql are also packaged in the tar.gz distribution in the " +"doc folder so no need to make comments if installing from the tar ball." +msgstr "" + +#. Tag: command +#: installation.xml:522 installation.xml:544 +#, no-c-format +msgid "make comments" +msgstr "" + +#. Tag: para +#: installation.xml:525 +#, no-c-format +msgid "" +"Introduced in PostGIS 2.0. This generates html cheat sheets suitable for " +"quick reference or for student handouts. This requires xsltproc to build and " +"will generate 4 files in doc folder topology_cheatsheet.html, tiger_geocoder_cheatsheet.html, " +"raster_cheatsheet.html, postgis_cheatsheet." +"html" +msgstr "" + +#. Tag: para +#: installation.xml:530 +#, no-c-format +msgid "" +"You can download some pre-built ones available in html and pdf from PostGIS / PostgreSQL Study " +"Guides" +msgstr "" + +#. Tag: command +#: installation.xml:533 +#, no-c-format +msgid "make cheatsheets" +msgstr "" + +#. Tag: title +#: installation.xml:538 +#, no-c-format +msgid "Building PostGIS Extensions and Deploying them" +msgstr "" + +#. Tag: para +#: installation.xml:540 +#, no-c-format +msgid "" +"The PostGIS extensions are built and installed automatically if you are " +"using PostgreSQL 9.1+." +msgstr "" + +#. Tag: para +#: installation.xml:543 +#, no-c-format +msgid "" +"If you are building from source repository, you need to build the function " +"descriptions first. These get built if you have docbook installed. You can " +"also manually build with the statement:" +msgstr "" + +#. Tag: para +#: installation.xml:545 +#, no-c-format +msgid "" +"Building the comments is not necessary if you are building from a release " +"tar ball since these are packaged pre-built with the tar ball already." +msgstr "" + +#. Tag: para +#: installation.xml:546 +#, no-c-format +msgid "" +"If you are building against PostgreSQL 9.1, the extensions should " +"automatically build as part of the make install process. You can if needed " +"build from the extensions folders or copy files if you need them on a " +"different server." +msgstr "" + +#. Tag: programlisting +#: installation.xml:548 +#, no-c-format +msgid "" +"cd extensions\n" +"cd postgis\n" +"make clean\n" +"make \n" +"make install\n" +"cd ..\n" +"cd postgis_topology\n" +"make clean\n" +"make \n" +"make install" +msgstr "" + +#. Tag: para +#: installation.xml:549 +#, no-c-format +msgid "" +"The extension files will always be the same for the same version of PostGIS " +"regardless of OS, so it is fine to copy over the extension files from one OS " +"to another as long as you have the PostGIS binaries already installed on " +"your servers." +msgstr "" + +#. Tag: para +#: installation.xml:551 +#, no-c-format +msgid "" +"If you want to install the extensions manually on a separate server " +"different from your development, You need to copy the following files from " +"the extensions folder into the PostgreSQL / share / extension folder of your PostgreSQL install as well as the needed binaries " +"for regular PostGIS if you don't have them already on the server." +msgstr "" + +#. Tag: para +#: installation.xml:558 +#, no-c-format +msgid "" +"These are the control files that denote information such as the version of " +"the extension to install if not specified. postgis.control, " +"postgis_topology.control." +msgstr "" + +#. Tag: para +#: installation.xml:564 +#, no-c-format +msgid "" +"All the files in the /sql folder of each extension. Note that these need to " +"be copied to the root of the PostgreSQL share/extension folder " +"extensions/postgis/sql/*.sql, extensions/" +"postgis_topology/sql/*.sql" +msgstr "" + +#. Tag: para +#: installation.xml:570 +#, no-c-format +msgid "" +"Once you do that, you should see postgis, " +"postgis_topology as available extensions in PgAdmin -> " +"extensions." +msgstr "" + +#. Tag: para +#: installation.xml:571 +#, no-c-format +msgid "" +"If you are using psql, you can verify that the extensions are installed by " +"running this query:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:572 +#, no-c-format +msgid "" +"SELECT name, default_version,installed_version \n" +"FROM pg_available_extensions WHERE name LIKE 'postgis%' ;\n" +" name | default_version | installed_version\n" +"-----------------+-----------------+-------------------\n" +"postgis | &last_release_version; | &last_release_version;\n" +"postgis_topology | &last_release_version; |" +msgstr "" + +#. Tag: para +#: installation.xml:574 +#, no-c-format +msgid "" +"If you have the extension installed in the database you are querying, you'll " +"see mention in the installed_version column. If you get " +"no records back, it means you don't have postgis extensions installed on the " +"server at all. PgAdmin III 1.14+ will also provide this information in the " +"extensions section of the database browser tree and will " +"even allow upgrade or uninstall by right-clicking." +msgstr "" + +#. Tag: para +#: installation.xml:578 +#, no-c-format +msgid "" +"If you have the extensions available, you can install postgis extension in " +"your database of choice by either using pgAdmin extension interface or " +"running these sql commands:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:579 +#, no-c-format +msgid "" +"CREATE EXTENSION postgis;\n" +"CREATE EXTENSION postgis_topology;" +msgstr "" + +#. Tag: para +#: installation.xml:581 +#, no-c-format +msgid "" +"Extension tables spatial_ref_sys, layer, topology can not be explicitly backed up. They " +"can only be backed up when the respective postgis or " +"postgis_topology extension is backed up, which only seems " +"to happen when you backup the whole database. As of PostGIS 2.0.1, only srid " +"records not packaged with PostGIS are backed up when the database is backed " +"up so don't go around changing srids we package and expect your changes to " +"be there. Put in a ticket if you find an issue. The structures of extension " +"tables are never backed up since they are created with CREATE " +"EXTENSION and assumed to be the same for a given version of an " +"extension. These behaviors are built into the current PostgreSQL extension " +"model, so nothing we can do about it." +msgstr "" + +#. Tag: para +#: installation.xml:586 +#, no-c-format +msgid "" +"If you installed &last_release_version;, without using our wonderful " +"extension system, you can change it to be extension based by first upgrading " +"to the latest micro version running the upgrade scripts: " +"postgis_upgrade_20_minor.sql," +"raster_upgrade_20_minor.sql," +"topology_upgrade_20_minor.sql." +msgstr "" + +#. Tag: para +#: installation.xml:587 +#, no-c-format +msgid "" +"If you installed postgis without raster support, you'll need to install " +"raster support first (using the full rtpostgis.sql" +msgstr "" + +#. Tag: para +#: installation.xml:588 +#, no-c-format +msgid "" +"Then you can run the below commands to package the functions in their " +"respective extension." +msgstr "" + +#. Tag: programlisting +#: installation.xml:589 +#, no-c-format +msgid "" +"CREATE EXTENSION postgis FROM unpackaged;\n" +"CREATE EXTENSION postgis_topology FROM unpackaged;" +msgstr "" + +#. Tag: title +#: installation.xml:595 +#, no-c-format +msgid "Testing" +msgstr "" + +#. Tag: para +#: installation.xml:597 +#, no-c-format +msgid "If you wish to test the PostGIS build, run" +msgstr "" + +#. Tag: command +#: installation.xml:602 +#, no-c-format +msgid "make check" +msgstr "" + +#. Tag: para +#: installation.xml:605 +#, no-c-format +msgid "" +"The above command will run through various checks and regression tests using " +"the generated library against an actual PostgreSQL database." +msgstr "" + +#. Tag: para +#: installation.xml:611 +#, no-c-format +msgid "" +"If you configured PostGIS using non-standard PostgreSQL, GEOS, or Proj4 " +"locations, you may need to add their library locations to the " +"LD_LIBRARY_PATH environment variable." +msgstr "" + +#. Tag: para +#: installation.xml:619 +#, no-c-format +msgid "" +"Currently, the make check relies on the PATH " +"and PGPORT environment variables when performing the checks - " +"it does not use the PostgreSQL version that may have " +"been specified using the configuration parameter --with-pgconfig. So make sure to modify your PATH to match the detected PostgreSQL " +"installation during configuration or be prepared to deal with the impending " +"headaches." +msgstr "" + +#. Tag: para +#: installation.xml:631 +#, no-c-format +msgid "" +"If successful, the output of the test should be similar to the following:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:636 +#, no-c-format +msgid "" +"CUnit - A Unit testing framework for C - Version 2.1-0\n" +" http://cunit.sourceforge.net/\n" +"\n" +"\n" +"Suite: print_suite\n" +" Test: test_lwprint_default_format ... passed\n" +" Test: test_lwprint_format_orders ... passed\n" +" Test: test_lwprint_optional_format ... passed\n" +" Test: test_lwprint_oddball_formats ... passed\n" +" Test: test_lwprint_bad_formats ... passed\n" +"Suite: Misc Suite\n" +" Test: test_misc_force_2d ... passed\n" +" Test: test_misc_simplify ... passed\n" +" Test: test_misc_count_vertices ... passed\n" +" Test: test_misc_area ... passed\n" +" Test: test_misc_wkb ... passed\n" +"Suite: PointArray Suite\n" +" Test: test_ptarray_append_point ... passed\n" +" Test: test_ptarray_append_ptarray ... passed\n" +"Suite: PostGIS Computational Geometry Suite\n" +" Test: test_lw_segment_side ... passed\n" +" Test: test_lw_segment_intersects ... passed\n" +" Test: test_lwline_crossing_short_lines ... passed\n" +" Test: test_lwline_crossing_long_lines ... passed\n" +" Test: test_lwline_crossing_bugs ... passed\n" +" Test: test_lwpoint_set_ordinate ... passed\n" +" Test: test_lwpoint_get_ordinate ... passed\n" +" Test: test_point_interpolate ... passed\n" +" Test: test_lwline_clip ... passed\n" +" Test: test_lwline_clip_big ... passed\n" +" Test: test_lwmline_clip ... passed\n" +" Test: test_geohash_point ... passed\n" +" Test: test_geohash_precision ... passed\n" +" Test: test_geohash ... passed\n" +" Test: test_isclosed ... passed\n" +"Suite: PostGIS Measures Suite\n" +" Test: test_mindistance2d_tolerance ... passed\n" +" Test: test_rect_tree_contains_point ... passed\n" +" Test: test_rect_tree_intersects_tree ... passed\n" +" Test: test_lwgeom_segmentize2d ... passed\n" +"Suite: WKT Out Suite\n" +" Test: test_wkt_out_point ... passed\n" +" Test: test_wkt_out_linestring ... passed\n" +" Test: test_wkt_out_polygon ... passed\n" +" Test: test_wkt_out_multipoint ... passed\n" +" Test: test_wkt_out_multilinestring ... passed\n" +":\n" +":\n" +"--Run Summary: Type Total Ran Passed Failed\n" +" suites 17 17 n/a 0\n" +" tests 143 143 143 0\n" +" asserts 1228 1228 1228 0\n" +"\n" +"\n" +"Creating spatial db postgis_reg\n" +" Postgis 2.0.0SVN - 2011-01-11 15:33:37\n" +" GEOS: 3.3.0-CAPI-1.7.0\n" +" PROJ: Rel. 4.6.1, 21 August 2008\n" +"\n" +"Running tests\n" +"\n" +" loader/Point.............. ok\n" +" loader/PointM.............. ok\n" +" loader/PointZ.............. ok\n" +" loader/MultiPoint.............. ok\n" +" loader/MultiPointM.............. ok\n" +" loader/MultiPointZ.............. ok\n" +" loader/Arc.............. ok\n" +" loader/ArcM.............. ok\n" +" loader/ArcZ.......... ok\n" +" loader/Polygon.............. ok\n" +" loader/PolygonM.............. ok\n" +" loader/PolygonZ.............. ok\n" +" regress. ok\n" +" regress_index. ok\n" +" regress_index_nulls. ok\n" +" lwgeom_regress. ok\n" +" regress_lrs. ok\n" +" removepoint. ok\n" +" setpoint. ok\n" +" simplify. ok\n" +" snaptogrid. ok\n" +" affine. ok\n" +" measures. ok\n" +" long_xact. ok\n" +" ctors. ok\n" +" sql-mm-serialize. ok\n" +" sql-mm-circularstring. ok\n" +" sql-mm-compoundcurve. ok\n" +" sql-mm-curvepoly. ok\n" +" sql-mm-general. ok\n" +" sql-mm-multicurve. ok\n" +" sql-mm-multisurface. ok\n" +" polyhedralsurface. ok\n" +" out_geometry. ok\n" +" out_geography. ok\n" +" in_gml. ok\n" +" in_kml. ok\n" +" iscollection. ok\n" +" regress_ogc. ok\n" +" regress_ogc_cover. ok\n" +" regress_ogc_prep. ok\n" +" regress_bdpoly. ok\n" +" regress_proj. ok\n" +" dump. ok\n" +" dumppoints. ok\n" +" wmsservers_new. ok\n" +" tickets. ok\n" +" remove_repeated_points. ok\n" +" split. ok\n" +" relatematch. ok\n" +" regress_buffer_params. ok\n" +" hausdorff. ok\n" +" clean. ok\n" +" sharedpaths. ok\n" +" snap. ok\n" +"\n" +"Run tests: 55\n" +"Failed: 0" +msgstr "" + +#. Tag: para +#: installation.xml:642 +#, no-c-format +msgid "To install PostGIS, type" +msgstr "" + +#. Tag: command +#: installation.xml:647 +#, no-c-format +msgid "make install" +msgstr "" + +#. Tag: para +#: installation.xml:650 +#, no-c-format +msgid "" +"This will copy the PostGIS installation files into their appropriate " +"subdirectory specified by the --prefix configuration " +"parameter. In particular:" +msgstr "" + +#. Tag: para +#: installation.xml:658 +#, no-c-format +msgid "" +"The loader and dumper binaries are installed in [prefix]/bin." +msgstr "" + +#. Tag: para +#: installation.xml:665 +#, no-c-format +msgid "" +"The SQL files, such as postgis.sql, are installed in " +"[prefix]/share/contrib." +msgstr "" + +#. Tag: para +#: installation.xml:672 +#, no-c-format +msgid "" +"The PostGIS libraries are installed in [prefix]/lib." +msgstr "" + +#. Tag: para +#: installation.xml:679 +#, no-c-format +msgid "" +"If you previously ran the make comments command to " +"generate the postgis_comments.sql, " +"raster_comments.sql file, install the sql file by " +"running" +msgstr "" + +#. Tag: command +#: installation.xml:686 +#, no-c-format +msgid "make comments-install" +msgstr "" + +#. Tag: para +#: installation.xml:690 +#, no-c-format +msgid "" +"postgis_comments.sql, raster_comments.sql, topology_comments.sql was separated from the " +"typical build and installation targets since with it comes the extra " +"dependency of xsltproc." +msgstr "" + +#. Tag: title +#: installation.xml:700 +#, no-c-format +msgid "Create a spatially-enabled database on PostgreSQL lower than 9.1" +msgstr "" + +#. Tag: para +#: installation.xml:702 +#, no-c-format +msgid "" +"The first step in creating a PostGIS database is to create a simple " +"PostgreSQL database." +msgstr "" + +#. Tag: command +#: installation.xml:708 installation.xml:805 +#, no-c-format +msgid "createdb [yourdatabase]" +msgstr "" + +#. Tag: para +#: installation.xml:711 +#, no-c-format +msgid "" +"Many of the PostGIS functions are written in the PL/pgSQL procedural " +"language. As such, the next step to create a PostGIS database is to enable " +"the PL/pgSQL language in your new database. This is accomplish by the " +"command below command. For PostgreSQL 8.4+, this is generally already " +"installed" +msgstr "" + +#. Tag: command +#: installation.xml:719 +#, no-c-format +msgid "createlang plpgsql [yourdatabase]" +msgstr "" + +#. Tag: para +#: installation.xml:722 +#, no-c-format +msgid "" +"Now load the PostGIS object and function definitions into your database by " +"loading the postgis.sql definitions file (located in " +"[prefix]/share/contrib as specified during the " +"configuration step)." +msgstr "" + +#. Tag: command +#: installation.xml:730 +#, no-c-format +msgid "psql -d [yourdatabase] -f postgis.sql" +msgstr "" + +#. Tag: para +#: installation.xml:733 +#, no-c-format +msgid "" +"For a complete set of EPSG coordinate system definition identifiers, you can " +"also load the spatial_ref_sys.sql definitions file and " +"populate the spatial_ref_sys table. This will permit you " +"to perform ST_Transform() operations on geometries." +msgstr "" + +#. Tag: command +#: installation.xml:741 +#, no-c-format +msgid "psql -d [yourdatabase] -f spatial_ref_sys.sql" +msgstr "" + +#. Tag: para +#: installation.xml:744 +#, no-c-format +msgid "" +"If you wish to add comments to the PostGIS functions, the final step is to " +"load the postgis_comments.sql into your spatial " +"database. The comments can be viewed by simply typing \\dd " +"[function_name] from a psql terminal window." +msgstr "" + +#. Tag: command +#: installation.xml:752 +#, no-c-format +msgid "psql -d [yourdatabase] -f postgis_comments.sql" +msgstr "" + +#. Tag: para +#: installation.xml:755 +#, no-c-format +msgid "Install raster support" +msgstr "" + +#. Tag: command +#: installation.xml:760 +#, no-c-format +msgid "psql -d [yourdatabase] -f rtpostgis.sql" +msgstr "" + +#. Tag: para +#: installation.xml:763 +#, no-c-format +msgid "" +"Install raster support comments. This will provide quick help info for each " +"raster function using psql or PgAdmin or any other PostgreSQL tool that can " +"show function comments" +msgstr "" + +#. Tag: command +#: installation.xml:769 +#, no-c-format +msgid "psql -d [yourdatabase] -f raster_comments.sql" +msgstr "" + +#. Tag: para +#: installation.xml:771 +#, no-c-format +msgid "Install topology support" +msgstr "" + +#. Tag: command +#: installation.xml:776 +#, no-c-format +msgid "psql -d [yourdatabase] -f topology/topology.sql" +msgstr "" + +#. Tag: para +#: installation.xml:779 +#, no-c-format +msgid "" +"Install topology support comments. This will provide quick help info for " +"each topology function / type using psql or PgAdmin or any other PostgreSQL " +"tool that can show function comments" +msgstr "" + +#. Tag: command +#: installation.xml:785 +#, no-c-format +msgid "psql -d [yourdatabase] -f topology/topology_comments.sql" +msgstr "" + +#. Tag: para +#: installation.xml:788 installation.xml:825 +#, no-c-format +msgid "" +"If you plan to restore an old backup from prior versions in this new db, run:" +msgstr "" + +#. Tag: command +#: installation.xml:789 installation.xml:826 +#, no-c-format +msgid "psql -d [yourdatabase] -f legacy.sql" +msgstr "" + +#. Tag: para +#: installation.xml:790 +#, no-c-format +msgid "" +"There is an alternative legacy_minimal.sql you can run " +"instead which will install barebones needed to recover tables and work with " +"apps like MapServer and GeoServer. If you have views that use things like " +"distance / length etc, you'll need the full blown legacy.sql" +msgstr "" + +#. Tag: para +#: installation.xml:793 installation.xml:828 +#, no-c-format +msgid "" +"You can later run uninstall_legacy.sql to get rid of " +"the deprecated functions after you are done with restoring and cleanup." +msgstr "" + +#. Tag: title +#: installation.xml:797 +#, no-c-format +msgid "Creating a spatial database using EXTENSIONS" +msgstr "" + +#. Tag: para +#: installation.xml:799 +#, no-c-format +msgid "" +"If you are using PostgreSQL 9.1+ and have compiled and installed the " +"extensions/ postgis modules, you can create a spatial database the new way." +msgstr "" + +#. Tag: para +#: installation.xml:808 +#, no-c-format +msgid "" +"The core postgis extension installs PostGIS geometry, geography, raster, " +"spatial_ref_sys and all the functions and comments with a simple: " +"CREATE EXTENSION postgis; command." +msgstr "" + +#. Tag: command +#: installation.xml:814 +#, no-c-format +msgid "psql -d [yourdatabase] -c \"CREATE EXTENSION postgis;\"" +msgstr "" + +#. Tag: para +#: installation.xml:817 +#, no-c-format +msgid "" +"Topology is packaged as a separate extension and installable with command:" +msgstr "" + +#. Tag: command +#: installation.xml:822 +#, no-c-format +msgid "psql -d [yourdatabase] -c \"CREATE EXTENSION postgis_topology;\"" +msgstr "" + +#. Tag: title +#: installation.xml:832 +#, no-c-format +msgid "Installing, Upgrading Tiger Geocoder and loading data" +msgstr "" + +#. Tag: para +#: installation.xml:834 +#, no-c-format +msgid "" +"The Tiger geocoder does not get installed / upgraded with the core PostGIS " +"scripts because it is only of regional use. In fact nothing located in the " +"extras folder is installed by default with the regular PostGIS install / " +"upgrade. Extras like Tiger geocoder may also not be packaged in your PostGIS " +"distribution, but will always be available in the postgis-" +"&last_release_version;.tar.gz file. The instructions provided here are also " +"available in the extras/tiger_geocoder/tiger_2010/README" +msgstr "" + +#. Tag: para +#: installation.xml:836 +#, no-c-format +msgid "" +"If you are on Windows and you don't have tar installed, you can use http://www.7-zip.org/ to unzip the " +"PostGIS tarball." +msgstr "" + +#. Tag: title +#: installation.xml:838 +#, no-c-format +msgid "Tiger Geocoder Enabling your PostGIS database" +msgstr "" + +#. Tag: para +#: installation.xml:839 +#, no-c-format +msgid "First install PostGIS using the prior instructions." +msgstr "" + +#. Tag: para +#: installation.xml:843 installation.xml:870 +#, no-c-format +msgid "" +"If you don't have an extras folder, download http://www.postgis.org/" +"download/postgis-&last_release_version;.tar.gz" +msgstr "" + +#. Tag: command +#: installation.xml:848 installation.xml:875 +#, no-c-format +msgid "tar xvfz postgis-&last_release_version;.tar.gz" +msgstr "" + +#. Tag: command +#: installation.xml:852 installation.xml:879 +#, no-c-format +msgid "cd postgis-&last_release_version;/extras/tiger_geocoder/tiger_2011" +msgstr "" + +#. Tag: para +#: installation.xml:855 +#, no-c-format +msgid "" +"Edit the tiger_loader.sql to the paths of your " +"executables server etc." +msgstr "" + +#. Tag: para +#: installation.xml:856 +#, no-c-format +msgid "" +"If you are installing Tiger geocoder for the first time edit either the " +"create_geocode.bat script If you are on windows or the " +"create_geocode.sh if you are on Linux/Unix/Mac OSX with " +"your PostgreSQL specific settings and run the corresponding script from the " +"commandline. If you don't edit this file, it will just contain common case " +"locations of items. You can edit the generated script after the fact when " +"you run the command." +msgstr "" + +#. Tag: para +#: installation.xml:859 +#, no-c-format +msgid "" +"Verify that you now have a tiger schema in your database " +"and that it is part of your database search_path. If it is not, add it with " +"a command something along the line of:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:859 +#, no-c-format +msgid "ALTER DATABASE geocoder SET search_path=public, tiger;" +msgstr "" + +#. Tag: para +#: installation.xml:860 +#, no-c-format +msgid "" +"The normalizing address functionality works more or less without any data " +"except for tricky addresses. Run this test and verify things look like this:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:861 +#, no-c-format +msgid "" +"SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, " +"Nevada 89101')) As pretty_address;\n" +"pretty_address\n" +"---------------------------------------\n" +"202 E Fremont St, Las Vegas, NV 89101" +msgstr "" + +#. Tag: title +#: installation.xml:865 +#, no-c-format +msgid "Upgrading your Tiger Geocoder Install" +msgstr "" + +#. Tag: para +#: installation.xml:866 +#, no-c-format +msgid "" +"If you have Tiger Geocoder packaged with 2.0+ already installed, you can " +"upgrade the functions at any time even from an interim tar ball if there are " +"fixes you badly need." +msgstr "" + +#. Tag: para +#: installation.xml:882 +#, no-c-format +msgid "" +"Locate the upgrade_geocoder.bat script If you are on " +"windows or the upgrade_geocoder.sh if you are on Linux/" +"Unix/Mac OSX. Edit the file to have your postgis database credientials and " +"run then corresponding script from the commandline." +msgstr "" + +#. Tag: para +#: installation.xml:885 +#, no-c-format +msgid "" +"Next drop all nation tables and load up the new ones. Generate a drop script " +"with this SQL statement as detailed in " +msgstr "" + +#. Tag: programlisting +#: installation.xml:886 +#, no-c-format +msgid "SELECT drop_nation_tables_generate_script();" +msgstr "" + +#. Tag: para +#: installation.xml:887 +#, no-c-format +msgid "Run the generated drop SQL statements." +msgstr "" + +#. Tag: para +#: installation.xml:888 +#, no-c-format +msgid "" +"Generate a nation load script with this SELECT statement as detailed in " +"" +msgstr "" + +#. Tag: emphasis +#: installation.xml:889 +#, no-c-format +msgid "For windows" +msgstr "" + +#. Tag: programlisting +#: installation.xml:890 +#, no-c-format +msgid "SELECT loader_generate_nation_script('windows');" +msgstr "" + +#. Tag: emphasis +#: installation.xml:891 +#, no-c-format +msgid "For unix/linux" +msgstr "" + +#. Tag: programlisting +#: installation.xml:892 +#, no-c-format +msgid "SELECT loader_generate_nation_script('sh');" +msgstr "" + +#. Tag: para +#: installation.xml:893 +#, no-c-format +msgid "" +"Refer to for instructions on " +"how to run the generate script. This only needs to be done once." +msgstr "" + +#. Tag: para +#: installation.xml:894 +#, no-c-format +msgid "" +"You can have a mix of 2010/2011 state tables and can upgrade each state " +"separately. Before you upgrade a state to 2011, you first need to drop the " +"2010 tables for that state using ." +msgstr "" + +#. Tag: title +#: installation.xml:897 +#, no-c-format +msgid "Loading Tiger Data" +msgstr "" + +#. Tag: para +#: installation.xml:898 +#, no-c-format +msgid "" +"The instructions for loading data are available in a more detailed form in " +"the extras/tiger_geocoder/tiger_2011/README. This just " +"includes the general steps." +msgstr "" + +#. Tag: para +#: installation.xml:899 +#, no-c-format +msgid "" +"The load process downloads data from the census website for the respective " +"nation files, states requested, extracts the files, and then loads each " +"state into its own separate set of state tables. Each state table inherits " +"from the tables defined in tiger schema so that its " +"sufficient to just query those tables to access all the data and drop a set " +"of state tables at any time using the if you need to reload a state or " +"just don't need a state anymore." +msgstr "" + +#. Tag: para +#: installation.xml:901 +#, no-c-format +msgid "In order to be able to load data you'll need the following tools:" +msgstr "" + +#. Tag: para +#: installation.xml:903 +#, no-c-format +msgid "A tool to unzip the zip files from census website." +msgstr "" + +#. Tag: para +#: installation.xml:904 +#, no-c-format +msgid "" +"For Unix like systems: unzip executable which is usually " +"already installed on most Unix like platforms." +msgstr "" + +#. Tag: para +#: installation.xml:905 +#, no-c-format +msgid "" +"For Windows, 7-zip which is a free compress/uncompress tool you can download " +"from http://www.7-zip.org/" +msgstr "" + +#. Tag: para +#: installation.xml:907 +#, no-c-format +msgid "" +"shp2pgsql commandline which is installed by default " +"when you install PostGIS." +msgstr "" + +#. Tag: para +#: installation.xml:908 +#, no-c-format +msgid "" +"wget which is a web grabber tool usually installed on " +"most Unix/Linux systems." +msgstr "" + +#. Tag: para +#: installation.xml:909 +#, no-c-format +msgid "" +"If you are on windows, you can get pre-compiled binaries from http://gnuwin32." +"sourceforge.net/packages/wget.htm" +msgstr "" + +#. Tag: para +#: installation.xml:912 +#, no-c-format +msgid "" +"If you are upgrading from tiger_2010, you'll need to first generate and run " +". Before you load any " +"state data, you need to load the nation wide data which you do with . Which will generate a loader " +"script for you." +msgstr "" + +#. Tag: para +#: installation.xml:914 +#, no-c-format +msgid "" +"To load data refer to to generate " +"a data load script for your platform for the states you desire. Note that " +"you can install these piecemeal. You don't have to load all the states you " +"want all at once. You can load them as you need them." +msgstr "" + +#. Tag: para +#: installation.xml:917 +#, no-c-format +msgid "" +"After the states you desire have been loaded, make sure to run the: " +"SELECT install_missing_indexes(); as " +"described in ." +msgstr "" + +#. Tag: para +#: installation.xml:919 +#, no-c-format +msgid "" +"To test that things are working as they should, try to run a geocode on an " +"address in your state using " +msgstr "" + +#. Tag: title +#: installation.xml:924 +#, no-c-format +msgid "Create a spatially-enabled database from a template" +msgstr "" + +#. Tag: para +#: installation.xml:926 +#, no-c-format +msgid "" +"Some packaged distributions of PostGIS (in particular the Win32 installers " +"for PostGIS >= 1.1.5) load the PostGIS functions into a template database " +"called template_postgis. If the " +"template_postgis database exists in your PostgreSQL " +"installation then it is possible for users and/or applications to create " +"spatially-enabled databases using a single command. Note that in both cases, " +"the database user must have been granted the privilege to create new " +"databases." +msgstr "" + +#. Tag: para +#: installation.xml:937 +#, no-c-format +msgid "From the shell:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:941 +#, no-c-format +msgid "# createdb -T template_postgis my_spatial_db" +msgstr "" + +#. Tag: para +#: installation.xml:943 +#, no-c-format +msgid "From SQL:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:947 +#, no-c-format +msgid "postgres=# CREATE DATABASE my_spatial_db TEMPLATE=template_postgis" +msgstr "" + +#. Tag: title +#: installation.xml:951 +#, no-c-format +msgid "Upgrading" +msgstr "" + +#. Tag: para +#: installation.xml:953 +#, no-c-format +msgid "" +"Upgrading existing spatial databases can be tricky as it requires " +"replacement or introduction of new PostGIS object definitions." +msgstr "" + +#. Tag: para +#: installation.xml:958 +#, no-c-format +msgid "" +"Unfortunately not all definitions can be easily replaced in a live database, " +"so sometimes your best bet is a dump/reload process." +msgstr "" + +#. Tag: para +#: installation.xml:963 +#, no-c-format +msgid "" +"PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and " +"a HARD UPGRADE procedure for major releases." +msgstr "" + +#. Tag: para +#: installation.xml:968 +#, no-c-format +msgid "" +"Before attempting to upgrade PostGIS, it is always worth to backup your " +"data. If you use the -Fc flag to pg_dump you will always be able to restore " +"the dump with a HARD UPGRADE." +msgstr "" + +#. Tag: title +#: installation.xml:975 +#, no-c-format +msgid "Soft upgrade" +msgstr "" + +#. Tag: para +#: installation.xml:977 +#, no-c-format +msgid "" +"If you installed your database using extensions, you'll need to upgrade " +"using the extension model as well. If you installed using the old sql script " +"way, then you should upgrade using the sql script way. Please refer to the " +"appropriate." +msgstr "" + +#. Tag: title +#: installation.xml:980 +#, no-c-format +msgid "Soft Upgrade Pre 9.1+ or without extensions" +msgstr "" + +#. Tag: para +#: installation.xml:981 +#, no-c-format +msgid "" +"This section applies only to those who installed PostGIS not using " +"extensions. If you have extensions and try to upgrade with this approach " +"you'll get messages like:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:982 +#, no-c-format +msgid "can't drop ... because postgis extension depends on it" +msgstr "" + +#. Tag: para +#: installation.xml:983 +#, no-c-format +msgid "" +"After compiling you should find several postgis_upgrade*.sql files. Install the one for your version of PostGIS. For example " +"postgis_upgrade_13_to_15.sql should be used if you are " +"upgrading from PostGIS 1.3 to 1.5. If you are moving from PostGIS 1.* to " +"PostGIS 2.* or from PostGIS 2.* prior to r7409, you need to do a HARD " +"UPGRADE." +msgstr "" + +#. Tag: programlisting +#: installation.xml:989 +#, no-c-format +msgid "psql -f postgis_upgrade_20_minor.sql -d your_spatial_database" +msgstr "" + +#. Tag: para +#: installation.xml:991 +#, no-c-format +msgid "" +"The same procedure applies to raster and topology extensions, with upgrade " +"files named rtpostgis_upgrade*.sql and " +"topology_upgrade*.sql respectively. If you need them:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:999 +#, no-c-format +msgid "psql -f rtpostgis_upgrade_20_minor.sql -d your_spatial_database" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1000 +#, no-c-format +msgid "psql -f topology_upgrade_20_minor.sql -d your_spatial_database" +msgstr "" + +#. Tag: para +#: installation.xml:1003 +#, no-c-format +msgid "" +"If you can't find the postgis_upgrade*.sql specific for " +"upgrading your version you are using a version too early for a soft upgrade " +"and need to do a HARD UPGRADE." +msgstr "" + +#. Tag: para +#: installation.xml:1009 +#, no-c-format +msgid "" +"The function should inform you " +"about the need to run this kind of upgrade using a \"procs need upgrade\" " +"message." +msgstr "" + +#. Tag: title +#: installation.xml:1016 +#, no-c-format +msgid "Soft Upgrade 9.1+ using extensions" +msgstr "" + +#. Tag: para +#: installation.xml:1017 +#, no-c-format +msgid "" +"If you originally installed PostGIS with extensions, then you need to " +"upgrade using extensions as well. Doing a minor upgrade with extensions, is " +"fairly painless." +msgstr "" + +#. Tag: programlisting +#: installation.xml:1018 +#, no-c-format +msgid "" +"ALTER EXTENSION postgis UPDATE TO \"&last_release_version;\";\n" +"ALTER EXTENSION postgis_topology UPDATE TO \"&last_release_version;\";" +msgstr "" + +#. Tag: para +#: installation.xml:1019 +#, no-c-format +msgid "If you get an error notice something like:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1020 +#, no-c-format +msgid "No migration path defined for ... to &last_release_version;" +msgstr "" + +#. Tag: para +#: installation.xml:1021 +#, no-c-format +msgid "" +"Then you'll need to backup your database, create a fresh one as described in " +" and then restore your backup " +"ontop of this new database. You might get a message that postgis " +"extension already installed which you can safely ignore." +msgstr "" + +#. Tag: para +#: installation.xml:1023 +#, no-c-format +msgid "" +"If you installed PostGIS originally without a version specified, you can " +"often skip the reinstallation of postgis extension before restoring since " +"the backup just has CREATE EXTENSION postgis and thus picks up " +"the newest latest version during restore. ." +msgstr "" + +#. Tag: title +#: installation.xml:1030 +#, no-c-format +msgid "Hard upgrade" +msgstr "" + +#. Tag: para +#: installation.xml:1032 +#, no-c-format +msgid "" +"By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You " +"need a HARD UPGRADE when PostGIS objects' internal storage changes or when " +"SOFT UPGRADE is not possible. The Release " +"Notes appendix reports for each version whether you need a dump/" +"reload (HARD UPGRADE) to upgrade." +msgstr "" + +#. Tag: para +#: installation.xml:1041 +#, no-c-format +msgid "" +"The dump/reload process is assisted by the postgis_restore.pl script which " +"takes care of skipping from the dump all definitions which belong to PostGIS " +"(including old ones), allowing you to restore your schemas and data into a " +"database with PostGIS installed without getting duplicate symbol errors or " +"bringing forward deprecated objects." +msgstr "" + +#. Tag: para +#: installation.xml:1050 +#, no-c-format +msgid "" +"Supplementary instructions for windows users are available at Windows Hard " +"upgrade." +msgstr "" + +#. Tag: para +#: installation.xml:1053 +#, no-c-format +msgid "The Procedure is as follows:" +msgstr "" + +#. Tag: para +#: installation.xml:1061 +#, no-c-format +msgid "" +"Create a \"custom-format\" dump of the database you want to upgrade (let's " +"call it olddb) include binary blobs (-b) and verbose (-v) " +"output. The user can be the owner of the db, need not be postgres super " +"account." +msgstr "" + +#. Tag: programlisting +#: installation.xml:1069 +#, no-c-format +msgid "" +"pg_dump -h localhost -p 5432 -U postgres -Fc -b -v -f \"/somepath/olddb." +"backup\" olddb" +msgstr "" + +#. Tag: para +#: installation.xml:1075 +#, no-c-format +msgid "" +"Do a fresh install of PostGIS in a new database -- we'll refer to this " +"database as newdb. Please refer to and for " +"instructions on how to do this." +msgstr "" + +#. Tag: para +#: installation.xml:1082 +#, no-c-format +msgid "" +"The spatial_ref_sys entries found in your dump will be restored, but they " +"will not override existing ones in spatial_ref_sys. This is to ensure that " +"fixes in the official set will be properly propagated to restored databases. " +"If for any reason you really want your own overrides of standard entries " +"just don't load the spatial_ref_sys.sql file when creating the new db." +msgstr "" + +#. Tag: para +#: installation.xml:1092 +#, no-c-format +msgid "" +"If your database is really old or you know you've been using long deprecated " +"functions in your views and functions, you might need to load " +"legacy.sql for all your functions and views etc. to " +"properly come back. Only do this if _really_ needed. Consider upgrading your " +"views and functions before dumping instead, if possible. The deprecated " +"functions can be later removed by loading uninstall_legacy.sql." +msgstr "" + +#. Tag: para +#: installation.xml:1108 +#, no-c-format +msgid "" +"Restore your backup into your fresh newdb database using " +"postgis_restore.pl. Unexpected errors, if any, will be printed to the " +"standard error stream by psql. Keep a log of those." +msgstr "" + +#. Tag: programlisting +#: installation.xml:1116 +#, no-c-format +msgid "" +"perl utils/postgis_restore.pl \"/somepath/olddb.backup\" | psql -h localhost " +"-p 5432 -U postgres newdb 2> errors.txt" +msgstr "" + +#. Tag: para +#: installation.xml:1122 +#, no-c-format +msgid "Errors may arise in the following cases:" +msgstr "" + +#. Tag: para +#: installation.xml:1128 +#, no-c-format +msgid "" +"Some of your views or functions make use of deprecated PostGIS objects. In " +"order to fix this you may try loading legacy.sql script " +"prior to restore or you'll have to restore to a version of PostGIS which " +"still contains those objects and try a migration again after porting your " +"code. If the legacy.sql way works for you, don't forget " +"to fix your code to stop using deprecated functions and drop them loading " +"uninstall_legacy.sql." +msgstr "" + +#. Tag: para +#: installation.xml:1140 +#, no-c-format +msgid "" +"Some custom records of spatial_ref_sys in dump file have an invalid SRID " +"value. Valid SRID values are bigger than 0 and smaller than 999000. Values " +"in the 999000.999999 range are reserved for internal use while values > " +"999999 can't be used at all. All your custom records with invalid SRIDs will " +"be retained, with those > 999999 moved into the reserved range, but the " +"spatial_ref_sys table would loose a check constraint guarding for that " +"invariant to hold and possibly also its primary key ( when multiple invalid " +"SRIDS get converted to the same reserved SRID value )." +msgstr "" + +#. Tag: para +#: installation.xml:1154 +#, no-c-format +msgid "" +"In order to fix this you should copy your custom SRS to a SRID with a valid " +"value (maybe in the 910000..910999 range), convert all your tables to the " +"new srid (see ), delete the invalid " +"entry from spatial_ref_sys and re-construct the check(s) with:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1161 +#, no-c-format +msgid "" +"ALTER TABLE spatial_ref_sys ADD CONSTRAINT spatial_ref_sys_srid_check check " +"(srid > 0 AND srid < 999000 );" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1163 +#, no-c-format +msgid "ALTER TABLE spatial_ref_sys ADD PRIMARY KEY(srid));" +msgstr "" + +#. Tag: title +#: installation.xml:1174 +#, no-c-format +msgid "Common Problems" +msgstr "" + +#. Tag: para +#: installation.xml:1175 +#, no-c-format +msgid "" +"There are several things to check when your installation or upgrade doesn't " +"go as you expected." +msgstr "" + +#. Tag: para +#: installation.xml:1182 +#, no-c-format +msgid "" +"Check that you have installed PostgreSQL &min_postgres_version; or newer, " +"and that you are compiling against the same version of the PostgreSQL source " +"as the version of PostgreSQL that is running. Mix-ups can occur when your " +"(Linux) distribution has already installed PostgreSQL, or you have otherwise " +"installed PostgreSQL before and forgotten about it. PostGIS will only work " +"with PostgreSQL &min_postgres_version; or newer, and strange, unexpected " +"error messages will result if you use an older version. To check the version " +"of PostgreSQL which is running, connect to the database using psql and run " +"this query:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1195 +#, no-c-format +msgid "SELECT version();" +msgstr "" + +#. Tag: para +#: installation.xml:1197 +#, no-c-format +msgid "" +"If you are running an RPM based distribution, you can check for the " +"existence of pre-installed packages using the rpm command " +"as follows: rpm -qa | grep postgresql" +msgstr "" + +#. Tag: para +#: installation.xml:1205 +#, no-c-format +msgid "" +"If your upgrade fails, make sure you are restoring into a database that " +"already has PostGIS installed." +msgstr "" + +#. Tag: programlisting +#: installation.xml:1206 +#, no-c-format +msgid "SELECT postgis_full_version();" +msgstr "" + +#. Tag: para +#: installation.xml:1210 +#, no-c-format +msgid "" +"Also check that configure has correctly detected the location and version of " +"PostgreSQL, the Proj4 library and the GEOS library." +msgstr "" + +#. Tag: para +#: installation.xml:1217 +#, no-c-format +msgid "" +"The output from configure is used to generate the postgis_config." +"h file. Check that the POSTGIS_PGSQL_VERSION, " +"POSTGIS_PROJ_VERSION and POSTGIS_GEOS_VERSION variables have been set correctly." +msgstr "" + +#. Tag: title +#: installation.xml:1230 +#, no-c-format +msgid "JDBC" +msgstr "" + +#. Tag: para +#: installation.xml:1232 +#, no-c-format +msgid "" +"The JDBC extensions provide Java objects corresponding to the internal " +"PostGIS types. These objects can be used to write Java clients which query " +"the PostGIS database and draw or do calculations on the GIS data in PostGIS." +msgstr "" + +#. Tag: para +#: installation.xml:1241 +#, no-c-format +msgid "" +"Enter the java/jdbc sub-directory of the PostGIS " +"distribution." +msgstr "" + +#. Tag: para +#: installation.xml:1248 +#, no-c-format +msgid "" +"Run the ant command. Copy the postgis.jar file to wherever you keep your java libraries." +msgstr "" + +#. Tag: para +#: installation.xml:1256 +#, no-c-format +msgid "" +"The JDBC extensions require a PostgreSQL JDBC driver to be present in the " +"current CLASSPATH during the build process. If the PostgreSQL JDBC driver is " +"located elsewhere, you may pass the location of the JDBC driver JAR " +"separately using the -D parameter like this:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1263 +#, no-c-format +msgid "# ant -Dclasspath=/path/to/postgresql-jdbc.jar" +msgstr "" + +#. Tag: para +#: installation.xml:1265 +#, no-c-format +msgid "" +"PostgreSQL JDBC drivers can be downloaded from http://jdbc.postgresql.org ." +msgstr "" + +#. Tag: title +#: installation.xml:1275 +#, no-c-format +msgid "Loader/Dumper" +msgstr "" + +#. Tag: para +#: installation.xml:1277 +#, no-c-format +msgid "" +"The data loader and dumper are built and installed automatically as part of " +"the PostGIS build. To build and install them manually:" +msgstr "" + +#. Tag: programlisting +#: installation.xml:1282 +#, no-c-format +msgid "" +"# cd postgis-&last_release_version;/loader\n" +"# make\n" +"# make install" +msgstr "" + +#. Tag: para +#: installation.xml:1284 +#, no-c-format +msgid "" +"The loader is called shp2pgsql and converts ESRI Shape " +"files into SQL suitable for loading in PostGIS/PostgreSQL. The dumper is " +"called pgsql2shp and converts PostGIS tables (or " +"queries) into ESRI Shape files. For more verbose documentation, see the " +"online help, and the manual pages." +msgstr "" diff --git a/doc/po/pl/introduction.xml.po b/doc/po/pl/introduction.xml.po new file mode 100644 index 000000000..b6ebcfad5 --- /dev/null +++ b/doc/po/pl/introduction.xml.po @@ -0,0 +1,597 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# wotankeld , 2013 +# Mateusz Łoskot , 2013 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-12-07 13:59+0000\n" +"Last-Translator: wotankeld \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: introduction.xml:3 +#, no-c-format +msgid "Introduction" +msgstr "Wprowadzenie" + +#. Tag: para +#: introduction.xml:5 +#, no-c-format +msgid "" +"PostGIS was developed by Refractions Research Inc, as a spatial database " +"technology research project. Refractions is a GIS and database consulting " +"company in Victoria, British Columbia, Canada, specializing in data " +"integration and custom software development. We plan on supporting and " +"developing PostGIS to support a range of important GIS functionality, " +"including full OpenGIS support, advanced topological constructs (coverages, " +"surfaces, networks), desktop user interface tools for viewing and editing " +"GIS data, and web-based access tools." +msgstr "" +"PostGIS w ramach projektu badawczego prowadzonego przes firmę Refractions " +"Research Inc, którego celem było stworzenie bazy danych przestrzennych. " +"Refractions to kanadyjska firma z siedzibą w Wiktorii, Kolumbia Brytyjska, " +"która specjalizuje się w tworzeniu systemów informacji przestrzennej, baz " +"danych przestrzennych oraz rozwoju w oprogramowania celowego.\n" +"\n" +"Naszym zamiarem jest wspieranie projektu PostGIS dla rozwoju nowych funkcji " +"do analiz przestrzennych, zapewnienie wsparcia dla specyfikacji OpenGIS i " +"tworzenia zaawansowanych konstrukcji topologicznych (pokrycia, powierzchnie, " +"sieci) oraz dostarczenie przyjaznego interfejsu użytkownika do przeglądania " +"i edycji danych przestrzennych, jak również dostępu do danych online." + +#. Tag: para +#: introduction.xml:15 +#, no-c-format +msgid "" +"PostGIS is an incubation project of the OSGeo Foundation. PostGIS is being " +"continually improved and funded by many FOSS4G Developers as well as " +"corporations all over the world that gain great benefit from its " +"functionality and versatility." +msgstr "" +"PostGIS został zgłoszony do inkubatora projektów przy Fundacji OSGeo. " +"PostGIS podlega ciągłemu rozwojowi, które jest wspierane przez licznych " +"programistów i entuzjastów FOSS4G, jak również przez korporacje na całym " +"świecie, które doceniają funkcjonalność i wszechstronność PostGIS." + +#. Tag: title +#: introduction.xml:21 +#, no-c-format +msgid "Project Steering Committee" +msgstr "Komitet Wykonawczy Projektu" + +#. Tag: para +#: introduction.xml:22 +#, no-c-format +msgid "" +"The PostGIS Project Steering Committee (PSC) coordinates the general " +"direction, release cycles, documentation, and outreach efforts for the " +"PostGIS project. In addition the PSC provides general user support, accepts " +"and approves patches from the general PostGIS community and votes on " +"miscellaneous issues involving PostGIS such as developer commit access, new " +"PSC members or significant API changes." +msgstr "" +"W ramach projektu PostGIS, komitet wykonawczy (Project Steering Committee, " +"PSC) koordynuje generalny kierunek prac, cykl kolejnych wydań nowych wersji " +"oprogramowania, tworzenie dokumentacji, oraz adresuje potrzeby społeczności " +"skupionej wokół projektu PostGIS.\n" +"Dodatkowo, komitet przyjmuje, akceptuje i zatwierdza wszelkie zmiany " +"zgłaszane do projektu przez ogół użytkowników i programistów " +"zainteresowanych PostGIS. Komitet również przeprowadza głosowania nad " +"istotnymi decyzjami, takimi jak nadanie nowemu programiście praw zapisu do " +"repozytorium kodu źródłowego, zgłoszenie nowego członka do komitetu " +"wykonawczego lub istotnych zmian w interfejsie programowania aplikacji " +"(Application Programming Interface, API)." + +#. Tag: term +#: introduction.xml:31 +#, no-c-format +msgid "Mark Cave-Ayland" +msgstr "Mark Cave-Ayland" + +#. Tag: para +#: introduction.xml:33 +#, no-c-format +msgid "" +"Coordinates bug fixing and maintenance effort, alignment of PostGIS with " +"PostgreSQL releases, spatial index selectivity and binding, loader/dumper, " +"and Shapefile GUI Loader, integration of new and new function enhancements." +msgstr "" +"Koordynuje naprawę błędów i przyjmowanie poprawek, synchronizuje wydania " +"nowych wersji PostGIS wraz z wydaniami PostgreSQL, pracuje nad integracją " +"indeksów przestrzennych, programów ładujących i zrzucających dane, " +"tworzeniem graficznego programu Shapefile Loader oraz integrację nowych " +"funkcji i usprawnień." + +#. Tag: term +#: introduction.xml:40 +#, no-c-format +msgid "Regina Obe" +msgstr "Regina Obe" + +#. Tag: para +#: introduction.xml:42 +#, no-c-format +msgid "" +"Buildbot Maintenance, windows production and experimental builds, " +"Documentation, general user support on PostGIS newsgroup, X3D support, Tiger " +"Geocoder Support, management functions, and smoke testing new functionality " +"or major code changes." +msgstr "" + +#. Tag: term +#: introduction.xml:49 +#, no-c-format +msgid "Paul Ramsey (Chair)" +msgstr "Paul Ramsey (Lider)" + +#. Tag: para +#: introduction.xml:51 +#, no-c-format +msgid "" +"Co-founder of PostGIS project. General bug fixing, geography support, " +"geography and geometry index support (2D, 3D, nD index and anything spatial " +"index), underlying geometry internal structures, GEOS functionality " +"integration and alignment with GEOS releases, loader/dumper, and Shapefile " +"GUI loader." +msgstr "" +"Współzałożyciel projektu PostGIS. Ogólne poprawki błędów, wsparcie dla " +"danych geograficznych, wsparcie dla indeksów przestrzennych geometrycznych i " +"geograficznych (indeksy 2D, 3D, nD oraz pełny), wewnętrzne struktury dla " +"podstawowych typów geometrii, integracja funkcji GEOS oraz dostosowanie do " +"wersji GEOS, loader/dumper, GUI do ładowania plików Shapefile" + +#. Tag: term +#: introduction.xml:57 +#, no-c-format +msgid "Sandro Santilli" +msgstr "Sandro Santilli" + +#. Tag: para +#: introduction.xml:60 +#, no-c-format +msgid "" +"Bug fixes and maintenance and integration of new GEOS functionality and " +"alignment with GEOS releases, Topology support, and Raster framework and low " +"level api functions." +msgstr "" +"Poprawki błędów i utrzymaniowe, integracja nowych funkcji GEOS oraz " +"dostosowanie do różnych wersji GEOS, wsparcie dla topologii, framework dla " +"rastrów oraz funkcje api niskiego poziomu" + +#. Tag: title +#: introduction.xml:67 +#, no-c-format +msgid "Contributors Past and Present" +msgstr "Autorzy byli i obecni" + +#. Tag: term +#: introduction.xml:71 +#, no-c-format +msgid "Chris Hodgson" +msgstr "Chris Hodgson" + +#. Tag: para +#: introduction.xml:73 +#, no-c-format +msgid "" +"Prior PSC Member. General development, site and buildbot maintenance, OSGeo " +"incubation management" +msgstr "" + +#. Tag: term +#: introduction.xml:77 +#, no-c-format +msgid "Kevin Neufeld" +msgstr "Kevin Neufeld" + +#. Tag: para +#: introduction.xml:79 +#, no-c-format +msgid "" +"Prior PSC Member. Documentation and documentation support tools, advanced " +"user support on PostGIS newsgroup, and PostGIS maintenance function " +"enhancements." +msgstr "" + +#. Tag: term +#: introduction.xml:85 +#, no-c-format +msgid "Dave Blasby" +msgstr "Dave Blasby" + +#. Tag: para +#: introduction.xml:88 +#, no-c-format +msgid "" +"The original developer/Co-founder of PostGIS. Dave wrote the server side " +"objects, index bindings, and many of the server side analytical functions." +msgstr "" +"Developer / współzałożyciel projektu PostGIS. Dave przygotował obiekty po " +"stronie serwera, index bindings oraz wiele z funkcji analitycznych po " +"stronie serwera." + +#. Tag: term +#: introduction.xml:95 +#, no-c-format +msgid "Jeff Lounsbury" +msgstr "Jeff Lounsbury" + +#. Tag: para +#: introduction.xml:97 +#, no-c-format +msgid "" +"Original development of the Shape file loader/dumper. Current PostGIS " +"Project Owner representative." +msgstr "" + +#. Tag: term +#: introduction.xml:102 +#, no-c-format +msgid "Olivier Courtin" +msgstr "Olivier Courtin" + +#. Tag: para +#: introduction.xml:104 +#, no-c-format +msgid "Input output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes." +msgstr "" + +#. Tag: term +#: introduction.xml:109 +#, no-c-format +msgid "Mark Leslie" +msgstr "Mark Leslie" + +#. Tag: para +#: introduction.xml:111 +#, no-c-format +msgid "" +"Ongoing maintenance and development of core functions. Enhanced curve " +"support. Shapefile GUI loader." +msgstr "" + +#. Tag: term +#: introduction.xml:116 +#, no-c-format +msgid "Pierre Racine" +msgstr "Pierre Racine" + +#. Tag: para +#: introduction.xml:118 +#, no-c-format +msgid "Raster overall architecture, prototyping, programming support" +msgstr "" + +#. Tag: term +#: introduction.xml:123 +#, no-c-format +msgid "Nicklas Avén" +msgstr "Nicklas Avén" + +#. Tag: para +#: introduction.xml:126 +#, no-c-format +msgid "" +"Distance function enhancements (including 3D distance and relationship " +"functions) and additions, Windows testing, and general user support" +msgstr "" + +#. Tag: term +#: introduction.xml:131 +#, no-c-format +msgid "Jorge Arévalo" +msgstr "Jorge Arévalo" + +#. Tag: para +#: introduction.xml:134 +#, no-c-format +msgid "Raster development, GDAL driver support, loader" +msgstr "" + +#. Tag: term +#: introduction.xml:139 +#, no-c-format +msgid "Bborie Park" +msgstr "Bborie Park" + +#. Tag: para +#: introduction.xml:141 +#, no-c-format +msgid "Raster development, raster loader" +msgstr "" + +#. Tag: term +#: introduction.xml:146 +#, no-c-format +msgid "Mateusz Loskot" +msgstr "Mateusz Łoskot" + +#. Tag: para +#: introduction.xml:148 +#, no-c-format +msgid "Raster loader, low level raster api functions" +msgstr "" + +#. Tag: term +#: introduction.xml:153 +#, no-c-format +msgid "David Zwarg" +msgstr "David Zwarg" + +#. Tag: para +#: introduction.xml:156 +#, no-c-format +msgid "Raster development" +msgstr "" + +#. Tag: term +#: introduction.xml:161 +#, no-c-format +msgid "Other contributors: Individuals" +msgstr "Inni ofiarodawcy: osoby prywatne" + +#. Tag: para +#: introduction.xml:164 +#, no-c-format +msgid "" +"In alphabetical order: Alex Bodnaru, Alex Mayrhofer, Andrea Peri, Andreas " +"Forø Tollefsen, Andreas Neumann, Anne Ghisla, Barbara Phillipot, Ben Jubb, " +"Bernhard Reiter, Brian Hamlin, Bruce Rindahl, Bruno Wolff III, Bryce L. " +"Nordgren, Carl Anderson, Charlie Savage, Dane Springmeyer, David Skea, David " +"Techer, Eduin Carrillo, Even Rouault, Frank Warmerdam, George Silva, Gerald " +"Fenoy, Gino Lucrezi, Guillaume Lelarge, IIDA Tetsushi, Ingvild Nystuen, Jeff " +"Adams, Jose Carlos Martinez Llari, Kashif Rasul, Klaus Foerster, Kris Jurka, " +"Leo Hsu, Loic Dachary, Luca S. Percich, Maria Arias de Reyna, Mark Sondheim, " +"Markus Schaber, Maxime Guillaud, Maxime van Noppen, Michael Fuhr, Nikita " +"Shulga, Norman Vine, Rafal Magda, Ralph Mason, Richard Greenwood, Silvio " +"Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, Vincent Picavet" +msgstr "" +"W kolejności alfabetycznej: Alex Bodnaru, Alex Mayrhofer, Andrea Peri, " +"Andreas Forø Tollefsen, Andreas Neumann, Anne Ghisla, Barbara Phillipot, Ben " +"Jubb, Bernhard Reiter, Brian Hamlin, Bruce Rindahl, Bruno Wolff III, Bryce " +"L. Nordgren, Carl Anderson, Charlie Savage, Dane Springmeyer, David Skea, " +"David Techer, Eduin Carrillo, Even Rouault, Frank Warmerdam, George Silva, " +"Gerald Fenoy, Gino Lucrezi, Guillaume Lelarge, IIDA Tetsushi, Ingvild " +"Nystuen, Jeff Adams, Jose Carlos Martinez Llari, Kashif Rasul, Klaus " +"Foerster, Kris Jurka, Leo Hsu, Loic Dachary, Luca S. Percich, Maria Arias de " +"Reyna, Mark Sondheim, Markus Schaber, Maxime Guillaud, Maxime van Noppen, " +"Michael Fuhr, Nikita Shulga, Norman Vine, Rafal Magda, Ralph Mason, Richard " +"Greenwood, Silvio Grosso, Steffen Macke, Stephen Frost, Tom van Tilburg, " +"Vincent Picavet" + +#. Tag: term +#: introduction.xml:221 +#, no-c-format +msgid "Other contributors: Corporate Sponsors" +msgstr "Inni ofiarodawcy: sponsorzy korporacyjni" + +#. Tag: para +#: introduction.xml:224 +#, no-c-format +msgid "" +"These are corporate entities that have contributed developer time, hosting, " +"or direct monetary funding to the PostGIS project" +msgstr "" +"Podmioty korporacyjne, które wniosły wkład do projektu PostGIS w postaci " +"developmentu, hostingu lub wsparcia finansowego" + +#. Tag: para +#: introduction.xml:225 +#, no-c-format +msgid "" +"In alphabetical order: Arrival 3D, Associazione Italiana per l'Informazione " +"Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, Cadcorp, CampToCamp, " +"City of Boston (DND), Clever Elephant Solutions, Cooperativa Alveo, Deimos " +"Space, Faunalia, Geographic Data BC, Hunter Systems Group, Lidwala " +"Consulting Engineers, LisaSoft, Logical Tracking & Tracing International " +"AG, Michigan Tech Research Institute, Norwegian Forest and Landscape " +"Institute, OpenGeo, OSGeo, Oslandia, Paragon Corporation, R3 GIS,, " +"Refractions Research, Regione Toscana-SIGTA, Safe Software, Sirius " +"Corporation plc, Stadt Uster, UC Davis Center for Vectorborne Diseases, " +"University of Laval, U.S Department of State (HIU), Vizzuality, Zonar Systems" +msgstr "" +"W kolejności alfabetycznej: Arrival 3D, Associazione Italiana per " +"l'Informazione Geografica Libera (GFOSS.it), AusVet, Avencia, Azavea, " +"Cadcorp, CampToCamp, City of Boston (DND), Clever Elephant Solutions, " +"Cooperativa Alveo, Deimos Space, Faunalia, Geographic Data BC, Hunter " +"Systems Group, Lidwala Consulting Engineers, LisaSoft, Logical Tracking " +"& Tracing International AG, Michigan Tech Research Institute, Norwegian " +"Forest and Landscape Institute, OpenGeo, OSGeo, Oslandia, Paragon " +"Corporation, R3 GIS,, Refractions Research, Regione Toscana-SIGTA, Safe " +"Software, Sirius Corporation plc, Stadt Uster, UC Davis Center for " +"Vectorborne Diseases, University of Laval, U.S Department of State (HIU), " +"Vizzuality, Zonar Systems" + +#. Tag: term +#: introduction.xml:265 +#, no-c-format +msgid "Crowd Funding Campaigns" +msgstr "Kampanie corwdfundingowe" + +#. Tag: para +#: introduction.xml:268 +#, no-c-format +msgid "" +"Crowd funding campaigns are campaigns we run to get badly wanted features " +"funded that can service a large number of people. Each campaign is " +"specifically focused on a particular feature or set of features. Each " +"sponsor chips in a small fraction of the needed funding and with enough " +"people/organizations contributing, we have the funds to pay for the work " +"that will help many. If you have an idea for a feature you think many others " +"would be willing to co-fund, please post to the PostGIS newsgroup your " +"thoughts and together we can make it happen." +msgstr "" +"Kampanie crowdfundingowe są organizowane aby pozyskać fundusze na rozwój " +"najpotrzebniejszych funkcji, które służą dużej liczbie użytkowników. Każda " +"kampania skupia się na konkretnej funkcji lub grupie funkcji. Każdy sponsor " +"wpłaca małą część potrzebnych środków i przy udziale odpowiedniej liczby " +"ludzi/organizacji uzyskujemy wystarczającą ilość środków, aby opłacić pracę, " +"z której rezultatów skorzysta wiele osób. Jeśli masz pomysł na funkcję i " +"uważasz, że inni byli by skłonni wesprzeć jej rozwój finansowo opisz swój " +"pomysł na PostGIS newsgroup i razem możemy sprawić, że Twój pomysł zostanie " +"zrealizowany." + +#. Tag: para +#: introduction.xml:269 +#, no-c-format +msgid "" +"PostGIS 2.0.0 was the first release we tried this strategy. We used PledgeBank and we got two " +"successful campaigns out of it." +msgstr "" +"PostGIS 2.0.0 był pierwszym wydaniem, w którym wypróbowaliśmy taką " +"strategię. Skorzystaliśmy z PledgeBank i przeprowadzilśmy dwie udane kampanie." + +#. Tag: para +#: introduction.xml:270 +#, no-c-format +msgid "" +"postgistopology - 10 plus sponsors each " +"contributed $250 USD to build toTopoGeometry function and beef up topology " +"support in 2.0.0. It happened." +msgstr "" +"postgistopology - ponad 10 sponsorów wpłaciło " +"po 250$ w celu stworzenia funkcji toTopoGeometry oraz rozbudowy wsparcia dla " +"topologii w wersji 2.0.0. To naprawdę się wydarzyło." + +#. Tag: para +#: introduction.xml:271 +#, no-c-format +msgid "" +"postgis64windows - 20 someodd sponsors each " +"contributed $100 USD to pay for the work needed to work out PostGIS 64-bit " +"on windows issues. It happened. We now have a 64-bit beta release for " +"PostGIS 2.0.0 and a final one planned for release that will be available on " +"PostgreSQL stack builder." +msgstr "" + +#. Tag: term +#: introduction.xml:276 +#, no-c-format +msgid "Important Support Libraries" +msgstr "Istotne biblioteki wspierające" + +#. Tag: para +#: introduction.xml:279 +#, no-c-format +msgid "" +"The GEOS geometry " +"operations library, and the algorithmic work of Martin Davis in making it " +"all work, ongoing maintenance and support of Mateusz Loskot, Sandro Santilli " +"(strk), Paul Ramsey and others." +msgstr "" + +#. Tag: para +#: introduction.xml:284 +#, no-c-format +msgid "" +"The GDAL Geospatial Data " +"Abstraction Library, by Frank Warmerdam and others is used to power much of " +"the raster functionality introduced in PostGIS 2.0.0. In kind, improvements " +"needed in GDAL to support PostGIS are contributed back to the GDAL project." +msgstr "" + +#. Tag: para +#: introduction.xml:289 +#, no-c-format +msgid "" +"The Proj4 cartographic " +"projection library, and the work of Gerald Evenden and Frank Warmerdam in " +"creating and maintaining it." +msgstr "" + +#. Tag: para +#: introduction.xml:293 +#, no-c-format +msgid "" +"Last but not least, the PostgreSQL " +"DBMS, The giant that PostGIS stands on. Much of the speed and " +"flexibility of PostGIS would not be possible without the extensibility, " +"great query planner, GIST index, and plethora of SQL features provided by " +"PostgreSQL." +msgstr "" + +#. Tag: title +#: introduction.xml:302 +#, no-c-format +msgid "More Information" +msgstr "Więcej informacji" + +#. Tag: para +#: introduction.xml:306 +#, no-c-format +msgid "" +"The latest software, documentation and news items are available at the " +"PostGIS web site, http://www.postgis." +"org." +msgstr "" + +#. Tag: para +#: introduction.xml:312 +#, no-c-format +msgid "" +"More information about the GEOS geometry operations library is available " +"at http://trac.osgeo.org/geos/." +msgstr "" + +#. Tag: para +#: introduction.xml:318 +#, no-c-format +msgid "" +"More information about the Proj4 reprojection library is available at http://trac.osgeo.org/proj/." +msgstr "" + +#. Tag: para +#: introduction.xml:324 +#, no-c-format +msgid "" +"More information about the PostgreSQL database server is available at the " +"PostgreSQL main site http://www." +"postgresql.org." +msgstr "" + +#. Tag: para +#: introduction.xml:330 +#, no-c-format +msgid "" +"More information about GiST indexing is available at the PostgreSQL GiST " +"development site, http://www.sai.msu.su/~megera/postgres/gist/." +msgstr "" + +#. Tag: para +#: introduction.xml:336 +#, no-c-format +msgid "" +"More information about MapServer internet map server is available at http://mapserver.org." +msgstr "" + +#. Tag: para +#: introduction.xml:342 +#, no-c-format +msgid "" +"The "Simple " +"Features for Specification for SQL" is available at the OpenGIS " +"Consortium web site: http://" +"www.opengeospatial.org/." +msgstr "" diff --git a/doc/po/pl/performance_tips.xml.po b/doc/po/pl/performance_tips.xml.po new file mode 100644 index 000000000..abfac579b --- /dev/null +++ b/doc/po/pl/performance_tips.xml.po @@ -0,0 +1,465 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: performance_tips.xml:3 +#, no-c-format +msgid "Performance tips" +msgstr "" + +#. Tag: title +#: performance_tips.xml:6 +#, no-c-format +msgid "Small tables of large geometries" +msgstr "" + +#. Tag: title +#: performance_tips.xml:9 +#, no-c-format +msgid "Problem description" +msgstr "" + +#. Tag: para +#: performance_tips.xml:11 +#, no-c-format +msgid "" +"Current PostgreSQL versions (including 8.0) suffer from a query optimizer " +"weakness regarding TOAST tables. TOAST tables are a kind of \"extension room" +"\" used to store large (in the sense of data size) values that do not fit " +"into normal data pages (like long texts, images or complex geometries with " +"lots of vertices), see the PostgreSQL Documentation for TOAST " +"for more information)." +msgstr "" + +#. Tag: para +#: performance_tips.xml:19 +#, no-c-format +msgid "" +"The problem appears if you happen to have a table with rather large " +"geometries, but not too much rows of them (like a table containing the " +"boundaries of all European countries in high resolution). Then the table " +"itself is small, but it uses lots of TOAST space. In our example case, the " +"table itself had about 80 rows and used only 3 data pages, but the TOAST " +"table used 8225 pages." +msgstr "" + +#. Tag: para +#: performance_tips.xml:26 +#, no-c-format +msgid "" +"Now issue a query where you use the geometry operator && to search " +"for a bounding box that matches only very few of those rows. Now the query " +"optimizer sees that the table has only 3 pages and 80 rows. He estimates " +"that a sequential scan on such a small table is much faster than using an " +"index. And so he decides to ignore the GIST index. Usually, this estimation " +"is correct. But in our case, the && operator has to fetch every " +"geometry from disk to compare the bounding boxes, thus reading all TOAST " +"pages, too." +msgstr "" + +#. Tag: para +#: performance_tips.xml:35 +#, no-c-format +msgid "" +"To see whether your suffer from this bug, use the \"EXPLAIN ANALYZE\" " +"postgresql command. For more information and the technical details, you can " +"read the thread on the postgres performance mailing list: http://archives." +"postgresql.org/pgsql-performance/2005-02/msg00030.php" +msgstr "" + +#. Tag: title +#: performance_tips.xml:43 +#, no-c-format +msgid "Workarounds" +msgstr "" + +#. Tag: para +#: performance_tips.xml:45 +#, no-c-format +msgid "" +"The PostgreSQL people are trying to solve this issue by making the query " +"estimation TOAST-aware. For now, here are two workarounds:" +msgstr "" + +#. Tag: para +#: performance_tips.xml:48 +#, no-c-format +msgid "" +"The first workaround is to force the query planner to use the index. Send " +"\"SET enable_seqscan TO off;\" to the server before issuing the query. This " +"basically forces the query planner to avoid sequential scans whenever " +"possible. So it uses the GIST index as usual. But this flag has to be set on " +"every connection, and it causes the query planner to make misestimations in " +"other cases, so you should \"SET enable_seqscan TO on;\" after the query." +msgstr "" + +#. Tag: para +#: performance_tips.xml:56 +#, no-c-format +msgid "" +"The second workaround is to make the sequential scan as fast as the query " +"planner thinks. This can be achieved by creating an additional column that " +"\"caches\" the bbox, and matching against this. In our example, the commands " +"are like:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:61 +#, no-c-format +msgid "" +"SELECT " +"AddGeometryColumn('myschema','mytable','bbox','4326','GEOMETRY','2'); \n" +"UPDATE mytable SET bbox = ST_Envelope(ST_Force_2d(the_geom));" +msgstr "" + +#. Tag: para +#: performance_tips.xml:63 +#, no-c-format +msgid "" +"Now change your query to use the && operator against bbox instead of " +"geom_column, like:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:66 +#, no-c-format +msgid "" +"SELECT geom_column \n" +"FROM mytable \n" +"WHERE bbox && ST_SetSRID('BOX3D(0 0,1 1)'::box3d,4326);" +msgstr "" + +#. Tag: para +#: performance_tips.xml:68 +#, no-c-format +msgid "" +"Of course, if you change or add rows to mytable, you have to keep the bbox " +"\"in sync\". The most transparent way to do this would be triggers, but you " +"also can modify your application to keep the bbox column current or run the " +"UPDATE query above after every modification." +msgstr "" + +#. Tag: title +#: performance_tips.xml:77 +#, no-c-format +msgid "CLUSTERing on geometry indices" +msgstr "" + +#. Tag: para +#: performance_tips.xml:79 +#, no-c-format +msgid "" +"For tables that are mostly read-only, and where a single index is used for " +"the majority of queries, PostgreSQL offers the CLUSTER command. This command " +"physically reorders all the data rows in the same order as the index " +"criteria, yielding two performance advantages: First, for index range scans, " +"the number of seeks on the data table is drastically reduced. Second, if " +"your working set concentrates to some small intervals on the indices, you " +"have a more efficient caching because the data rows are spread along fewer " +"data pages. (Feel invited to read the CLUSTER command documentation from the " +"PostgreSQL manual at this point.)" +msgstr "" + +#. Tag: para +#: performance_tips.xml:89 +#, no-c-format +msgid "" +"However, currently PostgreSQL does not allow clustering on PostGIS GIST " +"indices because GIST indices simply ignores NULL values, you get an error " +"message like:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:93 +#, no-c-format +msgid "" +"lwgeom=# CLUSTER my_geom_index ON my_table; \n" +"ERROR: cannot cluster when index access method does not handle null values\n" +"HINT: You may be able to work around this by marking column \"the_geom\" NOT " +"NULL." +msgstr "" + +#. Tag: para +#: performance_tips.xml:95 +#, no-c-format +msgid "" +"As the HINT message tells you, one can work around this deficiency by adding " +"a \"not null\" constraint to the table:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:98 +#, no-c-format +msgid "" +"lwgeom=# ALTER TABLE my_table ALTER COLUMN the_geom SET not null; \n" +"ALTER TABLE" +msgstr "" + +#. Tag: para +#: performance_tips.xml:100 +#, no-c-format +msgid "" +"Of course, this will not work if you in fact need NULL values in your " +"geometry column. Additionally, you must use the above method to add the " +"constraint, using a CHECK constraint like \"ALTER TABLE blubb ADD CHECK " +"(geometry is not null);\" will not work." +msgstr "" + +#. Tag: title +#: performance_tips.xml:107 +#, no-c-format +msgid "Avoiding dimension conversion" +msgstr "" + +#. Tag: para +#: performance_tips.xml:109 +#, no-c-format +msgid "" +"Sometimes, you happen to have 3D or 4D data in your table, but always access " +"it using OpenGIS compliant ST_AsText() or ST_AsBinary() functions that only " +"output 2D geometries. They do this by internally calling the ST_Force_2d() " +"function, which introduces a significant overhead for large geometries. To " +"avoid this overhead, it may be feasible to pre-drop those additional " +"dimensions once and forever:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:116 +#, no-c-format +msgid "" +"UPDATE mytable SET the_geom = ST_Force_2d(the_geom); \n" +"VACUUM FULL ANALYZE mytable;" +msgstr "" + +#. Tag: para +#: performance_tips.xml:118 +#, no-c-format +msgid "" +"Note that if you added your geometry column using AddGeometryColumn() " +"there'll be a constraint on geometry dimension. To bypass it you will need " +"to drop the constraint. Remember to update the entry in the geometry_columns " +"table and recreate the constraint afterwards." +msgstr "" + +#. Tag: para +#: performance_tips.xml:124 +#, no-c-format +msgid "" +"In case of large tables, it may be wise to divide this UPDATE into smaller " +"portions by constraining the UPDATE to a part of the table via a WHERE " +"clause and your primary key or another feasible criteria, and running a " +"simple \"VACUUM;\" between your UPDATEs. This drastically reduces the need " +"for temporary disk space. Additionally, if you have mixed dimension " +"geometries, restricting the UPDATE by \"WHERE dimension(the_geom)>2\" " +"skips re-writing of geometries that already are in 2D." +msgstr "" + +#. Tag: title +#: performance_tips.xml:136 +#, no-c-format +msgid "Tuning your configuration" +msgstr "" + +#. Tag: para +#: performance_tips.xml:138 +#, no-c-format +msgid "" +"These tips are taken from Kevin Neufeld's presentation \"Tips for the " +"PostGIS Power User\" at the FOSS4G 2007 conference. Depending on your use of " +"PostGIS (for example, static data and complex analysis vs frequently updated " +"data and lots of users) these changes can provide significant speedups to " +"your queries." +msgstr "" + +#. Tag: para +#: performance_tips.xml:144 +#, no-c-format +msgid "" +"For a more tips (and better formatting), the original presentation is at " +" http://2007.foss4g.org/presentations/view.php?" +"abstract_id=117." +msgstr "" + +#. Tag: title +#: performance_tips.xml:151 +#, no-c-format +msgid "Startup" +msgstr "" + +#. Tag: para +#: performance_tips.xml:153 +#, no-c-format +msgid "These settings are configured in postgresql.conf:" +msgstr "" + +#. Tag: ulink +#: performance_tips.xml:158 +#, no-c-format +msgid "checkpoint_segments" +msgstr "" + +#. Tag: para +#: performance_tips.xml:163 +#, no-c-format +msgid "" +"Maximum number of log file segments between automatic WAL checkpoints (each " +"segment is normally 16MB); default is 3" +msgstr "" + +#. Tag: para +#: performance_tips.xml:169 +#, no-c-format +msgid "" +"Set to at least 10 or 30 for databases with heavy write activity, or more " +"for large database loads. Another article on the topic worth reading Greg Smith: Checkpoint and Background writer" +msgstr "" + +#. Tag: para +#: performance_tips.xml:175 +#, no-c-format +msgid "Possibly store the xlog on a separate disk device" +msgstr "" + +#. Tag: ulink +#: performance_tips.xml:182 +#, no-c-format +msgid "constraint_exclusion" +msgstr "" + +#. Tag: para +#: performance_tips.xml:187 +#, no-c-format +msgid "" +"Default: off (prior to PostgreSQL 8.4 and for PostgreSQL 8.4+ is set to " +"partition)" +msgstr "" + +#. Tag: para +#: performance_tips.xml:192 +#, no-c-format +msgid "" +"This is generally used for table partitioning. If you are running PostgreSQL " +"versions below 8.4, set to \"on\" to ensure the query planner will optimize " +"as desired. As of PostgreSQL 8.4, the default for this is set to \"partition" +"\" which is ideal for PostgreSQL 8.4 and above since it will force the " +"planner to only analyze tables for constraint consideration if they are in " +"an inherited hierarchy and not pay the planner penalty otherwise." +msgstr "" + +#. Tag: ulink +#: performance_tips.xml:202 +#, no-c-format +msgid "shared_buffers" +msgstr "" + +#. Tag: para +#: performance_tips.xml:207 +#, no-c-format +msgid "Default: ~32MB" +msgstr "" + +#. Tag: para +#: performance_tips.xml:212 +#, no-c-format +msgid "Set to about 1/3 to 3/4 of available RAM" +msgstr "" + +#. Tag: title +#: performance_tips.xml:220 +#, no-c-format +msgid "Runtime" +msgstr "" + +#. Tag: para +#: performance_tips.xml:222 +#, no-c-format +msgid "" +"work_mem (the memory used for sort " +"operations and complex queries)" +msgstr "" + +#. Tag: para +#: performance_tips.xml:228 +#, no-c-format +msgid "Default: 1MB" +msgstr "" + +#. Tag: para +#: performance_tips.xml:233 +#, no-c-format +msgid "Adjust up for large dbs, complex queries, lots of RAM" +msgstr "" + +#. Tag: para +#: performance_tips.xml:238 +#, no-c-format +msgid "Adjust down for many concurrent users or low RAM." +msgstr "" + +#. Tag: para +#: performance_tips.xml:243 +#, no-c-format +msgid "If you have lots of RAM and few developers:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:245 +#, no-c-format +msgid "SET work_mem TO 1200000;" +msgstr "" + +#. Tag: para +#: performance_tips.xml:250 +#, no-c-format +msgid "" +"maintenance_work_mem (used " +"for VACUUM, CREATE INDEX, etc.)" +msgstr "" + +#. Tag: para +#: performance_tips.xml:256 +#, no-c-format +msgid "Default: 16MB" +msgstr "" + +#. Tag: para +#: performance_tips.xml:261 +#, no-c-format +msgid "Generally too low - ties up I/O, locks objects while swapping memory" +msgstr "" + +#. Tag: para +#: performance_tips.xml:266 +#, no-c-format +msgid "" +"Recommend 32MB to 256MB on production servers w/lots of RAM, but depends on " +"the # of concurrent users. If you have lots of RAM and few developers:" +msgstr "" + +#. Tag: programlisting +#: performance_tips.xml:269 +#, no-c-format +msgid "SET maintainence_work_mem TO 1200000;" +msgstr "" diff --git a/doc/po/pl/postgis.xml.po b/doc/po/pl/postgis.xml.po new file mode 100644 index 000000000..8dddbb29c --- /dev/null +++ b/doc/po/pl/postgis.xml.po @@ -0,0 +1,77 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2014-10-14 22:30+0000\n" +"PO-Revision-Date: 2014-10-14 22:36+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: postgis.xml:127 +#, no-c-format +msgid "PostGIS &last_release_version; Manual" +msgstr "PostGIS &last_release_version;. Podręcznik" + +#. Tag: corpauthor +#: postgis.xml:131 +#, no-c-format +msgid "The PostGIS Development Group" +msgstr "" + +#. Tag: affiliation +#: postgis.xml:137 +#, no-c-format +msgid "" +"clever elephant
Victoria British Columbia Canada pramsey@cleverelephant.ca" +msgstr "" +"clever elephant
Victoria British Columbia Canada pramsey@cleverelephant.ca" + +#. Tag: para +#: postgis.xml:151 +#, no-c-format +msgid "" +"PostGIS is an extension to the PostgreSQL object-relational database system " +"which allows GIS (Geographic Information Systems) objects to be stored in " +"the database. PostGIS includes support for GiST-based R-Tree spatial " +"indexes, and functions for analysis and processing of GIS objects." +msgstr "" +"PostGIS jest rozszerzeniem relacyjno-obiektowego systemu bazy danych " +"PostgreSQL, który pozwala na przechowywanie obiektów GIS (Geographic " +"Information Systems) w bazie danych. PostGIS posiada wsparcie dla indeksów " +"przestrzennych opartych na algorytmach GiST i R-Tree, oraz funkcje " +"pozwalające na analizowanie i przetwarzanie obiektów GIS." + +#. Tag: para +#: postgis.xml:160 +#, no-c-format +msgid "This is the manual for version &last_release_version;" +msgstr "Podręcznik dla wersji &last_release_version;" + +#. Tag: para +#: postgis.xml:161 +#, no-c-format +msgid "" +"This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License. Feel free to use this material any way you like, but we ask that you " +"attribute credit to the PostGIS Project and wherever possible, a link back " +"to http://postgis.net." +msgstr "" diff --git a/doc/po/pl/reference.xml.po b/doc/po/pl/reference.xml.po new file mode 100644 index 000000000..55fdbd637 --- /dev/null +++ b/doc/po/pl/reference.xml.po @@ -0,0 +1,57 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference.xml:3 +#, no-c-format +msgid "PostGIS Reference" +msgstr "" + +#. Tag: para +#: reference.xml:5 +#, no-c-format +msgid "" +"The functions given below are the ones which a user of PostGIS is likely to " +"need. There are other functions which are required support functions to the " +"PostGIS objects which are not of use to a general user." +msgstr "" + +#. Tag: para +#: reference.xml:11 +#, no-c-format +msgid "" +"PostGIS has begun a transition from the existing naming convention to an SQL-" +"MM-centric convention. As a result, most of the functions that you know and " +"love have been renamed using the standard spatial type (ST) prefix. Previous " +"functions are still available, though are not listed in this document where " +"updated functions are equivalent. The non ST_ functions not listed in this " +"documentation are deprecated and will be removed in a future release so STOP " +"USING THEM." +msgstr "" + +#. Tag: chapter +#: reference.xml:16 +#, no-c-format +msgid "" +"&reference_type; &reference_management; &reference_constructor; " +"&reference_accessor; &reference_editor; &reference_output; " +"&reference_operator; &reference_measure; &reference_processing; " +"&reference_lrs; &reference_transaction; &reference_misc; " +"&reference_exception;" +msgstr "" diff --git a/doc/po/pl/reference_accessor.xml.po b/doc/po/pl/reference_accessor.xml.po new file mode 100644 index 000000000..93d484dcc --- /dev/null +++ b/doc/po/pl/reference_accessor.xml.po @@ -0,0 +1,3342 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_accessor.xml:4 +#, no-c-format +msgid "Geometry Accessors" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:8 +#, no-c-format +msgid "GeometryType" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:10 +#, no-c-format +msgid "" +"Returns the type of the geometry as a string. Eg: 'LINESTRING', " +"'POLYGON', 'MULTIPOINT', etc." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:16 +#, no-c-format +msgid "" +"text GeometryType " +"geometry geomA" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:24 reference_accessor.xml:81 +#: reference_accessor.xml:128 reference_accessor.xml:176 +#: reference_accessor.xml:224 reference_accessor.xml:273 +#: reference_accessor.xml:325 reference_accessor.xml:374 +#: reference_accessor.xml:435 reference_accessor.xml:486 +#: reference_accessor.xml:545 reference_accessor.xml:604 +#: reference_accessor.xml:659 reference_accessor.xml:703 +#: reference_accessor.xml:754 reference_accessor.xml:811 +#: reference_accessor.xml:876 reference_accessor.xml:928 +#: reference_accessor.xml:987 reference_accessor.xml:1033 +#: reference_accessor.xml:1068 reference_accessor.xml:1107 +#: reference_accessor.xml:1147 reference_accessor.xml:1193 +#: reference_accessor.xml:1232 reference_accessor.xml:1265 +#: reference_accessor.xml:1306 reference_accessor.xml:1350 +#: reference_accessor.xml:1407 reference_accessor.xml:1460 +#: reference_accessor.xml:1503 reference_accessor.xml:1554 +#: reference_accessor.xml:1618 reference_accessor.xml:1661 +#: reference_accessor.xml:1706 reference_accessor.xml:1752 +#: reference_accessor.xml:1794 reference_accessor.xml:1839 +#: reference_accessor.xml:1885 reference_accessor.xml:1927 +#: reference_accessor.xml:1973 reference_accessor.xml:2014 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:26 +#, no-c-format +msgid "" +"Returns the type of the geometry as a string. Eg: 'LINESTRING', " +"'POLYGON', 'MULTIPOINT', etc." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:29 +#, no-c-format +msgid "" +"OGC SPEC s2.1.1.1 - Returns the name of the instantiable subtype of Geometry " +"of which this Geometry instance is a member. The name of the instantiable " +"subtype of Geometry is returned as a string." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:35 +#, no-c-format +msgid "" +"This function also indicates if the geometry is measured, by returning a " +"string of the form 'POINTM'." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:38 reference_accessor.xml:388 +#: reference_accessor.xml:1152 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:39 reference_accessor.xml:134 +#: reference_accessor.xml:390 reference_accessor.xml:497 +#: reference_accessor.xml:550 reference_accessor.xml:830 +#: reference_accessor.xml:996 reference_accessor.xml:1272 +#: reference_accessor.xml:1314 reference_accessor.xml:1423 +#: reference_accessor.xml:1757 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:40 reference_accessor.xml:136 +#: reference_accessor.xml:393 reference_accessor.xml:559 +#: reference_accessor.xml:624 reference_accessor.xml:670 +#: reference_accessor.xml:1074 reference_accessor.xml:1112 +#: reference_accessor.xml:1426 reference_accessor.xml:1468 +#: reference_accessor.xml:1671 reference_accessor.xml:1716 +#: reference_accessor.xml:1804 reference_accessor.xml:1849 +#: reference_accessor.xml:1937 reference_accessor.xml:1979 +#: reference_accessor.xml:2024 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:41 reference_accessor.xml:96 +#: reference_accessor.xml:137 reference_accessor.xml:231 +#: reference_accessor.xml:334 reference_accessor.xml:392 +#: reference_accessor.xml:441 reference_accessor.xml:499 +#: reference_accessor.xml:558 reference_accessor.xml:623 +#: reference_accessor.xml:768 reference_accessor.xml:998 +#: reference_accessor.xml:1038 reference_accessor.xml:1073 +#: reference_accessor.xml:1111 reference_accessor.xml:1156 +#: reference_accessor.xml:1271 reference_accessor.xml:1367 +#: reference_accessor.xml:1425 reference_accessor.xml:1510 +#: reference_accessor.xml:1626 reference_accessor.xml:1670 +#: reference_accessor.xml:1715 reference_accessor.xml:1759 +#: reference_accessor.xml:1803 reference_accessor.xml:1848 +#: reference_accessor.xml:1893 reference_accessor.xml:1936 +#: reference_accessor.xml:1978 reference_accessor.xml:2023 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:42 reference_accessor.xml:138 +#: reference_accessor.xml:189 reference_accessor.xml:394 +#: reference_accessor.xml:442 reference_accessor.xml:562 +#: reference_accessor.xml:1075 reference_accessor.xml:1157 +#: reference_accessor.xml:1274 reference_accessor.xml:1368 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:43 reference_accessor.xml:139 +#: reference_accessor.xml:190 reference_accessor.xml:395 +#: reference_accessor.xml:1158 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:49 reference_accessor.xml:100 +#: reference_accessor.xml:144 reference_accessor.xml:194 +#: reference_accessor.xml:241 reference_accessor.xml:295 +#: reference_accessor.xml:339 reference_accessor.xml:447 +#: reference_accessor.xml:505 reference_accessor.xml:629 +#: reference_accessor.xml:677 reference_accessor.xml:722 +#: reference_accessor.xml:773 reference_accessor.xml:837 +#: reference_accessor.xml:893 reference_accessor.xml:953 +#: reference_accessor.xml:1004 reference_accessor.xml:1042 +#: reference_accessor.xml:1080 reference_accessor.xml:1117 +#: reference_accessor.xml:1163 reference_accessor.xml:1204 +#: reference_accessor.xml:1278 reference_accessor.xml:1319 +#: reference_accessor.xml:1374 reference_accessor.xml:1432 +#: reference_accessor.xml:1473 reference_accessor.xml:1520 +#: reference_accessor.xml:1574 reference_accessor.xml:1632 +#: reference_accessor.xml:1676 reference_accessor.xml:1721 +#: reference_accessor.xml:1765 reference_accessor.xml:1809 +#: reference_accessor.xml:1854 reference_accessor.xml:1898 +#: reference_accessor.xml:1942 reference_accessor.xml:1984 +#: reference_accessor.xml:2029 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:51 +#, no-c-format +msgid "" +"SELECT GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " +"29.26,77.27 29.31,77.29 29.07)'));\n" +" geometrytype\n" +"--------------\n" +" LINESTRING" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:52 +#, no-c-format +msgid "" +"SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 " +"1 1, 0 1 0, 0 0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 " +"1, 0 0 1, 0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 " +"1, 0 1 1, 0 0 1)) )'));\n" +" --result\n" +" POLYHEDRALSURFACE" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:53 +#, no-c-format +msgid "" +"SELECT GeometryType(geom) as result\n" +" FROM\n" +" (SELECT \n" +" ST_GeomFromEWKT('TIN (((\n" +" 0 0 0, \n" +" 0 0 1, \n" +" 0 1 0, \n" +" 0 0 0\n" +" )), ((\n" +" 0 0 0, \n" +" 0 1 0, \n" +" 1 1 0, \n" +" 0 0 0\n" +" ))\n" +" )') AS geom\n" +" ) AS g;\n" +" result\n" +"--------\n" +" TIN" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:58 reference_accessor.xml:105 +#: reference_accessor.xml:151 reference_accessor.xml:199 +#: reference_accessor.xml:247 reference_accessor.xml:300 +#: reference_accessor.xml:344 reference_accessor.xml:414 +#: reference_accessor.xml:458 reference_accessor.xml:512 +#: reference_accessor.xml:579 reference_accessor.xml:635 +#: reference_accessor.xml:728 reference_accessor.xml:779 +#: reference_accessor.xml:843 reference_accessor.xml:900 +#: reference_accessor.xml:960 reference_accessor.xml:1010 +#: reference_accessor.xml:1047 reference_accessor.xml:1085 +#: reference_accessor.xml:1124 reference_accessor.xml:1168 +#: reference_accessor.xml:1209 reference_accessor.xml:1243 +#: reference_accessor.xml:1283 reference_accessor.xml:1324 +#: reference_accessor.xml:1381 reference_accessor.xml:1438 +#: reference_accessor.xml:1478 reference_accessor.xml:1526 +#: reference_accessor.xml:1580 reference_accessor.xml:1638 +#: reference_accessor.xml:1683 reference_accessor.xml:1728 +#: reference_accessor.xml:1771 reference_accessor.xml:1816 +#: reference_accessor.xml:1861 reference_accessor.xml:1904 +#: reference_accessor.xml:1949 reference_accessor.xml:1991 +#: reference_accessor.xml:2036 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:64 +#, no-c-format +msgid "ST_Boundary" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:66 +#, no-c-format +msgid "Returns the closure of the combinatorial boundary of this Geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:72 +#, no-c-format +msgid "" +"geometry ST_Boundary " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:83 +#, no-c-format +msgid "" +"Returns the closure of the combinatorial boundary of this Geometry. The " +"combinatorial boundary is defined as described in section 3.12.3.2 of the " +"OGC SPEC. Because the result of this function is a closure, and hence " +"topologically closed, the resulting boundary can be represented using " +"representational geometry primitives as discussed in the OGC SPEC, section " +"3.12.2." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:90 +#, no-c-format +msgid "Performed by the GEOS module" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:92 +#, no-c-format +msgid "" +"Prior to 2.0.0, this function throws an exception if used with " +"GEOMETRYCOLLECTION. From 2.0.0 up it will return NULL " +"instead (unsupported input)." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:94 +#, no-c-format +msgid "&sfs_compliant; OGC SPEC s2.1.1.1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:95 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.14" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:102 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Boundary(ST_GeomFromText('LINESTRING(1 1,0 0, -1 " +"1)')));\n" +"st_astext\n" +"-----------\n" +"MULTIPOINT(1 1,-1 1)\n" +"\n" +"SELECT ST_AsText(ST_Boundary(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 " +"1))')));\n" +"st_astext\n" +"----------\n" +"LINESTRING(1 1,0 0,-1 1,1 1)\n" +"\n" +"--Using a 3d polygon\n" +"SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('POLYGON((1 1 1,0 0 1, -1 1 1, " +"1 1 1))')));\n" +"\n" +"st_asewkt\n" +"-----------------------------------\n" +"LINESTRING(1 1 1,0 0 1,-1 1 1,1 1 1)\n" +"\n" +"--Using a 3d multilinestring\n" +"SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('MULTILINESTRING((1 1 1,0 0 " +"0.5, -1 1 1),(1 1 0.5,0 0 0.5, -1 1 0.5, 1 1 0.5) )')));\n" +"\n" +"st_asewkt\n" +"----------\n" +"MULTIPOINT(-1 1 1,1 1 0.75)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:107 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:113 +#, no-c-format +msgid "ST_CoordDim" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:115 +#, no-c-format +msgid "" +"Return the coordinate dimension of the ST_Geometry value." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:120 +#, no-c-format +msgid "" +"integer ST_CoordDim " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:130 +#, no-c-format +msgid "Return the coordinate dimension of the ST_Geometry value." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:132 +#, no-c-format +msgid "This is the MM compliant alias name for " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:135 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.3" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:146 +#, no-c-format +msgid "" +"SELECT ST_CoordDim('CIRCULARSTRING(1 2 3, 1 3 4, 5 6 7, 8 9 10, 11 12 " +"13)');\n" +" ---result--\n" +" 3\n" +"\n" +" SELECT ST_CoordDim(ST_Point(1,2));\n" +" --result--\n" +" 2" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:159 +#, no-c-format +msgid "ST_Dimension" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:161 +#, no-c-format +msgid "" +"The inherent dimension of this Geometry object, which must be less than or " +"equal to the coordinate dimension." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:167 +#, no-c-format +msgid "" +"integer ST_Dimension " +"geometry g" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:178 +#, no-c-format +msgid "" +"The inherent dimension of this Geometry object, which must be less than or " +"equal to the coordinate dimension. OGC SPEC s2.1.1.1 - returns 0 for " +"POINT, 1 for LINESTRING, 2 for " +"POLYGON, and the largest dimension of the components of a " +"GEOMETRYCOLLECTION. If unknown (empty geometry) null is " +"returned." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:186 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.2" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:187 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces and TINs was introduced. No " +"longer throws an exception if given empty geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:188 +#, no-c-format +msgid "" +"Prior to 2.0.0, this function throws an exception if used with empty " +"geometry." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:196 +#, no-c-format +msgid "" +"SELECT ST_Dimension('GEOMETRYCOLLECTION(LINESTRING(1 1,0 0),POINT(0 0))');\n" +"ST_Dimension\n" +"-----------\n" +"1" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:207 +#, no-c-format +msgid "ST_EndPoint" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:209 +#, no-c-format +msgid "" +"Returns the last point of a LINESTRING geometry as a " +"POINT." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:215 +#, no-c-format +msgid "" +"boolean ST_EndPoint " +"geometry g" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:226 +#, no-c-format +msgid "" +"Returns the last point of a LINESTRING geometry as a " +"POINT or NULL if the input parameter " +"is not a LINESTRING." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:230 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.4" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:232 reference_accessor.xml:1511 +#, no-c-format +msgid "" +"Changed: 2.0.0 no longer works with single geometry multilinestrings. In " +"older versions of PostGIS -- a single line multilinestring would work " +"happily with this function and return the start point. In 2.0.0 it just " +"returns NULL like any other multilinestring. The older behavior was an " +"undocumented feature, but people who assumed they had their data stored as " +"LINESTRING may experience these returning NULL in 2.0 now." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:243 +#, no-c-format +msgid "" +"postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::" +"geometry));\n" +" st_astext\n" +"------------\n" +" POINT(3 3)\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_EndPoint('POINT(1 1)'::geometry) IS NULL AS is_null;\n" +" is_null\n" +"----------\n" +" t\n" +"(1 row)\n" +"\n" +"--3d endpoint\n" +"SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));\n" +" st_asewkt\n" +"--------------\n" +" POINT(0 0 5)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:249 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:256 +#, no-c-format +msgid "ST_Envelope" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:258 +#, no-c-format +msgid "" +"Returns a geometry representing the double precision (float8) bounding box " +"of the supplied geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:264 +#, no-c-format +msgid "" +"geometry ST_Envelope " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:275 +#, no-c-format +msgid "" +"Returns the float8 minimum bounding box for the supplied geometry, as a " +"geometry. The polygon is defined by the corner points of the bounding box " +"((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), " +"(MINX, MINY)). (PostGIS will add a " +"ZMIN/ZMAX coordinate as well)." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:285 +#, no-c-format +msgid "" +"Degenerate cases (vertical lines, points) will return a geometry of lower " +"dimension than POLYGON, ie. POINT or " +"LINESTRING." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:289 +#, no-c-format +msgid "" +"Availability: 1.5.0 behavior changed to output double precision instead of " +"float4" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:290 reference_accessor.xml:668 +#: reference_accessor.xml:766 reference_accessor.xml:1466 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:291 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.15" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:297 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Envelope('POINT(1 3)'::geometry));\n" +" st_astext\n" +"------------\n" +" POINT(1 3)\n" +"(1 row)\n" +"\n" +"\n" +"SELECT ST_AsText(ST_Envelope('LINESTRING(0 0, 1 3)'::geometry));\n" +" st_astext\n" +"--------------------------------\n" +" POLYGON((0 0,0 3,1 3,1 0,0 0))\n" +"(1 row)\n" +"\n" +"\n" +"SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000001 1, 1.0000001 0, 0 " +"0))'::geometry));\n" +" st_astext\n" +"--------------------------------------------------------------\n" +" POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))\n" +"(1 row)\n" +"SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000000001 1, " +"1.0000000001 0, 0 0))'::geometry));\n" +" st_astext\n" +"--------------------------------------------------------------\n" +" POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))\n" +"(1 row)\n" +" \n" +"SELECT Box3D(geom), Box2D(geom), ST_AsText(ST_Envelope(geom)) As " +"envelopewkt\n" +" FROM (SELECT 'POLYGON((0 0, 0 1000012333334.34545678, 1.0000001 1, " +"1.0000001 0, 0 0))'::geometry As geom) As foo;\n" +"\n" +"" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:302 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:308 +#, no-c-format +msgid "ST_ExteriorRing" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:310 +#, no-c-format +msgid "" +"Returns a line string representing the exterior ring of the " +"POLYGON geometry. Return NULL if the geometry is not a " +"polygon. Will not work with MULTIPOLYGON" +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:316 +#, no-c-format +msgid "" +"geometry ST_ExteriorRing " +"geometry a_polygon" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:327 +#, no-c-format +msgid "" +"Returns a line string representing the exterior ring of the " +"POLYGON geometry. Return NULL if the geometry is not a " +"polygon." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:330 +#, no-c-format +msgid "Only works with POLYGON geometry types" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:332 reference_accessor.xml:712 +#, no-c-format +msgid "&sfs_compliant; 2.1.5.1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:333 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.2.3, 8.3.3" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:340 +#, no-c-format +msgid "" +"--If you have a table of polygons\n" +"SELECT gid, ST_ExteriorRing(the_geom) AS ering\n" +"FROM sometable;\n" +"\n" +"--If you have a table of MULTIPOLYGONs\n" +"--and want to return a MULTILINESTRING composed of the exterior rings of " +"each polygon\n" +"SELECT gid, ST_Collect(ST_ExteriorRing(the_geom)) AS erings\n" +" FROM (SELECT gid, (ST_Dump(the_geom)).geom As the_geom\n" +" FROM sometable) As foo\n" +"GROUP BY gid;\n" +"\n" +"--3d Example\n" +"SELECT ST_AsEWKT(\n" +" ST_ExteriorRing(\n" +" ST_GeomFromEWKT('POLYGON((0 0 1, 1 1 1, 1 2 1, 1 1 1, 0 0 1))')\n" +" )\n" +");\n" +"\n" +"st_asewkt\n" +"---------\n" +"LINESTRING(0 0 1,1 1 1,1 2 1,1 1 1,0 0 1)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:346 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:356 +#, no-c-format +msgid "ST_GeometryN" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:358 +#, no-c-format +msgid "" +"Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, " +"(MULTI)POINT, (MULTI)LINESTRING, MULTICURVE or (MULTI)POLYGON, " +"POLYHEDRALSURFACE Otherwise, return NULL." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:365 +#, no-c-format +msgid "" +"geometry ST_GeometryN " +"geometry geomA " +"integer n" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:376 +#, no-c-format +msgid "" +"Return the 1-based Nth geometry if the geometry is a GEOMETRYCOLLECTION, " +"(MULTI)POINT, (MULTI)LINESTRING, MULTICURVE or (MULTI)POLYGON, " +"POLYHEDRALSURFACE Otherwise, return NULL" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:381 reference_accessor.xml:1414 +#, no-c-format +msgid "" +"Index is 1-based as for OGC specs since version 0.8.0. Previous versions " +"implemented this as 0-based instead." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:386 +#, no-c-format +msgid "" +"If you want to extract all geometries, of a geometry, ST_Dump is more " +"efficient and will also work for singular geoms." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:389 +#, no-c-format +msgid "" +"Changed: 2.0.0 Prior versions would return NULL for singular geometries. " +"This was changed to return the geometry for ST_GeometryN(..,1) case." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:391 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 9.1.5" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:401 +#, no-c-format +msgid "Standard Examples" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:403 +#, no-c-format +msgid "" +"--Extracting a subset of points from a 3d multipoint\n" +"SELECT n, ST_AsEWKT(ST_GeometryN(the_geom, n)) As geomewkt\n" +"FROM (\n" +"VALUES (ST_GeomFromEWKT('MULTIPOINT(1 2 7, 3 4 7, 5 6 7, 8 9 10)') ),\n" +"( ST_GeomFromEWKT('MULTICURVE(CIRCULARSTRING(2.5 2.5,4.5 2.5, 3.5 3.5), (10 " +"11, 12 11))') )\n" +" )As foo(the_geom)\n" +" CROSS JOIN generate_series(1,100) n\n" +"WHERE n <= ST_NumGeometries(the_geom);\n" +"\n" +" n | geomewkt\n" +"---+-----------------------------------------\n" +" 1 | POINT(1 2 7)\n" +" 2 | POINT(3 4 7)\n" +" 3 | POINT(5 6 7)\n" +" 4 | POINT(8 9 10)\n" +" 1 | CIRCULARSTRING(2.5 2.5,4.5 2.5,3.5 3.5)\n" +" 2 | LINESTRING(10 11,12 11)\n" +"\n" +"\n" +"--Extracting all geometries (useful when you want to assign an id)\n" +"SELECT gid, n, ST_GeometryN(the_geom, n)\n" +"FROM sometable CROSS JOIN generate_series(1,100) n\n" +"WHERE n <= ST_NumGeometries(the_geom);" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:406 +#, no-c-format +msgid "Polyhedral Surfaces, TIN and Triangle Examples" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:407 +#, no-c-format +msgid "" +"-- Polyhedral surface example\n" +"-- Break a Polyhedral surface into its faces\n" +"SELECT ST_AsEWKT(ST_GeometryN(p_geom,3)) As geom_ewkt\n" +" FROM (SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE( \n" +"((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" +"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), \n" +"((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), \n" +"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), \n" +"((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) \n" +")') AS p_geom ) AS a;\n" +"\n" +" geom_ewkt\n" +"------------------------------------------\n" +" POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:409 +#, no-c-format +msgid "" +"-- TIN -- \n" +"SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt\n" +" FROM\n" +" (SELECT \n" +" ST_GeomFromEWKT('TIN (((\n" +" 0 0 0, \n" +" 0 0 1, \n" +" 0 1 0, \n" +" 0 0 0\n" +" )), ((\n" +" 0 0 0, \n" +" 0 1 0, \n" +" 1 1 0, \n" +" 0 0 0\n" +" ))\n" +" )') AS geom\n" +" ) AS g;\n" +"-- result --\n" +" wkt\n" +"-------------------------------------\n" +" TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:416 reference_accessor.xml:1285 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:422 +#, no-c-format +msgid "ST_GeometryType" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:423 +#, no-c-format +msgid "Return the geometry type of the ST_Geometry value." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:428 +#, no-c-format +msgid "" +"text ST_GeometryType " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:437 +#, no-c-format +msgid "" +"Returns the type of the geometry as a string. EG: 'ST_Linestring', " +"'ST_Polygon','ST_MultiPolygon' etc. This function differs from " +"GeometryType(geometry) in the case of the string and ST in front that is " +"returned, as well as the fact that it will not indicate whether the geometry " +"is measured." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:439 reference_accessor.xml:560 +#: reference_accessor.xml:1071 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:440 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.4" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:449 +#, no-c-format +msgid "" +"SELECT ST_GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " +"29.26,77.27 29.31,77.29 29.07)'));\n" +" --result\n" +" ST_LineString" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:451 reference_accessor.xml:453 +#, no-c-format +msgid "" +"SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 " +"1 1, 0 1 0, 0 0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 " +"1, 0 0 1, 0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 " +"1, 0 1 1, 0 0 1)) )'));\n" +" --result\n" +" ST_PolyhedralSurface" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:455 +#, no-c-format +msgid "" +"SELECT ST_GeometryType(geom) as result\n" +" FROM\n" +" (SELECT \n" +" ST_GeomFromEWKT('TIN (((\n" +" 0 0 0, \n" +" 0 0 1, \n" +" 0 1 0, \n" +" 0 0 0\n" +" )), ((\n" +" 0 0 0, \n" +" 0 1 0, \n" +" 1 1 0, \n" +" 0 0 0\n" +" ))\n" +" )') AS geom\n" +" ) AS g;\n" +" result\n" +"--------\n" +" ST_Tin" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:468 +#, no-c-format +msgid "ST_InteriorRingN" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:470 +#, no-c-format +msgid "" +"Return the Nth interior linestring ring of the polygon geometry. Return NULL " +"if the geometry is not a polygon or the given N is out of range." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:477 +#, no-c-format +msgid "" +"geometry ST_InteriorRingN " +"geometry a_polygon " +"integer n" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:488 +#, no-c-format +msgid "" +"Return the Nth interior linestring ring of the polygon geometry. Return NULL " +"if the geometry is not a polygon or the given N is out of range. index " +"starts at 1." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:494 +#, no-c-format +msgid "" +"This will not work for MULTIPOLYGONs. Use in conjunction with ST_Dump for " +"MULTIPOLYGONS" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:498 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.2.6, 8.3.5" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:507 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_InteriorRingN(the_geom, 1)) As the_geom\n" +"FROM (SELECT ST_BuildArea(\n" +" ST_Collect(ST_Buffer(ST_Point(1,2), 20,3),\n" +" ST_Buffer(ST_Point(1, 2), 10,3))) As the_geom\n" +" ) as foo" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:514 +#, no-c-format +msgid "" +", , , ," +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:527 +#, no-c-format +msgid "ST_IsClosed" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:529 +#, no-c-format +msgid "" +"Returns TRUE if the LINESTRING's start " +"and end points are coincident. For Polyhedral surface is closed (volumetric)." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:536 +#, no-c-format +msgid "" +"boolean ST_IsClosed " +"geometry g" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:547 +#, no-c-format +msgid "" +"Returns TRUE if the LINESTRING's start " +"and end points are coincident. For Polyhedral Surfaces, it tells you if the " +"surface is areal (open) or volumetric (closed)." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:551 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.5, 9.3.3" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:553 +#, no-c-format +msgid "" +"SQL-MM defines the result of ST_IsClosed(NULL) to be 0, while PostGIS returns NULL." +msgstr "" + +#. Tag: title +#: reference_accessor.xml:567 +#, no-c-format +msgid "Line String and Point Examples" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:569 +#, no-c-format +msgid "" +"postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 1 1)'::geometry);\n" +" st_isclosed\n" +"-------------\n" +" f\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 0 1, 1 1, 0 0)'::geometry);\n" +" st_isclosed\n" +"-------------\n" +" t\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsClosed('MULTILINESTRING((0 0, 0 1, 1 1, 0 0),(0 0, 1 " +"1))'::geometry);\n" +" st_isclosed\n" +"-------------\n" +" f\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsClosed('POINT(0 0)'::geometry);\n" +" st_isclosed\n" +"-------------\n" +" t\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsClosed('MULTIPOINT((0 0), (1 1))'::geometry);\n" +" st_isclosed\n" +"-------------\n" +" t\n" +"(1 row)" +msgstr "" + +#. Tag: title +#: reference_accessor.xml:573 +#, no-c-format +msgid "Polyhedral Surface Examples" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:575 +#, no-c-format +msgid "" +"-- A cube --\n" +" SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 " +"0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 " +"1, 0 0 1, 0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 " +"1, 0 1 1, 0 0 1)) )'));\n" +"\n" +" st_isclosed\n" +"-------------\n" +" t\n" +"\n" +"\n" +" -- Same as cube but missing a side --\n" +" SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 " +"1, 0 1 0, 0 0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 " +"1, 0 0 1, 0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)) )'));\n" +"\n" +" st_isclosed\n" +"-------------\n" +" f" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:587 +#, no-c-format +msgid "ST_IsCollection" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:589 +#, no-c-format +msgid "" +"Returns TRUE if the argument is a collection " +"(MULTI*, GEOMETRYCOLLECTION, ...)" +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:596 +#, no-c-format +msgid "" +"boolean ST_IsCollection " +"geometry g" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:606 +#, no-c-format +msgid "" +"Returns TRUE if the geometry type of the argument is " +"either:" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:609 +#, no-c-format +msgid "GEOMETRYCOLLECTION" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:610 +#, no-c-format +msgid "MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:611 +#, no-c-format +msgid "COMPOUNDCURVE" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:616 +#, no-c-format +msgid "" +"This function analyzes the type of the geometry. This means that it will " +"return TRUE on collections that are empty or that contain " +"a single element." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:631 +#, no-c-format +msgid "" +"postgis=# SELECT ST_IsCollection('LINESTRING(0 0, 1 1)'::geometry);\n" +" st_iscollection\n" +"-------------\n" +" f\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsCollection('MULTIPOINT EMPTY'::geometry);\n" +" st_iscollection\n" +"-------------\n" +" t\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0))'::geometry);\n" +" st_iscollection\n" +"-------------\n" +" t\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0), (42 42))'::geometry);\n" +" st_iscollection\n" +"-------------\n" +" t\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_IsCollection('GEOMETRYCOLLECTION(POINT(0 0))'::" +"geometry);\n" +" st_iscollection\n" +"-------------\n" +" t\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:643 +#, no-c-format +msgid "ST_IsEmpty" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:645 +#, no-c-format +msgid "" +"Returns true if this Geometry is an empty geometrycollection, polygon, point " +"etc." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:651 +#, no-c-format +msgid "" +"boolean ST_IsEmpty " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:661 +#, no-c-format +msgid "" +"Returns true if this Geometry is an empty geometry. If true, then this " +"Geometry represents an empty geometry collection, polygon, point etc." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:664 +#, no-c-format +msgid "" +"SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns " +"NULL." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:669 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.7" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:671 +#, no-c-format +msgid "" +"Changed: 2.0.0 In prior versions of PostGIS " +"ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now " +"illegal in PostGIS 2.0.0 to better conform with SQL/MM standards" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:679 +#, no-c-format +msgid "" +"SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));\n" +" st_isempty\n" +"------------\n" +" t\n" +"(1 row)\n" +"\n" +" SELECT ST_IsEmpty(ST_GeomFromText('POLYGON EMPTY'));\n" +" st_isempty\n" +"------------\n" +" t\n" +"(1 row)\n" +"\n" +"SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));\n" +"\n" +" st_isempty\n" +"------------\n" +" f\n" +"(1 row)\n" +"\n" +" SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))')) = " +"false;\n" +" ?column?\n" +"----------\n" +" t\n" +"(1 row)\n" +"\n" +" SELECT ST_IsEmpty(ST_GeomFromText('CIRCULARSTRING EMPTY'));\n" +" st_isempty\n" +"------------\n" +" t\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:686 +#, no-c-format +msgid "ST_IsRing" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:688 +#, no-c-format +msgid "" +"Returns TRUE if this LINESTRING is " +"both closed and simple." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:694 +#, no-c-format +msgid "" +"boolean ST_IsRing " +"geometry g" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:705 +#, no-c-format +msgid "" +"Returns TRUE if this LINESTRING is " +"both (ST_StartPoint(g) ~= " +"ST_Endpoint(g)) and (does not self intersect)." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:713 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.6" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:715 +#, no-c-format +msgid "" +"SQL-MM defines the result of ST_IsRing(NULL) to be 0, while PostGIS returns NULL." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:724 +#, no-c-format +msgid "" +"SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom)\n" +"FROM (SELECT 'LINESTRING(0 0, 0 1, 1 1, 1 0, 0 0)'::geometry AS the_geom) AS " +"foo;\n" +" st_isring | st_isclosed | st_issimple\n" +"-----------+-------------+-------------\n" +" t | t | t\n" +"(1 row)\n" +"\n" +"SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom)\n" +"FROM (SELECT 'LINESTRING(0 0, 0 1, 1 0, 1 1, 0 0)'::geometry AS the_geom) AS " +"foo;\n" +" st_isring | st_isclosed | st_issimple\n" +"-----------+-------------+-------------\n" +" f | t | f\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:730 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:738 +#, no-c-format +msgid "ST_IsSimple" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:740 +#, no-c-format +msgid "" +"Returns (TRUE) if this Geometry has no anomalous geometric points, such as " +"self intersection or self tangency." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:746 +#, no-c-format +msgid "" +"boolean ST_IsSimple " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:756 +#, no-c-format +msgid "" +"Returns true if this Geometry has no anomalous geometric points, such as " +"self intersection or self tangency. For more information on the OGC's " +"definition of geometry simplicity and validity, refer to \"Ensuring OpenGIS compliancy of geometries\"" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:762 +#, no-c-format +msgid "" +"SQL-MM defines the result of ST_IsSimple(NULL) to be 0, while PostGIS " +"returns NULL." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:767 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.8" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:775 +#, no-c-format +msgid "" +"SELECT ST_IsSimple(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));\n" +" st_issimple\n" +"-------------\n" +" t\n" +"(1 row)\n" +"\n" +" SELECT ST_IsSimple(ST_GeomFromText('LINESTRING(1 1,2 2,2 3.5,1 3,1 2,2 " +"1)'));\n" +" st_issimple\n" +"-------------\n" +" f\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:787 +#, no-c-format +msgid "ST_IsValid" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:789 +#, no-c-format +msgid "" +"Returns true if the ST_Geometry is " +"well formed." +msgstr "" + +#. Tag: funcsynopsis +#: reference_accessor.xml:795 +#, no-c-format +msgid "" +" boolean ST_IsValid " +"geometry g boolean ST_IsValid geometry g integer flags " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:813 +#, no-c-format +msgid "" +"Test if an ST_Geometry value is well formed. For geometries that are " +"invalid, the PostgreSQL NOTICE will provide details of why it is not valid. " +"For more information on the OGC's definition of geometry simplicity and " +"validity, refer to \"Ensuring OpenGIS " +"compliancy of geometries\"" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:819 +#, no-c-format +msgid "" +"SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns " +"NULL." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:823 +#, no-c-format +msgid "" +"The version accepting flags is available starting with 2.0.0 and requires " +"GEOS >= 3.3.0. Such version does not print a NOTICE explaining the " +"invalidity. Allowed flags are documented in ." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:831 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.9" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:839 +#, no-c-format +msgid "" +"SELECT ST_IsValid(ST_GeomFromText('LINESTRING(0 0, 1 1)')) As good_line,\n" +" ST_IsValid(ST_GeomFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) As " +"bad_poly\n" +"--results\n" +"NOTICE: Self-intersection at or near point 0 0\n" +" good_line | bad_poly\n" +"-----------+----------\n" +" t | f" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:845 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:856 +#, no-c-format +msgid "ST_IsValidReason" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:858 +#, no-c-format +msgid "" +"Returns text stating if a geometry is valid or not and if not valid, a " +"reason why." +msgstr "" + +#. Tag: funcsynopsis +#: reference_accessor.xml:862 +#, no-c-format +msgid "" +" text ST_IsValidReason geometry geomA text " +"ST_IsValidReason geometry geomA integer flags " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:878 +#, no-c-format +msgid "" +"Returns text stating if a geometry is valid or not an if not valid, a reason " +"why." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:880 +#, no-c-format +msgid "" +"Useful in combination with ST_IsValid to generate a detailed report of " +"invalid geometries and reasons." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:882 +#, no-c-format +msgid "" +"Allowed flags are documented in ." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:886 +#, no-c-format +msgid "Availability: 1.4 - requires GEOS >= 3.1.0." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:887 +#, no-c-format +msgid "" +"Availability: 2.0 - requires GEOS >= 3.3.0 for the version taking flags." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:895 +#, no-c-format +msgid "" +"--First 3 Rejects from a successful quintuplet experiment\n" +"SELECT gid, ST_IsValidReason(the_geom) as validity_info\n" +"FROM\n" +"(SELECT ST_MakePolygon(ST_ExteriorRing(e.buff), ST_Accum(f.line)) As " +"the_geom, gid\n" +"FROM (SELECT ST_Buffer(ST_MakePoint(x1*10,y1), z1) As buff, x1*10 + y1*100 + " +"z1*1000 As gid\n" +" FROM generate_series(-4,6) x1\n" +" CROSS JOIN generate_series(2,5) y1\n" +" CROSS JOIN generate_series(1,8) z1\n" +" WHERE x1 > y1*0.5 AND z1 < x1*y1) As e\n" +" INNER JOIN (SELECT " +"ST_Translate(ST_ExteriorRing(ST_Buffer(ST_MakePoint(x1*10,y1), z1)),y1*1, " +"z1*2) As line\n" +" FROM generate_series(-3,6) x1\n" +" CROSS JOIN generate_series(2,5) y1\n" +" CROSS JOIN generate_series(1,10) z1\n" +" WHERE x1 > y1*0.75 AND z1 < x1*y1) As f\n" +"ON (ST_Area(e.buff) > 78 AND ST_Contains(e.buff, f.line))\n" +"GROUP BY gid, e.buff) As quintuplet_experiment\n" +"WHERE ST_IsValid(the_geom) = false\n" +"ORDER BY gid\n" +"LIMIT 3;\n" +"\n" +" gid | validity_info\n" +"------+--------------------------\n" +" 5330 | Self-intersection [32 5]\n" +" 5340 | Self-intersection [42 5]\n" +" 5350 | Self-intersection [52 5]\n" +"\n" +" --simple example\n" +"SELECT ST_IsValidReason('LINESTRING(220227 150406,2220227 150407,222020 " +"150410)');\n" +"\n" +" st_isvalidreason\n" +"------------------\n" +" Valid Geometry" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:902 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:908 +#, no-c-format +msgid "ST_IsValidDetail" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:910 +#, no-c-format +msgid "" +"Returns a valid_detail (valid,reason,location) row stating if a geometry is " +"valid or not and if not valid, a reason why and a location where." +msgstr "" + +#. Tag: funcsynopsis +#: reference_accessor.xml:914 +#, no-c-format +msgid "" +" valid_detail ST_IsValidDetail geometry geom valid_detail " +"ST_IsValidDetail geometry geom integer " +"flags " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:930 +#, no-c-format +msgid "" +"Returns a valid_detail row, formed by a boolean (valid) stating if a " +"geometry is valid, a varchar (reason) stating a reason why it is invalid and " +"a geometry (location) pointing out where it is invalid." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:932 +#, no-c-format +msgid "" +"Useful to substitute and improve the combination of ST_IsValid and " +"ST_IsValidReason to generate a detailed report of invalid geometries." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:934 +#, no-c-format +msgid "The 'flags' argument is a bitfield. It can have the following values:" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:938 +#, no-c-format +msgid "" +"1: Consider self-intersecting rings forming holes as valid. This is also " +"know as \"the ESRI flag\". Note that this is against the OGC model." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:947 +#, no-c-format +msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:955 +#, no-c-format +msgid "" +"--First 3 Rejects from a successful quintuplet experiment\n" +"SELECT gid, reason(ST_IsValidDetail(the_geom)), " +"ST_AsText(location(ST_IsValidDetail(the_geom))) as location \n" +"FROM\n" +"(SELECT ST_MakePolygon(ST_ExteriorRing(e.buff), ST_Accum(f.line)) As " +"the_geom, gid\n" +"FROM (SELECT ST_Buffer(ST_MakePoint(x1*10,y1), z1) As buff, x1*10 + y1*100 + " +"z1*1000 As gid\n" +" FROM generate_series(-4,6) x1\n" +" CROSS JOIN generate_series(2,5) y1\n" +" CROSS JOIN generate_series(1,8) z1\n" +" WHERE x1 > y1*0.5 AND z1 < x1*y1) As e\n" +" INNER JOIN (SELECT " +"ST_Translate(ST_ExteriorRing(ST_Buffer(ST_MakePoint(x1*10,y1), z1)),y1*1, " +"z1*2) As line\n" +" FROM generate_series(-3,6) x1\n" +" CROSS JOIN generate_series(2,5) y1\n" +" CROSS JOIN generate_series(1,10) z1\n" +" WHERE x1 > y1*0.75 AND z1 < x1*y1) As f\n" +"ON (ST_Area(e.buff) > 78 AND ST_Contains(e.buff, f.line))\n" +"GROUP BY gid, e.buff) As quintuplet_experiment\n" +"WHERE ST_IsValid(the_geom) = false\n" +"ORDER BY gid\n" +"LIMIT 3;\n" +"\n" +" gid | reason | location\n" +"------+-------------------+-------------\n" +" 5330 | Self-intersection | POINT(32 5)\n" +" 5340 | Self-intersection | POINT(42 5)\n" +" 5350 | Self-intersection | POINT(52 5)\n" +"\n" +" --simple example\n" +"SELECT * FROM ST_IsValidDetail('LINESTRING(220227 150406,2220227 " +"150407,222020 150410)');\n" +"\n" +" valid | reason | location\n" +"-------+--------+----------\n" +" t | |" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:962 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:971 +#, no-c-format +msgid "ST_M" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:973 +#, no-c-format +msgid "" +"Return the M coordinate of the point, or NULL if not available. " +"Input must be a point." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:979 +#, no-c-format +msgid "" +"float ST_M geometry " +" a_point" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:989 +#, no-c-format +msgid "" +"Return the M coordinate of the point, or NULL if not available. Input " +"must be a point." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:993 +#, no-c-format +msgid "" +"This is not (yet) part of the OGC spec, but is listed here to complete the " +"point coordinate extractor function list." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:997 reference_accessor.xml:1892 +#, no-c-format +msgid "&sqlmm_compliant;" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1005 +#, no-c-format +msgid "" +"SELECT ST_M(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" +" st_m\n" +"------\n" +" 4\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1012 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1018 +#, no-c-format +msgid "ST_NDims" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1019 +#, no-c-format +msgid "" +"Returns coordinate dimension of the geometry as a small int. Values are: 2,3 " +"or 4." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1025 +#, no-c-format +msgid "" +"integer ST_NDims " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1035 +#, no-c-format +msgid "" +"Returns the coordinate dimension of the geometry. PostGIS supports 2 - (x," +"y) , 3 - (x,y,z) or 2D with measure - x,y,m, and 4 - 3D with measure space x," +"y,z,m" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1044 +#, no-c-format +msgid "" +"SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) As d2point,\n" +" ST_NDims(ST_GeomFromEWKT('POINT(1 1 2)')) As d3point,\n" +" ST_NDims(ST_GeomFromEWKT('POINTM(1 1 0.5)')) As d2pointm;\n" +"\n" +" d2point | d3point | d2pointm\n" +"---------+---------+----------\n" +" 2 | 3 | 3" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1048 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1054 +#, no-c-format +msgid "ST_NPoints" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1055 +#, no-c-format +msgid "Return the number of points (vertexes) in a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1060 +#, no-c-format +msgid "" +"integer ST_NPoints " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1070 +#, no-c-format +msgid "Return the number of points in a geometry. Works for all geometries." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1072 +#, no-c-format +msgid "" +"Prior to 1.3.4, this function crashes if used with geometries that contain " +"CURVES. This is fixed in 1.3.4+" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1082 +#, no-c-format +msgid "" +"SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 " +"29.31,77.29 29.07)'));\n" +"--result\n" +"4\n" +"\n" +"--Polygon in 3D space\n" +"SELECT ST_NPoints(ST_GeomFromEWKT('LINESTRING(77.29 29.07 1,77.42 29.26 " +"0,77.27 29.31 -1,77.29 29.07 3)'))\n" +"--result\n" +"4" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1093 +#, no-c-format +msgid "ST_NRings" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1094 +#, no-c-format +msgid "" +"If the geometry is a polygon or multi-polygon returns the number of rings." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1099 +#, no-c-format +msgid "" +"integer ST_NRings " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1109 +#, no-c-format +msgid "" +"If the geometry is a polygon or multi-polygon returns the number of rings. " +"Unlike NumInteriorRings, it counts the outer rings as well." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1119 +#, no-c-format +msgid "" +"SELECT ST_NRings(the_geom) As Nrings, ST_NumInteriorRings(the_geom) As " +"ninterrings\n" +" FROM (SELECT " +"ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))') As the_geom) As foo;\n" +" nrings | ninterrings\n" +"--------+-------------\n" +" 1 | 0\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1132 +#, no-c-format +msgid "ST_NumGeometries" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1133 +#, no-c-format +msgid "" +"If geometry is a GEOMETRYCOLLECTION (or MULTI*) return the number of " +"geometries, for single geometries will return 1, otherwise return NULL." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1139 +#, no-c-format +msgid "" +"integer ST_NumGeometries " +"geometry geom" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1149 +#, no-c-format +msgid "" +"Returns the number of Geometries. If geometry is a GEOMETRYCOLLECTION (or " +"MULTI*) return the number of geometries, for single geometries will return " +"1, otherwise return NULL." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1153 +#, no-c-format +msgid "" +"Changed: 2.0.0 In prior versions this would return NULL if the geometry was " +"not a collection/MULTI type. 2.0.0+ now returns 1 for single geometries e.g " +"POLYGON, LINESTRING, POINT." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1155 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 9.1.4" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1165 +#, no-c-format +msgid "" +"--Prior versions would have returned NULL for this -- in 2.0.0 this returns " +"1\n" +"SELECT ST_NumGeometries(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " +"29.26,77.27 29.31,77.29 29.07)'));\n" +"--result\n" +"1\n" +"\n" +"--Geometry Collection Example - multis count as one geom in a collection\n" +"SELECT ST_NumGeometries(ST_GeomFromEWKT('GEOMETRYCOLLECTION(MULTIPOINT(-2 " +"3 , -2 2),\n" +"LINESTRING(5 5 ,10 10),\n" +"POLYGON((-7 4.2,-7.1 5,-7.1 4.3,-7 4.2)))'));\n" +"--result\n" +"3" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1170 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1176 +#, no-c-format +msgid "ST_NumInteriorRings" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1177 +#, no-c-format +msgid "" +"Return the number of interior rings of the first polygon in the " +"geometry. This will work with both POLYGON and MULTIPOLYGON types but only " +"looks at the first polygon. Return NULL if there is no polygon in the " +"geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1185 +#, no-c-format +msgid "" +"integer ST_NumInteriorRings " +"geometry a_polygon" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1195 +#, no-c-format +msgid "" +"Return the number of interior rings of the first polygon in the " +"geometry. This will work with both POLYGON and MULTIPOLYGON types but only " +"looks at the first polygon. Return NULL if there is no polygon in the " +"geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1200 reference_accessor.xml:1239 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.2.5" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1206 +#, no-c-format +msgid "" +"--If you have a regular polygon\n" +"SELECT gid, field1, field2, ST_NumInteriorRings(the_geom) AS numholes\n" +"FROM sometable;\n" +"\n" +"--If you have multipolygons\n" +"--And you want to know the total number of interior rings in the " +"MULTIPOLYGON\n" +"SELECT gid, field1, field2, SUM(ST_NumInteriorRings(the_geom)) AS numholes\n" +"FROM (SELECT gid, field1, field2, (ST_Dump(the_geom)).geom As the_geom\n" +" FROM sometable) As foo\n" +"GROUP BY gid, field1,field2;" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1217 +#, no-c-format +msgid "ST_NumInteriorRing" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1218 +#, no-c-format +msgid "" +"Return the number of interior rings of the first polygon in the geometry. " +"Synonym to ST_NumInteriorRings." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1224 +#, no-c-format +msgid "" +"integer ST_NumInteriorRing " +"geometry a_polygon" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1234 +#, no-c-format +msgid "" +"Return the number of interior rings of the first polygon in the geometry. " +"Synonym to ST_NumInteriorRings. The OpenGIS specs are ambiguous about the " +"exact function naming, so we provide both spellings." +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1251 +#, no-c-format +msgid "ST_NumPatches" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1252 +#, no-c-format +msgid "" +"Return the number of faces on a Polyhedral Surface. Will return null for non-" +"polyhedral geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1257 +#, no-c-format +msgid "" +"integer ST_NumPatches " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1267 +#, no-c-format +msgid "" +"Return the number of faces on a Polyhedral Surface. Will return null for non-" +"polyhedral geometries. This is an alias for ST_NumGeometries to support MM " +"naming. Faster to use ST_NumGeometries if you don't care about MM convention." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1270 reference_accessor.xml:1365 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1273 reference_accessor.xml:1366 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: ?" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1280 +#, no-c-format +msgid "" +"SELECT ST_NumPatches(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 " +"1, 0 1 0, 0 0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 " +"1, 0 0 1, 0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 " +"1, 0 1 1, 0 0 1)) )'));\n" +" --result\n" +" 6" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1291 +#, no-c-format +msgid "ST_NumPoints" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1292 +#, no-c-format +msgid "" +"Return the number of points in an ST_LineString or ST_CircularString value." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1298 +#, no-c-format +msgid "" +"integer ST_NumPoints " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1308 +#, no-c-format +msgid "" +"Return the number of points in an ST_LineString or ST_CircularString value. " +"Prior to 1.4 only works with Linestrings as the specs state. From 1.4 " +"forward this is an alias for ST_NPoints which returns number of vertexes for " +"not just line strings. Consider using ST_NPoints instead which is multi-" +"purpose and works with many geometry types." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1315 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.2.4" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1321 +#, no-c-format +msgid "" +"SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 " +"29.26,77.27 29.31,77.29 29.07)'));\n" +" --result\n" +" 4" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1332 +#, no-c-format +msgid "ST_PatchN" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1334 +#, no-c-format +msgid "" +"Return the 1-based Nth geometry (face) if the geometry is a " +"POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1341 +#, no-c-format +msgid "" +"geometry ST_PatchN " +"geometry geomA " +"integer n" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1352 +#, no-c-format +msgid "" +">Return the 1-based Nth geometry (face) if the geometry is a " +"POLYHEDRALSURFACE, POLYHEDRALSURFACEM. Otherwise, return NULL. This returns " +"the same answer as ST_GeometryN for Polyhedral Surfaces. Using ST_GemoetryN " +"is faster." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1358 +#, no-c-format +msgid "Index is 1-based." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1362 +#, no-c-format +msgid "" +"If you want to extract all geometries, of a geometry, ST_Dump is more " +"efficient." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1376 +#, no-c-format +msgid "" +"--Extract the 2nd face of the polyhedral surface\n" +"SELECT ST_AsEWKT(ST_PatchN(geom, 2)) As geomewkt\n" +"FROM (\n" +"VALUES (ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 " +"0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, " +"0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, " +"0 0 1)) )')) ) As foo(geom);\n" +"\n" +" geomewkt\n" +"---+-----------------------------------------\n" +" POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1383 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1389 +#, no-c-format +msgid "ST_PointN" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1391 +#, no-c-format +msgid "" +"Return the Nth point in the first linestring or circular " +"linestring in the geometry. Return NULL if there is no linestring in the " +"geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1398 +#, no-c-format +msgid "" +"geometry ST_PointN " +"geometry a_linestring integer n" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1409 +#, no-c-format +msgid "" +"Return the Nth point in the first linestring or circular linestring in " +"the geometry. Return NULL if there is no linestring in the geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1419 +#, no-c-format +msgid "" +"If you want to get the nth point of each line string in a multilinestring, " +"use in conjunction with ST_Dump" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1424 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.2.5, 7.3.5" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1434 +#, no-c-format +msgid "" +"-- Extract all POINTs from a LINESTRING\n" +"SELECT ST_AsText(\n" +" ST_PointN(\n" +" column1,\n" +" generate_series(1, ST_NPoints(column1))\n" +" ))\n" +"FROM ( VALUES ('LINESTRING(0 0, 1 1, 2 2)'::geometry) ) AS foo;\n" +"\n" +" st_astext\n" +"------------\n" +" POINT(0 0)\n" +" POINT(1 1)\n" +" POINT(2 2)\n" +"(3 rows)\n" +"\n" +"--Example circular string\n" +"SELECT ST_AsText(ST_PointN(ST_GeomFromText('CIRCULARSTRING(1 2, 3 2, 1 " +"2)'),2));\n" +"\n" +"st_astext\n" +"----------\n" +"POINT(3 2)" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1446 +#, no-c-format +msgid "ST_SRID" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1447 +#, no-c-format +msgid "" +"Returns the spatial reference identifier for the ST_Geometry as defined in " +"spatial_ref_sys table." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1452 +#, no-c-format +msgid "" +"integer ST_SRID " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1462 +#, no-c-format +msgid "" +"Returns the spatial reference identifier for the ST_Geometry as defined in " +"spatial_ref_sys table. " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1463 +#, no-c-format +msgid "" +"spatial_ref_sys table is a table that catalogs all spatial reference systems " +"known to PostGIS and is used for transformations from one spatial reference " +"system to another. So verifying you have the right spatial reference system " +"identifier is important if you plan to ever transform your geometries." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1467 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.5" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1475 +#, no-c-format +msgid "" +"SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));\n" +" --result\n" +" 4326" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1480 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1486 +#, no-c-format +msgid "ST_StartPoint" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1488 +#, no-c-format +msgid "" +"Returns the first point of a LINESTRING geometry as a " +"POINT." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1494 +#, no-c-format +msgid "" +"geometry ST_StartPoint " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1505 +#, no-c-format +msgid "" +"Returns the first point of a LINESTRING geometry as a " +"POINT or NULL if the input parameter " +"is not a LINESTRING." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1509 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.3" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1522 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));\n" +" st_astext\n" +"------------\n" +" POINT(0 1)\n" +"(1 row)\n" +"\n" +"SELECT ST_StartPoint('POINT(0 1)'::geometry) IS NULL AS is_null;\n" +" is_null\n" +"----------\n" +" t\n" +"(1 row)\n" +"\n" +"--3d line\n" +"SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));\n" +" st_asewkt\n" +"------------\n" +" POINT(0 1 1)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1528 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1533 +#, no-c-format +msgid "ST_Summary" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1535 +#, no-c-format +msgid "" +"Returns a text summary of the contents of the geometry." +msgstr "" + +#. Tag: funcsynopsis +#: reference_accessor.xml:1541 +#, no-c-format +msgid "" +" text ST_Summary " +"geometry g text ST_Summary geography g " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1556 +#, no-c-format +msgid "Returns a text summary of the contents of the geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1558 +#, no-c-format +msgid "" +"Flags shown square brackets after the geometry type have the following " +"meaning:" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1562 +#, no-c-format +msgid "M: has M ordinate" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1563 +#, no-c-format +msgid "Z: has Z ordinate" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1564 +#, no-c-format +msgid "B: has a cached bounding box" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1565 +#, no-c-format +msgid "G: is geodetic (geography)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1569 +#, no-c-format +msgid "Availability: 1.2.2 - 2.0.0 added support for geography" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1576 +#, no-c-format +msgid "" +"=# SELECT ST_Summary(ST_GeomFromText('LINESTRING(0 0, 1 1)')) as geom,\n" +" ST_Summary(ST_GeogFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) " +"geog;\n" +" geom | geog \n" +"-----------------------------+--------------------------\n" +" LineString[B] with 2 points | Polygon[BG] with 1 rings\n" +" : ring 0 has 5 points\n" +" :\n" +"(1 row)\n" +"\n" +"\n" +"=# SELECT ST_Summary(ST_GeogFromText('LINESTRING(0 0 1, 1 1 1)')) As " +"geog_line,\n" +" ST_Summary(ST_GeomFromText('POLYGON((0 0 1, 1 1 2, 1 2 3, 1 1 1, 0 0 " +"1))')) As geom_poly;\n" +";\n" +" geog_line | geom_poly\n" +"-------------------------------+--------------------------\n" +" LineString[ZBG] with 2 points | Polygon[ZB] with 1 rings\n" +" : ring 0 has 5 points\n" +" :\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1582 +#, no-c-format +msgid "" +", , , " +", , " +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1591 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1602 +#, no-c-format +msgid "ST_X" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1604 +#, no-c-format +msgid "" +"Return the X coordinate of the point, or NULL if not available. " +"Input must be a point." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1610 +#, no-c-format +msgid "" +"float ST_X geometry " +" a_point" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1620 +#, no-c-format +msgid "" +"Return the X coordinate of the point, or NULL if not available. Input " +"must be a point." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1623 +#, no-c-format +msgid "" +"If you want to get the max min x values of any geometry look at ST_XMin, " +"ST_XMax functions." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1625 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.3" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1633 +#, no-c-format +msgid "" +"SELECT ST_X(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" +" st_x\n" +"------\n" +" 1\n" +"(1 row)\n" +"\n" +"SELECT ST_Y(ST_Centroid(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)')));\n" +" st_y\n" +"------\n" +" 1.5\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1640 +#, no-c-format +msgid "" +", , , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1646 +#, no-c-format +msgid "ST_XMax" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1648 +#, no-c-format +msgid "" +"Returns X maxima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1653 +#, no-c-format +msgid "" +"float ST_XMax box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1663 +#, no-c-format +msgid "Returns X maxima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1666 reference_accessor.xml:1711 +#: reference_accessor.xml:1799 reference_accessor.xml:1844 +#: reference_accessor.xml:1932 reference_accessor.xml:2019 +#, no-c-format +msgid "" +"Although this function is only defined for box3d, it will work for box2d and " +"geometry because of the auto-casting behavior defined for geometries and " +"box2d. However you can not feed it a geometry or box2d text representation, " +"since that will not auto-cast." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1678 +#, no-c-format +msgid "" +"SELECT ST_XMax('BOX3D(1 2 3, 4 5 6)');\n" +"st_xmax\n" +"-------\n" +"4\n" +"\n" +"SELECT ST_XMax(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n" +"st_xmax\n" +"-------\n" +"5\n" +"\n" +"SELECT ST_XMax(CAST('BOX(-3 2, 3 4)' As box2d));\n" +"st_xmax\n" +"-------\n" +"3\n" +"--Observe THIS DOES NOT WORK because it will try to autocast the string " +"representation to a BOX3D\n" +"SELECT ST_XMax('LINESTRING(1 3, 5 6)');\n" +"\n" +"--ERROR: BOX3D parser - doesnt start with BOX3D(\n" +"\n" +"SELECT ST_XMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)'));\n" +"st_xmax\n" +"--------\n" +"220288.248780547" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1685 reference_accessor.xml:1730 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1691 +#, no-c-format +msgid "ST_XMin" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1693 +#, no-c-format +msgid "" +"Returns X minima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1698 +#, no-c-format +msgid "" +"float ST_XMin box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1708 +#, no-c-format +msgid "Returns X minima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1723 +#, no-c-format +msgid "" +"SELECT ST_XMin('BOX3D(1 2 3, 4 5 6)');\n" +"st_xmin\n" +"-------\n" +"1\n" +"\n" +"SELECT ST_XMin(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n" +"st_xmin\n" +"-------\n" +"1\n" +"\n" +"SELECT ST_XMin(CAST('BOX(-3 2, 3 4)' As box2d));\n" +"st_xmin\n" +"-------\n" +"-3\n" +"--Observe THIS DOES NOT WORK because it will try to autocast the string " +"representation to a BOX3D\n" +"SELECT ST_XMin('LINESTRING(1 3, 5 6)');\n" +"\n" +"--ERROR: BOX3D parser - doesnt start with BOX3D(\n" +"\n" +"SELECT ST_XMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)'));\n" +"st_xmin\n" +"--------\n" +"220186.995121892" +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1736 +#, no-c-format +msgid "ST_Y" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1738 +#, no-c-format +msgid "" +"Return the Y coordinate of the point, or NULL if not available. " +"Input must be a point." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1744 +#, no-c-format +msgid "" +"float ST_Y geometry " +" a_point" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1754 +#, no-c-format +msgid "" +"Return the Y coordinate of the point, or NULL if not available. Input " +"must be a point." +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1758 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.4" +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1766 +#, no-c-format +msgid "" +"SELECT ST_Y(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" +" st_y\n" +"------\n" +" 2\n" +"(1 row)\n" +"\n" +"SELECT ST_Y(ST_Centroid(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)')));\n" +" st_y\n" +"------\n" +" 1.5\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1773 +#, no-c-format +msgid "" +", , , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1779 +#, no-c-format +msgid "ST_YMax" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1781 +#, no-c-format +msgid "" +"Returns Y maxima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1786 +#, no-c-format +msgid "" +"float ST_YMax box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1796 +#, no-c-format +msgid "Returns Y maxima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1811 +#, no-c-format +msgid "" +"SELECT ST_YMax('BOX3D(1 2 3, 4 5 6)');\n" +"st_ymax\n" +"-------\n" +"5\n" +"\n" +"SELECT ST_YMax(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n" +"st_ymax\n" +"-------\n" +"6\n" +"\n" +"SELECT ST_YMax(CAST('BOX(-3 2, 3 4)' As box2d));\n" +"st_ymax\n" +"-------\n" +"4\n" +"--Observe THIS DOES NOT WORK because it will try to autocast the string " +"representation to a BOX3D\n" +"SELECT ST_YMax('LINESTRING(1 3, 5 6)');\n" +"\n" +"--ERROR: BOX3D parser - doesnt start with BOX3D(\n" +"\n" +"SELECT ST_YMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)'));\n" +"st_ymax\n" +"--------\n" +"150506.126829327" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1818 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1824 +#, no-c-format +msgid "ST_YMin" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1826 +#, no-c-format +msgid "" +"Returns Y minima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1831 +#, no-c-format +msgid "" +"float ST_YMin box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1841 +#, no-c-format +msgid "Returns Y minima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1856 +#, no-c-format +msgid "" +"SELECT ST_YMin('BOX3D(1 2 3, 4 5 6)');\n" +"st_ymin\n" +"-------\n" +"2\n" +"\n" +"SELECT ST_YMin(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));\n" +"st_ymin\n" +"-------\n" +"3\n" +"\n" +"SELECT ST_YMin(CAST('BOX(-3 2, 3 4)' As box2d));\n" +"st_ymin\n" +"-------\n" +"2\n" +"--Observe THIS DOES NOT WORK because it will try to autocast the string " +"representation to a BOX3D\n" +"SELECT ST_YMin('LINESTRING(1 3, 5 6)');\n" +"\n" +"--ERROR: BOX3D parser - doesnt start with BOX3D(\n" +"\n" +"SELECT ST_YMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)'));\n" +"st_ymin\n" +"--------\n" +"150406" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1863 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1869 +#, no-c-format +msgid "ST_Z" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1871 +#, no-c-format +msgid "" +"Return the Z coordinate of the point, or NULL if not available. " +"Input must be a point." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1877 +#, no-c-format +msgid "" +"float ST_Z geometry " +" a_point" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1887 +#, no-c-format +msgid "" +"Return the Z coordinate of the point, or NULL if not available. Input " +"must be a point." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1899 +#, no-c-format +msgid "" +"SELECT ST_Z(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" +" st_z\n" +"------\n" +" 3\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1906 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1912 +#, no-c-format +msgid "ST_ZMax" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1914 reference_accessor.xml:2001 +#, no-c-format +msgid "" +"Returns Z minima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1919 +#, no-c-format +msgid "" +"float ST_ZMax box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1929 +#, no-c-format +msgid "Returns Z maxima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1944 +#, no-c-format +msgid "" +"SELECT ST_ZMax('BOX3D(1 2 3, 4 5 6)');\n" +"st_zmax\n" +"-------\n" +"6\n" +"\n" +"SELECT ST_ZMax(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));\n" +"st_zmax\n" +"-------\n" +"7\n" +"\n" +"SELECT ST_ZMax('BOX3D(-3 2 1, 3 4 1)' );\n" +"st_zmax\n" +"-------\n" +"1\n" +"--Observe THIS DOES NOT WORK because it will try to autocast the string " +"representation to a BOX3D\n" +"SELECT ST_ZMax('LINESTRING(1 3 4, 5 6 7)');\n" +"\n" +"--ERROR: BOX3D parser - doesnt start with BOX3D(\n" +"\n" +"SELECT ST_ZMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)'));\n" +"st_zmax\n" +"--------\n" +"3" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1951 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1957 +#, no-c-format +msgid "ST_Zmflag" +msgstr "" + +#. Tag: refpurpose +#: reference_accessor.xml:1959 +#, no-c-format +msgid "" +"Returns ZM (dimension semantic) flag of the geometries as a " +"small int. Values are: 0=2d, 1=3dm, 2=3dz, 3=4d." +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:1965 +#, no-c-format +msgid "" +"smallint ST_Zmflag " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1975 +#, no-c-format +msgid "" +"Returns ZM (dimension semantic) flag of the geometries as a small int. " +"Values are: 0=2d, 1=3dm, 2=3dz, 3=4d." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:1986 +#, no-c-format +msgid "" +"SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRING(1 2, 3 4)'));\n" +" st_zmflag\n" +"-----------\n" +" 0\n" +"\n" +"SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRINGM(1 2 3, 3 4 3)'));\n" +" st_zmflag\n" +"-----------\n" +" 1\n" +"\n" +"SELECT ST_Zmflag(ST_GeomFromEWKT('CIRCULARSTRING(1 2 3, 3 4 3, 5 6 3)'));\n" +" st_zmflag\n" +"-----------\n" +" 2\n" +"SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));\n" +" st_zmflag\n" +"-----------\n" +" 3" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:1993 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_accessor.xml:1999 +#, no-c-format +msgid "ST_ZMin" +msgstr "" + +#. Tag: funcprototype +#: reference_accessor.xml:2006 +#, no-c-format +msgid "" +"float ST_ZMin box3d " +" aGeomorBox2DorBox3D" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:2016 +#, no-c-format +msgid "Returns Z minima of a bounding box 2d or 3d or a geometry." +msgstr "" + +#. Tag: programlisting +#: reference_accessor.xml:2031 +#, no-c-format +msgid "" +"SELECT ST_ZMin('BOX3D(1 2 3, 4 5 6)');\n" +"st_zmin\n" +"-------\n" +"3\n" +"\n" +"SELECT ST_ZMin(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));\n" +"st_zmin\n" +"-------\n" +"4\n" +"\n" +"SELECT ST_ZMin('BOX3D(-3 2 1, 3 4 1)' );\n" +"st_zmin\n" +"-------\n" +"1\n" +"--Observe THIS DOES NOT WORK because it will try to autocast the string " +"representation to a BOX3D\n" +"SELECT ST_ZMin('LINESTRING(1 3 4, 5 6 7)');\n" +"\n" +"--ERROR: BOX3D parser - doesnt start with BOX3D(\n" +"\n" +"SELECT ST_ZMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)'));\n" +"st_zmin\n" +"--------\n" +"1" +msgstr "" + +#. Tag: para +#: reference_accessor.xml:2038 +#, no-c-format +msgid "" +", , , , , , " +msgstr "" diff --git a/doc/po/pl/reference_constructor.xml.po b/doc/po/pl/reference_constructor.xml.po new file mode 100644 index 000000000..ea4f9364f --- /dev/null +++ b/doc/po/pl/reference_constructor.xml.po @@ -0,0 +1,3367 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2014-01-03 10:44+0000\n" +"Last-Translator: Jakub Bobrowski \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_constructor.xml:3 +#, no-c-format +msgid "Geometry Constructors" +msgstr "" + +#. Tag: refname +#: reference_constructor.xml:6 +#, no-c-format +msgid "ST_BdPolyFromText" +msgstr "ST_BdPolyFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:8 +#, no-c-format +msgid "" +"Construct a Polygon given an arbitrary collection of closed " +"linestrings as a MultiLineString Well-Known text representation." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:14 +#, no-c-format +msgid "" +"geometry ST_BdPolyFromText " +"text WKT " +"integer srid" +msgstr "" +"geometry ST_BdPolyFromText " +"text WKT " +"integer srid" + +#. Tag: title +#: reference_constructor.xml:23 reference_constructor.xml:72 +#: reference_constructor.xml:119 reference_constructor.xml:148 +#: reference_constructor.xml:175 reference_constructor.xml:227 +#: reference_constructor.xml:278 reference_constructor.xml:326 +#: reference_constructor.xml:369 reference_constructor.xml:400 +#: reference_constructor.xml:474 reference_constructor.xml:513 +#: reference_constructor.xml:564 reference_constructor.xml:596 +#: reference_constructor.xml:649 reference_constructor.xml:695 +#: reference_constructor.xml:740 reference_constructor.xml:799 +#: reference_constructor.xml:867 reference_constructor.xml:927 +#: reference_constructor.xml:966 reference_constructor.xml:1023 +#: reference_constructor.xml:1094 reference_constructor.xml:1139 +#: reference_constructor.xml:1220 reference_constructor.xml:1263 +#: reference_constructor.xml:1305 reference_constructor.xml:1366 +#: reference_constructor.xml:1427 reference_constructor.xml:1481 +#: reference_constructor.xml:1535 reference_constructor.xml:1591 +#: reference_constructor.xml:1640 reference_constructor.xml:1694 +#: reference_constructor.xml:1737 reference_constructor.xml:1760 +#, no-c-format +msgid "Description" +msgstr "Opis" + +#. Tag: para +#: reference_constructor.xml:25 +#, no-c-format +msgid "" +"Construct a Polygon given an arbitrary collection of closed " +"linestrings as a MultiLineString Well-Known text representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:30 +#, no-c-format +msgid "" +"Throws an error if WKT is not a MULTILINESTRING. Throws an error if output " +"is a MULTIPOLYGON; use ST_BdMPolyFromText in that case, or see " +"ST_BuildArea() for a postgis-specific approach." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:36 reference_constructor.xml:88 +#: reference_constructor.xml:241 reference_constructor.xml:756 +#: reference_constructor.xml:824 reference_constructor.xml:890 +#: reference_constructor.xml:1321 reference_constructor.xml:1443 +#: reference_constructor.xml:1705 +#, no-c-format +msgid "&sfs_compliant; s3.2.6.2" +msgstr "&sfs_compliant; s3.2.6.2" + +#. Tag: para +#: reference_constructor.xml:38 reference_constructor.xml:90 +#, no-c-format +msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0." +msgstr "Dostępność: 1.1.0 - wymaga GEOS >= 2.1.0." + +#. Tag: title +#: reference_constructor.xml:42 reference_constructor.xml:94 +#: reference_constructor.xml:125 reference_constructor.xml:190 +#: reference_constructor.xml:248 reference_constructor.xml:292 +#: reference_constructor.xml:340 reference_constructor.xml:485 +#: reference_constructor.xml:617 reference_constructor.xml:665 +#: reference_constructor.xml:703 reference_constructor.xml:763 +#: reference_constructor.xml:831 reference_constructor.xml:895 +#: reference_constructor.xml:935 reference_constructor.xml:982 +#: reference_constructor.xml:1235 reference_constructor.xml:1270 +#: reference_constructor.xml:1328 reference_constructor.xml:1389 +#: reference_constructor.xml:1450 reference_constructor.xml:1559 +#: reference_constructor.xml:1609 reference_constructor.xml:1658 +#: reference_constructor.xml:1710 +#, no-c-format +msgid "Examples" +msgstr "Przykłady" + +#. Tag: programlisting +#: reference_constructor.xml:44 reference_constructor.xml:96 +#, no-c-format +msgid "Forthcoming" +msgstr "" + +#. Tag: title +#: reference_constructor.xml:48 reference_constructor.xml:100 +#: reference_constructor.xml:129 reference_constructor.xml:153 +#: reference_constructor.xml:195 reference_constructor.xml:255 +#: reference_constructor.xml:305 reference_constructor.xml:346 +#: reference_constructor.xml:374 reference_constructor.xml:453 +#: reference_constructor.xml:492 reference_constructor.xml:540 +#: reference_constructor.xml:571 reference_constructor.xml:621 +#: reference_constructor.xml:672 reference_constructor.xml:710 +#: reference_constructor.xml:770 reference_constructor.xml:838 +#: reference_constructor.xml:902 reference_constructor.xml:942 +#: reference_constructor.xml:989 reference_constructor.xml:1066 +#: reference_constructor.xml:1109 reference_constructor.xml:1173 +#: reference_constructor.xml:1239 reference_constructor.xml:1276 +#: reference_constructor.xml:1335 reference_constructor.xml:1396 +#: reference_constructor.xml:1457 reference_constructor.xml:1508 +#: reference_constructor.xml:1563 reference_constructor.xml:1616 +#: reference_constructor.xml:1665 reference_constructor.xml:1717 +#: reference_constructor.xml:1741 reference_constructor.xml:1764 +#, no-c-format +msgid "See Also" +msgstr "Zobacz także" + +#. Tag: para +#: reference_constructor.xml:49 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:55 +#, no-c-format +msgid "ST_BdMPolyFromText" +msgstr "ST_BdMPolyFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:56 +#, no-c-format +msgid "" +"Construct a MultiPolygon given an arbitrary collection of closed linestrings " +"as a MultiLineString text representation Well-Known text representation." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:63 +#, no-c-format +msgid "" +"geometry ST_BdMPolyFromText " +"text WKT " +"integer srid" +msgstr "" +"geometry ST_BdMPolyFromText " +"text WKT " +"integer srid" + +#. Tag: para +#: reference_constructor.xml:74 +#, no-c-format +msgid "" +"Construct a Polygon given an arbitrary collection of closed linestrings, " +"polygons, MultiLineStrings as Well-Known text representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:79 +#, no-c-format +msgid "" +"Throws an error if WKT is not a MULTILINESTRING. Forces MULTIPOLYGON output " +"even when result is really only composed by a single POLYGON; use ST_BdPolyFromText if you're sure a " +"single POLYGON will result from operation, or see ST_BuildArea() for a postgis-specific approach." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:101 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:107 +#, no-c-format +msgid "ST_GeogFromText" +msgstr "ST_GeogFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:108 reference_constructor.xml:137 +#, no-c-format +msgid "" +"Return a specified geography value from Well-Known Text representation or " +"extended (WKT)." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:112 +#, no-c-format +msgid "" +"geography ST_GeogFromText " +"text EWKT" +msgstr "" +"geography ST_GeogFromText " +"text EWKT" + +#. Tag: para +#: reference_constructor.xml:120 +#, no-c-format +msgid "" +"Returns a geography object from the well-known text or extended well-known " +"representation. SRID 4326 is assumed. This is an alias for " +"ST_GeographyFromText. Points are always expressed in long lat form." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:126 +#, no-c-format +msgid "" +"--- converting lon lat coords to geography\n" +"ALTER TABLE sometable ADD COLUMN geog geography(POINT,4326);\n" +"UPDATE sometable SET geog = ST_GeogFromText('SRID=4326;POINT(' || lon || ' ' " +"|| lat || ')');" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:130 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:136 +#, no-c-format +msgid "ST_GeographyFromText" +msgstr "ST_GeographyFromText" + +#. Tag: funcprototype +#: reference_constructor.xml:141 +#, no-c-format +msgid "" +"geography ST_GeographyFromText " +"text EWKT" +msgstr "" +"geography ST_GeographyFromText " +"text EWKT" + +#. Tag: para +#: reference_constructor.xml:149 +#, no-c-format +msgid "" +"Returns a geography object from the well-known text representation. SRID " +"4326 is assumed." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:154 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:160 +#, no-c-format +msgid "ST_GeogFromWKB" +msgstr "ST_GeogFromWKB" + +#. Tag: refpurpose +#: reference_constructor.xml:161 +#, no-c-format +msgid "" +"Creates a geography instance from a Well-Known Binary geometry " +"representation (WKB) or extended Well Known Binary (EWKB)." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:167 +#, no-c-format +msgid "" +"geography ST_GeogFromWKB " +"bytea geom" +msgstr "" +"geography ST_GeogFromWKB " +"bytea geom" + +#. Tag: para +#: reference_constructor.xml:177 +#, no-c-format +msgid "" +"The ST_GeogFromWKB function, takes a well-known binary " +"representation (WKB) of a geometry or PostGIS Extended WKB and creates an " +"instance of the appropriate geography type. This function plays the role of " +"the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:182 +#, no-c-format +msgid "If SRID is not specified, it defaults to 4326 (WGS 84 long lat)." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:184 reference_constructor.xml:286 +#: reference_constructor.xml:334 reference_constructor.xml:610 +#: reference_constructor.xml:660 reference_constructor.xml:1605 +#, no-c-format +msgid "&curve_support;" +msgstr "&curve_support;" + +#. Tag: programlisting +#: reference_constructor.xml:192 +#, no-c-format +msgid "" +"--Although bytea rep contains single \\, these need to be escaped when " +"inserting into a table\n" +"SELECT ST_AsText(\n" +"ST_GeogFromWKB(E'\\\\001\\\\002\\\\000\\\\000\\\\000\\\\002\\\\000\\\\000\\" +"\\000\\\\037\\\\205\\\\353Q\\\\270~\\\\\\\\\\\\300\\\\323Mb\\\\020X\\\\231C@" +"\\\\020X9\\\\264\\\\310~\\\\\\\\\\\\300)\\\\\\\\\\\\217\\\\302\\\\365\\" +"\\230C@')\n" +");\n" +" st_astext\n" +"------------------------------------------------------\n" +" LINESTRING(-113.98 39.198,-113.981 39.195)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:197 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:204 +#, no-c-format +msgid "ST_GeomCollFromText" +msgstr "ST_GeomCollFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:206 +#, no-c-format +msgid "" +"Makes a collection Geometry from collection WKT with the given SRID. If SRID " +"is not give, it defaults to -1." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:211 +#, no-c-format +msgid "" +" geometry ST_GeomCollFromText text WKT " +"integer srid geometry " +"ST_GeomCollFromText text WKT " +msgstr "" +" geometry ST_GeomCollFromText text WKT " +"integer srid geometry " +"ST_GeomCollFromText text WKT " + +#. Tag: para +#: reference_constructor.xml:229 +#, no-c-format +msgid "" +"Makes a collection Geometry from the Well-Known-Text (WKT) representation " +"with the given SRID. If SRID is not give, it defaults to -1." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:232 reference_constructor.xml:1310 +#: reference_constructor.xml:1371 reference_constructor.xml:1432 +#: reference_constructor.xml:1700 +#, no-c-format +msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:234 +#, no-c-format +msgid "Returns null if the WKT is not a GEOMETRYCOLLECTION" +msgstr "Zwraca null jeśli WKT nie jest GEOMETRYCOLLECTION" + +#. Tag: para +#: reference_constructor.xml:236 +#, no-c-format +msgid "" +"If you are absolutely sure all your WKT geometries are collections, don't " +"use this function. It is slower than ST_GeomFromText since it adds an " +"additional validation step." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:242 +#, no-c-format +msgid "&sqlmm_compliant;" +msgstr "&sqlmm_compliant;" + +#. Tag: programlisting +#: reference_constructor.xml:250 +#, no-c-format +msgid "" +"SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 " +"4))');" +msgstr "" +"SELECT ST_GeomCollFromText('GEOMETRYCOLLECTION(POINT(1 2),LINESTRING(1 2, 3 " +"4))');" + +#. Tag: para +#: reference_constructor.xml:257 reference_constructor.xml:1459 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:264 +#, no-c-format +msgid "ST_GeomFromEWKB" +msgstr "ST_GeomFromEWKB" + +#. Tag: refpurpose +#: reference_constructor.xml:265 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Extended Well-Known Binary " +"representation (EWKB)." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:270 +#, no-c-format +msgid "" +"geometry ST_GeomFromEWKB " +"bytea EWKB" +msgstr "" +"geometry ST_GeomFromEWKB " +"bytea EWKB" + +#. Tag: para +#: reference_constructor.xml:279 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known " +"binary (EWKT) representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:281 +#, no-c-format +msgid "" +"The EWKB format is not an OGC standard, but a PostGIS specific format that " +"includes the spatial reference system (SRID) identifier" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:284 reference_constructor.xml:332 +#: reference_constructor.xml:420 reference_constructor.xml:567 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:285 reference_constructor.xml:333 +#: reference_constructor.xml:422 reference_constructor.xml:481 +#: reference_constructor.xml:527 reference_constructor.xml:698 +#: reference_constructor.xml:1034 reference_constructor.xml:1151 +#: reference_constructor.xml:1230 reference_constructor.xml:1604 +#: reference_constructor.xml:1652 +#, no-c-format +msgid "&Z_support;" +msgstr "&Z_support;" + +#. Tag: para +#: reference_constructor.xml:287 reference_constructor.xml:335 +#: reference_constructor.xml:423 +#, no-c-format +msgid "&P_support;" +msgstr "&P_support;" + +#. Tag: para +#: reference_constructor.xml:288 reference_constructor.xml:336 +#: reference_constructor.xml:424 +#, no-c-format +msgid "&T_support;" +msgstr "&T_support;" + +#. Tag: para +#: reference_constructor.xml:293 +#, no-c-format +msgid "" +"line string binary rep 0f LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932) in NAD 83 long lat (4269)." +msgstr "" +"line string binary rep 0f LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932) in NAD 83 long lat (4269)." + +#. Tag: para +#: reference_constructor.xml:295 +#, no-c-format +msgid "" +"NOTE: Even though byte arrays are delimited with \\ and may have ', we need " +"to escape both out with \\ and '' if standard_conforming_strings is off. So " +"it does not look exactly like its AsEWKB representation." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:297 +#, no-c-format +msgid "" +"SELECT ST_GeomFromEWKB(E'\\\\001\\\\002\\\\000\\\\000 \\\\255\\\\020\\\\000\\" +"\\000\\\\003\\\\000\\\\000\\\\000\\\\344J=\n" +"\\\\013B\\\\312Q\\\\300n\\\\303(\\\\010\\\\036!E@''\\\\277E''K\n" +"\\\\312Q\\\\300\\\\366{b\\\\235*!E@\\\\225|\\\\354.P\\\\312Q\n" +"\\\\300p\\\\231\\\\323e1!E@');" +msgstr "" +"SELECT ST_GeomFromEWKB(E'\\\\001\\\\002\\\\000\\\\000 \\\\255\\\\020\\\\000\\" +"\\000\\\\003\\\\000\\\\000\\\\000\\\\344J=\n" +"\\\\013B\\\\312Q\\\\300n\\\\303(\\\\010\\\\036!E@''\\\\277E''K\n" +"\\\\312Q\\\\300\\\\366{b\\\\235*!E@\\\\225|\\\\354.P\\\\312Q\n" +"\\\\300p\\\\231\\\\323e1!E@');" + +#. Tag: para +#: reference_constructor.xml:299 +#, no-c-format +msgid "" +"In PostgreSQL 9.1+ - standard_conforming_strings is set to on by default, " +"where as in past versions it was set to on. You can change defaults as " +"needed for a single query or at the database or server level. Below is how " +"you would do it with standard_conforming_strings = on. In this case we " +"escape the ' with standard ansi ', but slashes are not escaped" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:302 +#, no-c-format +msgid "" +"set standard_conforming_strings = on;\n" +"SELECT ST_GeomFromEWKB('\\001\\002\\000\\000 " +"\\255\\020\\000\\000\\003\\000\\000\\000\\344J=\\012\\013B\n" +" \\312Q\\300n\\303(\\010\\036!E@''\\277E''K\\012\\312Q\\300\\366{b\\235*!" +"E@\\225|\\354.P\\312Q\\012\\300p\\231\\323e1')" +msgstr "" +"set standard_conforming_strings = on;\n" +"SELECT ST_GeomFromEWKB('\\001\\002\\000\\000 " +"\\255\\020\\000\\000\\003\\000\\000\\000\\344J=\\012\\013B\n" +" \\312Q\\300n\\303(\\010\\036!E@''\\277E''K\\012\\312Q\\300\\366{b\\235*!" +"E@\\225|\\354.P\\312Q\\012\\300p\\231\\323e1')" + +#. Tag: para +#: reference_constructor.xml:306 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:312 +#, no-c-format +msgid "ST_GeomFromEWKT" +msgstr "ST_GeomFromEWKT" + +#. Tag: refpurpose +#: reference_constructor.xml:313 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Extended Well-Known Text " +"representation (EWKT)." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:318 +#, no-c-format +msgid "" +"geometry ST_GeomFromEWKT " +"text EWKT" +msgstr "" +"geometry ST_GeomFromEWKT " +"text EWKT" + +#. Tag: para +#: reference_constructor.xml:327 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known " +"text (EWKT) representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:329 +#, no-c-format +msgid "" +"The EWKT format is not an OGC standard, but an PostGIS specific format that " +"includes the spatial reference system (SRID) identifier" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:341 +#, no-c-format +msgid "" +"SELECT ST_GeomFromEWKT('SRID=4269;LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932)');\n" +"SELECT ST_GeomFromEWKT('SRID=4269;MULTILINESTRING((-71.160281 " +"42.258729,-71.160837 42.259113,-71.161144 42.25932))');\n" +"\n" +"SELECT ST_GeomFromEWKT('SRID=4269;POINT(-71.064544 42.28787)');\n" +"\n" +"SELECT ST_GeomFromEWKT('SRID=4269;POLYGON((-71.1776585052917 " +"42.3902909739571,-71.1776820268866 42.3903701743239,\n" +"-71.1776063012595 42.3903825660754,-71.1775826583081 " +"42.3903033653531,-71.1776585052917 42.3902909739571))');\n" +"\n" +"SELECT ST_GeomFromEWKT('SRID=4269;MULTIPOLYGON(((-71.1031880899493 " +"42.3152774590236,\n" +"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n" +"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n" +"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n" +"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n" +"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n" +"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n" +"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n" +"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n" +"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n" +"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n" +"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n" +"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n" +"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n" +"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n" +"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n" +"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n" +"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n" +"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n" +"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n" +"-71.1031880899493 42.3152774590236)),\n" +"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n" +"-71.1043443253471 42.3150676015829,-71.1043850704575 " +"42.3150793250568,-71.1043632495873 42.315113108546)))');" +msgstr "" +"SELECT ST_GeomFromEWKT('SRID=4269;LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932)');\n" +"SELECT ST_GeomFromEWKT('SRID=4269;MULTILINESTRING((-71.160281 " +"42.258729,-71.160837 42.259113,-71.161144 42.25932))');\n" +"\n" +"SELECT ST_GeomFromEWKT('SRID=4269;POINT(-71.064544 42.28787)');\n" +"\n" +"SELECT ST_GeomFromEWKT('SRID=4269;POLYGON((-71.1776585052917 " +"42.3902909739571,-71.1776820268866 42.3903701743239,\n" +"-71.1776063012595 42.3903825660754,-71.1775826583081 " +"42.3903033653531,-71.1776585052917 42.3902909739571))');\n" +"\n" +"SELECT ST_GeomFromEWKT('SRID=4269;MULTIPOLYGON(((-71.1031880899493 " +"42.3152774590236,\n" +"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n" +"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n" +"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n" +"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n" +"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n" +"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n" +"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n" +"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n" +"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n" +"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n" +"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n" +"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n" +"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n" +"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n" +"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n" +"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n" +"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n" +"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n" +"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n" +"-71.1031880899493 42.3152774590236)),\n" +"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n" +"-71.1043443253471 42.3150676015829,-71.1043850704575 " +"42.3150793250568,-71.1043632495873 42.315113108546)))');" + +#. Tag: programlisting +#: reference_constructor.xml:342 +#, no-c-format +msgid "" +"--3d circular string\n" +"SELECT ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 " +"2,220227 150406 3)');" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:343 +#, no-c-format +msgid "" +"--Polyhedral Surface example\n" +"SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE( \n" +" ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" +" ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), \n" +" ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), \n" +" ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +" ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), \n" +" ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) \n" +")');" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:347 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_constructor.xml:352 +#, no-c-format +msgid "ST_GeometryFromText" +msgstr "ST_GeometryFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:353 reference_constructor.xml:1749 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Well-Known Text representation " +"(WKT). This is an alias name for ST_GeomFromText" +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:356 +#, no-c-format +msgid "" +" geometry ST_GeometryFromText text WKT " +" geometry " +"ST_GeometryFromText text WKT integer " +"srid " +msgstr "" +" geometry ST_GeometryFromText text WKT " +" geometry " +"ST_GeometryFromText text WKT integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:370 reference_constructor.xml:1650 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "&sfs_compliant;" + +#. Tag: para +#: reference_constructor.xml:371 reference_constructor.xml:609 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.40" +msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.40" + +#. Tag: refname +#: reference_constructor.xml:381 +#, no-c-format +msgid "ST_GeomFromGML" +msgstr "ST_GeomFromGML" + +#. Tag: refpurpose +#: reference_constructor.xml:382 +#, no-c-format +msgid "" +"Takes as input GML representation of geometry and outputs a PostGIS geometry " +"object" +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:386 +#, no-c-format +msgid "" +" geometry ST_GeomFromGML text geomgml geometry " +"ST_GeomFromGML text " +"geomgml integer " +"srid " +msgstr "" +" geometry ST_GeomFromGML text geomgml geometry " +"ST_GeomFromGML text " +"geomgml integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:401 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC GML representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:402 +#, no-c-format +msgid "" +"ST_GeomFromGML works only for GML Geometry fragments. It throws an error if " +"you try to use it on a whole GML document." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:403 +#, no-c-format +msgid "" +"OGC GML versions supported: GML 3.2.1 " +"Namespace GML 3.1.1 Simple Features " +"profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility) GML 2.1.2 OGC " +"GML standards, cf: http://www.opengeospatial.org/standards/gml:" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:419 reference_constructor.xml:566 +#, no-c-format +msgid "Availability: 1.5, requires libxml2 1.6+" +msgstr "Dostępność: 1.5, wymaga libxml2 1.6+" + +#. Tag: para +#: reference_constructor.xml:421 reference_constructor.xml:568 +#, no-c-format +msgid "Enhanced: 2.0.0 default srid optional parameter added." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:425 +#, no-c-format +msgid "" +"GML allow mixed dimensions (2D and 3D inside the same MultiGeometry for " +"instance). As PostGIS geometries don't, ST_GeomFromGML convert the whole " +"geometry to 2D if a missing Z dimension is found once." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:427 +#, no-c-format +msgid "" +"GML support mixed SRS inside the same MultiGeometry. As PostGIS geometries " +"don't, ST_GeomFromGML, in this case, reproject all subgeometries to the SRS " +"root node. If no srsName attribute available for the GML root node, the " +"function throw an error." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:429 +#, no-c-format +msgid "" +"ST_GeomFromGML function is not pedantic about an explicit GML namespace. You " +"could avoid to mention it explicitly for common usages. But you need it if " +"you want to use XLink feature inside GML." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:431 +#, no-c-format +msgid "ST_GeomFromGML function not support SQL/MM curves geometries." +msgstr "" + +#. Tag: title +#: reference_constructor.xml:437 reference_constructor.xml:535 +#, no-c-format +msgid "Examples - A single geometry with srsName" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:438 +#, no-c-format +msgid "" +"SELECT ST_GeomFromGML('\n" +" \n" +" -71.16028,42.258729 -71.160837,42.259112 " +"-71.161143,42.25932\n" +" \n" +" ']]>);" +msgstr "" +"SELECT ST_GeomFromGML('\n" +" \n" +" -71.16028,42.258729 -71.160837,42.259112 " +"-71.161143,42.25932\n" +" \n" +" ']]>);" + +#. Tag: title +#: reference_constructor.xml:442 +#, no-c-format +msgid "Examples - XLink usage" +msgstr "Przykłady - użycie XLink" + +#. Tag: programlisting +#: reference_constructor.xml:443 +#, no-c-format +msgid "" +"SELECT \n" +" \n" +" 42.258729 " +"-71.16028\n" +" \n" +" 42.259112 -71.160837\n" +" \n" +" \n" +" \n" +" ');]]>);" +msgstr "" +"SELECT \n" +" \n" +" 42.258729 " +"-71.16028\n" +" \n" +" 42.259112 -71.160837\n" +" \n" +" \n" +" \n" +" ');]]>);" + +#. Tag: title +#: reference_constructor.xml:447 +#, no-c-format +msgid "Examples - Polyhedral Surface" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:448 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(\n" +"\n" +" \n" +" \n" +" 0 0 0 0 0 1 0 1 1 0 1 " +"0 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 0 0 0 1 0 1 1 " +"0 1 0 0 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 0 0 1 0 0 1 0 " +"1 0 0 1 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" 1 1 0 1 1 1 1 0 " +"1 1 0 0 1 1 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 1 0 0 1 1 1 1 " +"1 1 1 0 0 1 0\n" +" \n" +" \n" +" \n" +" \n" +" 0 0 1 1 0 1 1 1 " +"1 0 1 1 0 0 1\n" +" \n" +" \n" +"\n" +"']]>));\n" +"\n" +"-- result --\n" +" POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),\n" +" ((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),\n" +" ((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),\n" +" ((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),\n" +" ((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),\n" +" ((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:454 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:460 +#, no-c-format +msgid "ST_GeomFromGeoJSON" +msgstr "ST_GeomFromGeoJSON" + +#. Tag: refpurpose +#: reference_constructor.xml:461 +#, no-c-format +msgid "" +"Takes as input a geojson representation of a geometry and outputs a PostGIS " +"geometry object" +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:466 +#, no-c-format +msgid "" +"geometry ST_GeomFromGeoJSON " +"text geomjson" +msgstr "" +"geometry ST_GeomFromGeoJSON " +"text geomjson" + +#. Tag: para +#: reference_constructor.xml:475 +#, no-c-format +msgid "Constructs a PostGIS geometry object from the GeoJSON representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:476 +#, no-c-format +msgid "" +"ST_GeomFromGeoJSON works only for JSON Geometry fragments. It throws an " +"error if you try to use it on a whole JSON document." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:478 +#, no-c-format +msgid "Availability: 2.0.0 requires - JSON-C >= 0.9" +msgstr "Dostępność: 2.0.0 wymaga - JSON-C >= 0.9" + +#. Tag: para +#: reference_constructor.xml:479 +#, no-c-format +msgid "" +"If you do not have JSON-C enabled, support you will get an error notice " +"instead of seeing an output. To enable JSON-C, run configure --with-jsondir=/" +"path/to/json-c. See for " +"details." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:486 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"Point\",\"coordinates\":" +"[-48.23456,20.12345]}')) As wkt;\n" +"wkt\n" +"------\n" +"POINT(-48.23456 20.12345)" +msgstr "" +"SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"Point\",\"coordinates\":" +"[-48.23456,20.12345]}')) As wkt;\n" +"wkt\n" +"------\n" +"POINT(-48.23456 20.12345)" + +#. Tag: programlisting +#: reference_constructor.xml:487 +#, no-c-format +msgid "" +"-- a 3D linestring\n" +"SELECT ST_AsText(ST_GeomFromGeoJSON('{\"type\":\"LineString\",\"coordinates" +"\":[[1,2,3],[4,5,6],[7,8,9]]}')) As wkt;\n" +"\n" +"wkt\n" +"-------------------\n" +"LINESTRING(1 2,4 5,7 8)" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:493 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_constructor.xml:499 +#, no-c-format +msgid "ST_GeomFromKML" +msgstr "ST_GeomFromKML" + +#. Tag: refpurpose +#: reference_constructor.xml:500 +#, no-c-format +msgid "" +"Takes as input KML representation of geometry and outputs a PostGIS geometry " +"object" +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:505 +#, no-c-format +msgid "" +"geometry ST_GeomFromKML " +"text geomkml" +msgstr "" +"geometry ST_GeomFromKML " +"text geomkml" + +#. Tag: para +#: reference_constructor.xml:514 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC KML representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:515 +#, no-c-format +msgid "" +"ST_GeomFromKML works only for KML Geometry fragments. It throws an error if " +"you try to use it on a whole KML document." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:516 +#, no-c-format +msgid "" +"OGC KML versions supported: KML 2.2.0 " +"Namespace OGC KML standards, cf: http://www." +"opengeospatial.org/standards/kml:" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:526 +#, no-c-format +msgid "Availability: 1.5,libxml2 2.6+" +msgstr "Dostępność: 1.5, libxml2 2.6+" + +#. Tag: para +#: reference_constructor.xml:529 +#, no-c-format +msgid "ST_GeomFromKML function not support SQL/MM curves geometries." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:536 +#, no-c-format +msgid "" +"SELECT ST_GeomFromKML('\n" +" -71.1663,42.2614 \n" +" -71.1667,42.2616\n" +" ']]>);" +msgstr "" +"SELECT ST_GeomFromKML('\n" +" -71.1663,42.2614 \n" +" -71.1667,42.2616\n" +" ']]>);" + +#. Tag: para +#: reference_constructor.xml:541 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:547 +#, no-c-format +msgid "ST_GMLToSQL" +msgstr "ST_GMLToSQL" + +#. Tag: refpurpose +#: reference_constructor.xml:548 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from GML representation. This is an " +"alias name for ST_GeomFromGML" +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:551 +#, no-c-format +msgid "" +" geometry ST_GMLToSQL " +"text geomgml geometry ST_GMLToSQL text geomgml integer srid " +msgstr "" +" geometry ST_GMLToSQL " +"text geomgml geometry ST_GMLToSQL text geomgml integer srid " + +#. Tag: para +#: reference_constructor.xml:565 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support)." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:572 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:578 +#, no-c-format +msgid "ST_GeomFromText" +msgstr "ST_GeomFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:579 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Well-Known Text representation " +"(WKT)." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:582 +#, no-c-format +msgid "" +" geometry ST_GeomFromText text WKT " +" geometry " +"ST_GeomFromText text " +"WKT integer " +"srid " +msgstr "" +" geometry ST_GeomFromText text WKT " +" geometry " +"ST_GeomFromText text " +"WKT integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:598 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry object from the OGC Well-Known text " +"representation." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:602 +#, no-c-format +msgid "" +"There are 2 variants of ST_GeomFromText function, the first takes no SRID " +"and returns a geometry with no defined spatial reference system. The second " +"takes a spatial reference id as the second argument and returns an " +"ST_Geometry that includes this srid as part of its meta-data. The srid must " +"be defined in the spatial_ref_sys table." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:608 reference_constructor.xml:1554 +#, no-c-format +msgid "&sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:611 +#, no-c-format +msgid "" +"Changed: 2.0.0 In prior versions of PostGIS " +"ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now " +"illegal in PostGIS 2.0.0 to better conform with SQL/MM standards. This " +"should now be written as ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:618 +#, no-c-format +msgid "" +"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932)');\n" +"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932)',4269);\n" +"\n" +"SELECT ST_GeomFromText('MULTILINESTRING((-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932))');\n" +"\n" +"SELECT ST_GeomFromText('POINT(-71.064544 42.28787)');\n" +"\n" +"SELECT ST_GeomFromText('POLYGON((-71.1776585052917 " +"42.3902909739571,-71.1776820268866 42.3903701743239,\n" +"-71.1776063012595 42.3903825660754,-71.1775826583081 " +"42.3903033653531,-71.1776585052917 42.3902909739571))');\n" +"\n" +"SELECT ST_GeomFromText('MULTIPOLYGON(((-71.1031880899493 42.3152774590236,\n" +"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n" +"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n" +"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n" +"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n" +"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n" +"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n" +"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n" +"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n" +"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n" +"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n" +"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n" +"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n" +"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n" +"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n" +"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n" +"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n" +"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n" +"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n" +"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n" +"-71.1031880899493 42.3152774590236)),\n" +"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n" +"-71.1043443253471 42.3150676015829,-71.1043850704575 " +"42.3150793250568,-71.1043632495873 42.315113108546)))',4326);\n" +"\n" +"SELECT ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 " +"150406)');" +msgstr "" +"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932)');\n" +"SELECT ST_GeomFromText('LINESTRING(-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932)',4269);\n" +"\n" +"SELECT ST_GeomFromText('MULTILINESTRING((-71.160281 42.258729,-71.160837 " +"42.259113,-71.161144 42.25932))');\n" +"\n" +"SELECT ST_GeomFromText('POINT(-71.064544 42.28787)');\n" +"\n" +"SELECT ST_GeomFromText('POLYGON((-71.1776585052917 " +"42.3902909739571,-71.1776820268866 42.3903701743239,\n" +"-71.1776063012595 42.3903825660754,-71.1775826583081 " +"42.3903033653531,-71.1776585052917 42.3902909739571))');\n" +"\n" +"SELECT ST_GeomFromText('MULTIPOLYGON(((-71.1031880899493 42.3152774590236,\n" +"-71.1031627617667 42.3152960829043,-71.102923838298 42.3149156848307,\n" +"-71.1023097974109 42.3151969047397,-71.1019285062273 42.3147384934248,\n" +"-71.102505233663 42.3144722937587,-71.10277487471 42.3141658254797,\n" +"-71.103113945163 42.3142739188902,-71.10324876416 42.31402489987,\n" +"-71.1033002961013 42.3140393340215,-71.1033488797549 42.3139495090772,\n" +"-71.103396240451 42.3138632439557,-71.1041521907712 42.3141153348029,\n" +"-71.1041411411543 42.3141545014533,-71.1041287795912 42.3142114839058,\n" +"-71.1041188134329 42.3142693656241,-71.1041112482575 42.3143272556118,\n" +"-71.1041072845732 42.3143851580048,-71.1041057218871 42.3144430686681,\n" +"-71.1041065602059 42.3145009876017,-71.1041097995362 42.3145589148055,\n" +"-71.1041166403905 42.3146168544148,-71.1041258822717 42.3146748022936,\n" +"-71.1041375307579 42.3147318674446,-71.1041492906949 42.3147711126569,\n" +"-71.1041598612795 42.314808571739,-71.1042515013869 42.3151287620809,\n" +"-71.1041173835118 42.3150739481917,-71.1040809891419 42.3151344119048,\n" +"-71.1040438678912 42.3151191367447,-71.1040194562988 42.3151832057859,\n" +"-71.1038734225584 42.3151140942995,-71.1038446938243 42.3151006300338,\n" +"-71.1038315271889 42.315094347535,-71.1037393329282 42.315054824985,\n" +"-71.1035447555574 42.3152608696313,-71.1033436658644 42.3151648370544,\n" +"-71.1032580383161 42.3152269126061,-71.103223066939 42.3152517403219,\n" +"-71.1031880899493 42.3152774590236)),\n" +"((-71.1043632495873 42.315113108546,-71.1043583974082 42.3151211109857,\n" +"-71.1043443253471 42.3150676015829,-71.1043850704575 " +"42.3150793250568,-71.1043632495873 42.315113108546)))',4326);\n" +"\n" +"SELECT ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 " +"150406)');" + +#. Tag: para +#: reference_constructor.xml:622 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:628 +#, no-c-format +msgid "ST_GeomFromWKB" +msgstr "ST_GeomFromWKB" + +#. Tag: refpurpose +#: reference_constructor.xml:629 +#, no-c-format +msgid "" +"Creates a geometry instance from a Well-Known Binary geometry representation " +"(WKB) and optional SRID." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:634 reference_constructor.xml:1576 +#, no-c-format +msgid "" +" geometry ST_GeomFromWKB bytea geom geometry " +"ST_GeomFromWKB bytea " +"geom integer " +"srid " +msgstr "" +" geometry ST_GeomFromWKB bytea geom geometry " +"ST_GeomFromWKB bytea " +"geom integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:651 +#, no-c-format +msgid "" +"The ST_GeomFromWKB function, takes a well-known binary " +"representation of a geometry and a Spatial Reference System ID " +"(SRID) and creates an instance of the appropriate " +"geometry type. This function plays the role of the Geometry Factory in SQL. " +"This is an alternate name for ST_WKBToSQL." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:657 +#, no-c-format +msgid "If SRID is not specified, it defaults to -1 (Unknown)." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:658 +#, no-c-format +msgid "" +"&sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:659 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.41" +msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.41" + +#. Tag: programlisting +#: reference_constructor.xml:667 +#, no-c-format +msgid "" +"--Although bytea rep contains single \\, these need to be escaped when " +"inserting into a table \n" +" -- unless standard_conforming_strings is set to on.\n" +"SELECT ST_AsEWKT(\n" +"ST_GeomFromWKB(E'\\\\001\\\\002\\\\000\\\\000\\\\000\\\\002\\\\000\\\\000\\" +"\\000\\\\037\\\\205\\\\353Q\\\\270~\\\\\\\\\\\\300\\\\323Mb\\\\020X\\\\231C@" +"\\\\020X9\\\\264\\\\310~\\\\\\\\\\\\300)\\\\\\\\\\\\217\\\\302\\\\365\\" +"\\230C@',4326)\n" +");\n" +" st_asewkt\n" +"------------------------------------------------------\n" +" SRID=4326;LINESTRING(-113.98 39.198,-113.981 39.195)\n" +"(1 row)\n" +"\n" +"SELECT\n" +" ST_AsText(\n" +" ST_GeomFromWKB(\n" +" ST_AsEWKB('POINT(2 5)'::geometry)\n" +" )\n" +" );\n" +" st_astext\n" +"------------\n" +" POINT(2 5)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:674 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:680 +#, no-c-format +msgid "ST_LineFromMultiPoint" +msgstr "ST_LineFromMultiPoint" + +#. Tag: refpurpose +#: reference_constructor.xml:682 +#, no-c-format +msgid "" +"Creates a LineString from a MultiPoint geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:687 +#, no-c-format +msgid "" +"geometry ST_LineFromMultiPoint " +"geometry aMultiPoint" +msgstr "" +"geometry ST_LineFromMultiPoint " +"geometry aMultiPoint" + +#. Tag: para +#: reference_constructor.xml:697 +#, no-c-format +msgid "Creates a LineString from a MultiPoint geometry." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:705 +#, no-c-format +msgid "" +"--Create a 3d line string from a 3d multipoint\n" +"SELECT ST_AsEWKT(ST_LineFromMultiPoint(ST_GeomFromEWKT('MULTIPOINT(1 2 3, 4 " +"5 6, 7 8 9)')));\n" +"--result--\n" +"LINESTRING(1 2 3,4 5 6,7 8 9)" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:712 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:718 +#, no-c-format +msgid "ST_LineFromText" +msgstr "ST_LineFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:720 +#, no-c-format +msgid "" +"Makes a Geometry from WKT representation with the given SRID. If SRID is not " +"given, it defaults to -1." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:725 +#, no-c-format +msgid "" +" geometry ST_LineFromText text WKT " +" geometry " +"ST_LineFromText text " +"WKT integer " +"srid " +msgstr "" +" geometry ST_LineFromText text WKT " +" geometry " +"ST_LineFromText text " +"WKT integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:742 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not give, it " +"defaults to -1. If WKT passed in is not a LINESTRING, then null is returned." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:746 reference_constructor.xml:812 +#, no-c-format +msgid "OGC SPEC 3.2.6.2 - option SRID is from the conformance suite." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:751 +#, no-c-format +msgid "" +"If you know all your geometries are LINESTRINGS, its more efficient to just " +"use ST_GeomFromText. This just calls ST_GeomFromText and adds additional " +"validation that it returns a linestring." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:757 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.2.8" +msgstr "&sqlmm_compliant; SQL-MM 3: 7.2.8" + +#. Tag: programlisting +#: reference_constructor.xml:765 +#, no-c-format +msgid "" +"SELECT ST_LineFromText('LINESTRING(1 2, 3 4)') AS aline, " +"ST_LineFromText('POINT(1 2)') AS null_return;\n" +"aline | null_return\n" +"------------------------------------------------\n" +"010200000002000000000000000000F ... | t" +msgstr "" +"SELECT ST_LineFromText('LINESTRING(1 2, 3 4)') AS aline, " +"ST_LineFromText('POINT(1 2)') AS null_return;\n" +"aline | null_return\n" +"------------------------------------------------\n" +"010200000002000000000000000000F ... | t" + +#. Tag: refname +#: reference_constructor.xml:778 +#, no-c-format +msgid "ST_LineFromWKB" +msgstr "ST_LineFromWKB" + +#. Tag: refpurpose +#: reference_constructor.xml:780 +#, no-c-format +msgid "Makes a LINESTRING from WKB with the given SRID" +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:784 +#, no-c-format +msgid "" +" geometry ST_LineFromWKB bytea WKB " +" geometry ST_LineFromWKB bytea WKB integer srid " +msgstr "" +" geometry ST_LineFromWKB bytea WKB " +" geometry ST_LineFromWKB bytea WKB integer srid " + +#. Tag: para +#: reference_constructor.xml:801 +#, no-c-format +msgid "" +"The ST_LineFromWKB function, takes a well-known binary " +"representation of geometry and a Spatial Reference System ID (SRID) and creates an instance of the appropriate geometry type - in this " +"case, a LINESTRING geometry. This function plays the role " +"of the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:807 +#, no-c-format +msgid "" +"If an SRID is not specified, it defaults to -1. NULL is " +"returned if the input bytea does not represent a " +"LINESTRING." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:817 +#, no-c-format +msgid "" +"If you know all your geometries are LINESTRINGs, its more " +"efficient to just use . This function just " +"calls and adds additional validation that " +"it returns a linestring." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:825 reference_constructor.xml:891 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.2.9" +msgstr "&sqlmm_compliant; SQL-MM 3: 7.2.9" + +#. Tag: programlisting +#: reference_constructor.xml:833 +#, no-c-format +msgid "" +"SELECT ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))) " +"AS aline,\n" +" ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('POINT(1 2)'))) " +"IS NULL AS null_return;\n" +"aline | null_return\n" +"------------------------------------------------\n" +"010200000002000000000000000000F ... | t" +msgstr "" +"SELECT ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))) " +"AS aline,\n" +" ST_LineFromWKB(ST_AsBinary(ST_GeomFromText('POINT(1 2)'))) " +"IS NULL AS null_return;\n" +"aline | null_return\n" +"------------------------------------------------\n" +"010200000002000000000000000000F ... | t" + +#. Tag: para +#: reference_constructor.xml:840 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:846 +#, no-c-format +msgid "ST_LinestringFromWKB" +msgstr "ST_LinestringFromWKB" + +#. Tag: refpurpose +#: reference_constructor.xml:848 +#, no-c-format +msgid "Makes a geometry from WKB with the given SRID." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:852 +#, no-c-format +msgid "" +" geometry ST_LinestringFromWKB bytea WKB " +" geometry " +"ST_LinestringFromWKB bytea WKB integer " +"srid " +msgstr "" +" geometry ST_LinestringFromWKB bytea WKB " +" geometry " +"ST_LinestringFromWKB bytea WKB integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:869 +#, no-c-format +msgid "" +"The ST_LinestringFromWKB function, takes a well-known " +"binary representation of geometry and a Spatial Reference System ID " +"(SRID) and creates an instance of the appropriate " +"geometry type - in this case, a LINESTRING geometry. This " +"function plays the role of the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:875 +#, no-c-format +msgid "" +"If an SRID is not specified, it defaults to -1. NULL is " +"returned if the input bytea does not represent a " +"LINESTRING geometry. This an alias for ." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:880 +#, no-c-format +msgid "OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:884 +#, no-c-format +msgid "" +"If you know all your geometries are LINESTRINGs, it's " +"more efficient to just use . This function " +"just calls and adds additional validation " +"that it returns a LINESTRING." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:897 +#, no-c-format +msgid "" +"SELECT\n" +" ST_LineStringFromWKB(\n" +" ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))\n" +" ) AS aline,\n" +" ST_LinestringFromWKB(\n" +" ST_AsBinary(ST_GeomFromText('POINT(1 2)'))\n" +" ) IS NULL AS null_return;\n" +" aline | null_return\n" +"------------------------------------------------\n" +"010200000002000000000000000000F ... | t" +msgstr "" +"SELECT\n" +" ST_LineStringFromWKB(\n" +" ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))\n" +" ) AS aline,\n" +" ST_LinestringFromWKB(\n" +" ST_AsBinary(ST_GeomFromText('POINT(1 2)'))\n" +" ) IS NULL AS null_return;\n" +" aline | null_return\n" +"------------------------------------------------\n" +"010200000002000000000000000000F ... | t" + +#. Tag: para +#: reference_constructor.xml:904 reference_constructor.xml:1618 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_constructor.xml:910 +#, no-c-format +msgid "ST_MakeBox2D" +msgstr "ST_MakeBox2D" + +#. Tag: refpurpose +#: reference_constructor.xml:912 +#, no-c-format +msgid "Creates a BOX2D defined by the given point geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:918 +#, no-c-format +msgid "" +"box2d ST_MakeBox2D " +"geometry pointLowLeft geometry pointUpRight" +msgstr "" +"box2d ST_MakeBox2D " +"geometry pointLowLeft geometry pointUpRight" + +#. Tag: para +#: reference_constructor.xml:929 +#, no-c-format +msgid "" +"Creates a BOX2D defined by the given point geometries. This is useful for " +"doing range queries" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:937 +#, no-c-format +msgid "" +"--Return all features that fall reside or partly reside in a US national " +"atlas coordinate bounding box\n" +"--It is assumed here that the geometries are stored with SRID = 2163 (US " +"National atlas equal area)\n" +"SELECT feature_id, feature_name, the_geom\n" +"FROM features\n" +"WHERE the_geom && ST_SetSRID(ST_MakeBox2D(ST_Point(-989502.1875, " +"528439.5625),\n" +" ST_Point(-987121.375 ,529933.1875)),2163)" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:944 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_constructor.xml:950 +#, no-c-format +msgid "ST_3DMakeBox" +msgstr "ST_3DMakeBox" + +#. Tag: refpurpose +#: reference_constructor.xml:952 +#, no-c-format +msgid "Creates a BOX3D defined by the given 3d point geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:957 +#, no-c-format +msgid "" +"box3d ST_3DMakeBox " +"geometry point3DLowLeftBottom geometry " +"point3DUpRightTop" +msgstr "" +"box3d ST_3DMakeBox " +"geometry point3DLowLeftBottom geometry " +"point3DUpRightTop" + +#. Tag: para +#: reference_constructor.xml:968 +#, no-c-format +msgid "Creates a BOX3D defined by the given 2 3D point geometries." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:975 +#, no-c-format +msgid "This function supports 3d and will not drop the z-index." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:977 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:984 +#, no-c-format +msgid "" +"SELECT ST_3DMakeBox(ST_MakePoint(-989502.1875, 528439.5625, 10),\n" +" ST_MakePoint(-987121.375 ,529933.1875, 10)) As abb3d\n" +"\n" +"--bb3d--\n" +"--------\n" +"BOX3D(-989502.1875 528439.5625 10,-987121.375 529933.1875 10)" +msgstr "" +"SELECT ST_3DMakeBox(ST_MakePoint(-989502.1875, 528439.5625, 10),\n" +" ST_MakePoint(-987121.375 ,529933.1875, 10)) As abb3d\n" +"\n" +"--bb3d--\n" +"--------\n" +"BOX3D(-989502.1875 528439.5625 10,-987121.375 529933.1875 10)" + +#. Tag: para +#: reference_constructor.xml:991 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:997 +#, no-c-format +msgid "ST_MakeLine" +msgstr "ST_MakeLine" + +#. Tag: refpurpose +#: reference_constructor.xml:999 +#, no-c-format +msgid "Creates a Linestring from point or line geometries." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:1003 +#, no-c-format +msgid "" +" geometry ST_MakeLine " +"geometry set geoms " +" geometry ST_MakeLine geometry geom1 geometry geom2 geometry " +"ST_MakeLine geometry[] " +"geoms_array " +msgstr "" +" geometry ST_MakeLine " +"geometry set geoms " +" geometry ST_MakeLine geometry geom1 geometry geom2 geometry " +"ST_MakeLine geometry[] " +"geoms_array " + +#. Tag: para +#: reference_constructor.xml:1025 +#, no-c-format +msgid "" +"ST_MakeLine comes in 3 forms: a spatial aggregate that takes rows of point-" +"or-line geometries and returns a line string, a function that takes an array " +"of point-or-lines, and a regular function that takes two point-or-line " +"geometries. You might want to use a subselect to order points before feeding " +"them to the aggregate version of this function." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1030 +#, no-c-format +msgid "When adding line components a common node is removed from the output." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1035 +#, no-c-format +msgid "" +"Availability: 1.4.0 - ST_MakeLine(geomarray) was introduced. ST_MakeLine " +"aggregate functions was enhanced to handle more points faster." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1036 +#, no-c-format +msgid "" +"Availability: 2.0.0 - Support for linestring input elements was introduced" +msgstr "" + +#. Tag: title +#: reference_constructor.xml:1040 +#, no-c-format +msgid "Examples: Spatial Aggregate version" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1041 +#, no-c-format +msgid "" +"This example takes a sequence of GPS points and creates one record for each " +"gps travel where the geometry field is a line string composed of the gps " +"points in the order of the travel." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1045 +#, no-c-format +msgid "" +"-- For pre-PostgreSQL 9.0 - this usually works, \n" +"-- but the planner may on occasion choose not to respect the order of the " +"subquery\n" +"SELECT gps.gps_track, ST_MakeLine(gps.the_geom) As newgeom\n" +" FROM (SELECT gps_track,gps_time, the_geom\n" +" FROM gps_points ORDER BY gps_track, gps_time) As " +"gps\n" +" GROUP BY gps.gps_track;" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1047 +#, no-c-format +msgid "" +"-- If you are using PostgreSQL 9.0+ \n" +"-- (you can use the new ORDER BY support for aggregates)\n" +"-- this is a guaranteed way to get a correctly ordered linestring\n" +"-- Your order by part can order by more than one column if needed\n" +"SELECT gps.gps_track, ST_MakeLine(gps.the_geom ORDER BY gps_time) As " +"newgeom\n" +" FROM gps_points As gps\n" +" GROUP BY gps.gps_track;" +msgstr "" + +#. Tag: title +#: reference_constructor.xml:1050 +#, no-c-format +msgid "Examples: Non-Spatial Aggregate version" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1052 +#, no-c-format +msgid "" +"First example is a simple one off line string composed of 2 points. The " +"second formulates line strings from 2 points a user draws. The third is a " +"one-off that joins 2 3d points to create a line in 3d space." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1054 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)));\n" +" st_astext\n" +"---------------------\n" +" LINESTRING(1 2,3 4)\n" +"\n" +"SELECT userpoints.id, ST_MakeLine(startpoint, endpoint) As drawn_line\n" +" FROM userpoints ;\n" +"\n" +"SELECT ST_AsEWKT(ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5)));\n" +" st_asewkt\n" +"-------------------------\n" +" LINESTRING(1 2 3,3 4 5)" +msgstr "" +"SELECT ST_AsText(ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)));\n" +" st_astext\n" +"---------------------\n" +" LINESTRING(1 2,3 4)\n" +"\n" +"SELECT userpoints.id, ST_MakeLine(startpoint, endpoint) As drawn_line\n" +" FROM userpoints ;\n" +"\n" +"SELECT ST_AsEWKT(ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5)));\n" +" st_asewkt\n" +"-------------------------\n" +" LINESTRING(1 2 3,3 4 5)" + +#. Tag: title +#: reference_constructor.xml:1058 +#, no-c-format +msgid "Examples: Using Array version" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1060 +#, no-c-format +msgid "" +"SELECT ST_MakeLine(ARRAY(SELECT ST_Centroid(the_geom) FROM visit_locations " +"ORDER BY visit_time));\n" +"\n" +"--Making a 3d line with 3 3-d points\n" +"SELECT ST_AsEWKT(ST_MakeLine(ARRAY[ST_MakePoint(1,2,3),\n" +" ST_MakePoint(3,4,5), " +"ST_MakePoint(6,6,6)]));\n" +" st_asewkt\n" +"-------------------------\n" +"LINESTRING(1 2 3,3 4 5,6 6 6)" +msgstr "" +"SELECT ST_MakeLine(ARRAY(SELECT ST_Centroid(the_geom) FROM visit_locations " +"ORDER BY visit_time));\n" +"\n" +"--Making a 3d line with 3 3-d points\n" +"SELECT ST_AsEWKT(ST_MakeLine(ARRAY[ST_MakePoint(1,2,3),\n" +" ST_MakePoint(3,4,5), " +"ST_MakePoint(6,6,6)]));\n" +" st_asewkt\n" +"-------------------------\n" +"LINESTRING(1 2 3,3 4 5,6 6 6)" + +#. Tag: para +#: reference_constructor.xml:1067 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_constructor.xml:1074 +#, no-c-format +msgid "ST_MakeEnvelope" +msgstr "ST_MakeEnvelope" + +#. Tag: refpurpose +#: reference_constructor.xml:1076 +#, no-c-format +msgid "" +"Creates a rectangular Polygon formed from the given minimums and maximums. " +"Input values must be in SRS specified by the SRID." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1082 +#, no-c-format +msgid "" +"geometry ST_MakeEnvelope " +"double precision xmin double precision ymin double precision " +"xmax double precision ymax integer srid=unknown" +msgstr "" +"geometry ST_MakeEnvelope " +"double precision xmin double precision ymin double precision " +"xmax double precision ymax integer srid=unknown" + +#. Tag: para +#: reference_constructor.xml:1096 +#, no-c-format +msgid "" +"Creates a rectangular Polygon formed from the minima and maxima. by the " +"given shell. Input values must be in SRS specified by the SRID. If no SRID " +"is specified the unknown spatial reference system is assumed" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1099 +#, no-c-format +msgid "Availability: 1.5" +msgstr "Dostępność: 1.5" + +#. Tag: para +#: reference_constructor.xml:1100 +#, no-c-format +msgid "" +"Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was " +"introduced." +msgstr "" + +#. Tag: title +#: reference_constructor.xml:1105 +#, no-c-format +msgid "Example: Building a bounding box polygon" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1106 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_MakeEnvelope(10, 10, 11, 11, 4326));\n" +"\n" +"st_asewkt\n" +"-----------\n" +"POLYGON((10 10, 10 11, 11 11, 11 10, 10 10))" +msgstr "" +"SELECT ST_AsText(ST_MakeEnvelope(10, 10, 11, 11, 4326));\n" +"\n" +"st_asewkt\n" +"-----------\n" +"POLYGON((10 10, 10 11, 11 11, 11 10, 10 10))" + +#. Tag: para +#: reference_constructor.xml:1110 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:1116 +#, no-c-format +msgid "ST_MakePolygon" +msgstr "ST_MakePolygon" + +#. Tag: refpurpose +#: reference_constructor.xml:1118 +#, no-c-format +msgid "" +"Creates a Polygon formed by the given shell. Input geometries must be closed " +"LINESTRINGS." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1124 +#, no-c-format +msgid "" +"geometry ST_MakePolygon " +"geometry linestring" +msgstr "" +"geometry ST_MakePolygon " +"geometry linestring" + +#. Tag: funcprototype +#: reference_constructor.xml:1130 +#, no-c-format +msgid "" +"geometry ST_MakePolygon " +"geometry outerlinestring geometry[] interiorlinestrings" +msgstr "" +"geometry ST_MakePolygon " +"geometry outerlinestring geometry[] interiorlinestrings" + +#. Tag: para +#: reference_constructor.xml:1141 +#, no-c-format +msgid "" +"Creates a Polygon formed by the given shell. Input geometries must be closed " +"LINESTRINGS. Comes in 2 variants." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1143 +#, no-c-format +msgid "Variant 1: takes one closed linestring." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1144 +#, no-c-format +msgid "" +"Variant 2: Creates a Polygon formed by the given shell and array of holes. " +"You can construct a geometry array using ST_Accum or the PostgreSQL ARRAY[] " +"and ARRAY() constructs. Input geometries must be closed LINESTRINGS." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1148 +#, no-c-format +msgid "" +"This function will not accept a MULTILINESTRING. Use or to generate line strings." +msgstr "" + +#. Tag: title +#: reference_constructor.xml:1155 +#, no-c-format +msgid "Examples: Single closed LINESTRING" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1156 +#, no-c-format +msgid "" +"--2d line\n" +"SELECT ST_MakePolygon(ST_GeomFromText('LINESTRING(75.15 29.53,77 29,77.6 " +"29.5, 75.15 29.53)'));\n" +"--If linestring is not closed\n" +"--you can add the start point to close it\n" +"SELECT ST_MakePolygon(ST_AddPoint(foo.open_line, ST_StartPoint(foo." +"open_line)))\n" +"FROM (\n" +"SELECT ST_GeomFromText('LINESTRING(75.15 29.53,77 29,77.6 29.5)') As " +"open_line) As foo;\n" +"\n" +"--3d closed line\n" +"SELECT ST_MakePolygon(ST_GeomFromText('LINESTRING(75.15 29.53 1,77 29 1,77.6 " +"29.5 1, 75.15 29.53 1)'));\n" +"\n" +"st_asewkt\n" +"-----------\n" +"POLYGON((75.15 29.53 1,77 29 1,77.6 29.5 1,75.15 29.53 1))\n" +"\n" +"--measured line --\n" +"SELECT ST_MakePolygon(ST_GeomFromText('LINESTRINGM(75.15 29.53 1,77 29 " +"1,77.6 29.5 2, 75.15 29.53 2)'));\n" +"\n" +"st_asewkt\n" +"----------\n" +"POLYGONM((75.15 29.53 1,77 29 1,77.6 29.5 2,75.15 29.53 2))" +msgstr "" + +#. Tag: title +#: reference_constructor.xml:1159 +#, no-c-format +msgid "Examples: Outter shell with inner shells" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1161 +#, no-c-format +msgid "Build a donut with an ant hole" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1162 +#, no-c-format +msgid "" +"SELECT ST_MakePolygon(\n" +" ST_ExteriorRing(ST_Buffer(foo.line,10)),\n" +" ARRAY[ST_Translate(foo.line,1,1),\n" +" ST_ExteriorRing(ST_Buffer(ST_MakePoint(20,20),1)) ]\n" +" )\n" +"FROM\n" +" (SELECT ST_ExteriorRing(ST_Buffer(ST_MakePoint(10,10),10,10))\n" +" As line )\n" +" As foo;" +msgstr "" +"SELECT ST_MakePolygon(\n" +" ST_ExteriorRing(ST_Buffer(foo.line,10)),\n" +" ARRAY[ST_Translate(foo.line,1,1),\n" +" ST_ExteriorRing(ST_Buffer(ST_MakePoint(20,20),1)) ]\n" +" )\n" +"FROM\n" +" (SELECT ST_ExteriorRing(ST_Buffer(ST_MakePoint(10,10),10,10))\n" +" As line )\n" +" As foo;" + +#. Tag: para +#: reference_constructor.xml:1163 +#, no-c-format +msgid "" +"Build province boundaries with holes representing lakes in the province from " +"a set of province polygons/multipolygons and water line strings this is an " +"example of using PostGIS ST_Accum" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1167 +#, no-c-format +msgid "" +"The use of CASE because feeding a null array into ST_MakePolygon results in " +"NULL" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1169 +#, no-c-format +msgid "" +"the use of left join to guarantee we get all provinces back even if they " +"have no lakes" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1170 +#, no-c-format +msgid "" +"SELECT p.gid, p.province_name,\n" +" CASE WHEN\n" +" ST_Accum(w.the_geom) IS NULL THEN p.the_geom\n" +" ELSE ST_MakePolygon(ST_LineMerge(ST_Boundary(p.the_geom)), " +"ST_Accum(w.the_geom)) END\n" +" FROM\n" +" provinces p LEFT JOIN waterlines w\n" +" ON (ST_Within(w.the_geom, p.the_geom) AND " +"ST_IsClosed(w.the_geom))\n" +" GROUP BY p.gid, p.province_name, p.the_geom;\n" +"\n" +" --Same example above but utilizing a correlated subquery\n" +" --and PostgreSQL built-in ARRAY() function that converts a row set " +"to an array\n" +"\n" +" SELECT p.gid, p.province_name, CASE WHEN\n" +" EXISTS(SELECT w.the_geom\n" +" FROM waterlines w\n" +" WHERE ST_Within(w.the_geom, p.the_geom)\n" +" AND ST_IsClosed(w.the_geom))\n" +" THEN\n" +" ST_MakePolygon(ST_LineMerge(ST_Boundary(p.the_geom)),\n" +" ARRAY(SELECT w.the_geom\n" +" FROM waterlines w\n" +" WHERE ST_Within(w.the_geom, p.the_geom)\n" +" AND ST_IsClosed(w.the_geom)))\n" +" ELSE p.the_geom END As the_geom\n" +" FROM\n" +" provinces p;" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1174 +#, no-c-format +msgid "" +", , , " +", , " +msgstr "" +", , , " +", , " + +#. Tag: refname +#: reference_constructor.xml:1187 +#, no-c-format +msgid "ST_MakePoint" +msgstr "ST_MakePoint" + +#. Tag: refpurpose +#: reference_constructor.xml:1189 +#, no-c-format +msgid "Creates a 2D,3DZ or 4D point geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1194 +#, no-c-format +msgid "" +"geometry ST_MakePoint " +"double precision x " +"double precision y" +msgstr "" +"geometry ST_MakePoint " +"double precision x " +"double precision y" + +#. Tag: funcprototype +#: reference_constructor.xml:1201 +#, no-c-format +msgid "" +"geometry ST_MakePoint " +"double precision x " +"double precision y " +"double precision z" +msgstr "" +"geometry ST_MakePoint " +"double precision x " +"double precision y " +"double precision z" + +#. Tag: funcprototype +#: reference_constructor.xml:1209 +#, no-c-format +msgid "" +"geometry ST_MakePoint " +"double precision x " +"double precision y " +"double precision z " +"double precision m" +msgstr "" +"geometry ST_MakePoint " +"double precision x " +"double precision y " +"double precision z " +"double precision m" + +#. Tag: para +#: reference_constructor.xml:1222 +#, no-c-format +msgid "" +"Creates a 2D,3DZ or 4D point geometry (geometry with measure). " +"ST_MakePoint while not being OGC compliant is generally " +"faster and more precise than and . It is also easier to use if you have raw " +"coordinates rather than WKT." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1228 +#, no-c-format +msgid "Note x is longitude and y is latitude" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1229 +#, no-c-format +msgid "" +"Use if you need to make a point with x,y,m." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1236 +#, no-c-format +msgid "" +"--Return point with unknown SRID\n" +"SELECT ST_MakePoint(-71.1043443253471, 42.3150676015829);\n" +"\n" +"--Return point marked as WGS 84 long lat\n" +"SELECT ST_SetSRID(ST_MakePoint(-71.1043443253471, 42.3150676015829),4326);\n" +"\n" +"--Return a 3D point (e.g. has altitude)\n" +"SELECT ST_MakePoint(1, 2,1.5);\n" +"\n" +"--Get z of point\n" +"SELECT ST_Z(ST_MakePoint(1, 2,1.5));\n" +"result\n" +"-------\n" +"1.5" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1240 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" +", , , " +"" + +#. Tag: refname +#: reference_constructor.xml:1246 +#, no-c-format +msgid "ST_MakePointM" +msgstr "ST_MakePointM" + +#. Tag: refpurpose +#: reference_constructor.xml:1248 +#, no-c-format +msgid "Creates a point geometry with an x y and m coordinate." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1253 +#, no-c-format +msgid "" +"geometry ST_MakePointM " +"float x " +"float y " +"float m" +msgstr "" +"geometry ST_MakePointM " +"float x " +"float y " +"float m" + +#. Tag: para +#: reference_constructor.xml:1265 +#, no-c-format +msgid "Creates a point with x, y and measure coordinates." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1266 +#, no-c-format +msgid "Note x is longitude and y is latitude." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1271 +#, no-c-format +msgid "" +"We use ST_AsEWKT in these examples to show the text representation instead " +"of ST_AsText because ST_AsText does not support returning M." +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1273 +#, no-c-format +msgid "" +"--Return EWKT representation of point with unknown SRID\n" +"SELECT ST_AsEWKT(ST_MakePointM(-71.1043443253471, 42.3150676015829, 10));\n" +"\n" +"--result\n" +" st_asewkt\n" +"-----------------------------------------------\n" +" POINTM(-71.1043443253471 42.3150676015829 10)\n" +"\n" +"--Return EWKT representation of point with measure marked as WGS 84 long " +"lat\n" +"SELECT ST_AsEWKT(ST_SetSRID(ST_MakePointM(-71.1043443253471, " +"42.3150676015829,10),4326));\n" +"\n" +" st_asewkt\n" +"---------------------------------------------------------\n" +"SRID=4326;POINTM(-71.1043443253471 42.3150676015829 10)\n" +"\n" +"--Return a 3d point (e.g. has altitude)\n" +"SELECT ST_MakePoint(1, 2,1.5);\n" +"\n" +"--Get m of point\n" +"SELECT ST_M(ST_MakePointM(-71.1043443253471, 42.3150676015829,10));\n" +"result\n" +"-------\n" +"10" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1277 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_constructor.xml:1283 +#, no-c-format +msgid "ST_MLineFromText" +msgstr "ST_MLineFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:1285 +#, no-c-format +msgid "Return a specified ST_MultiLineString value from WKT representation." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:1289 +#, no-c-format +msgid "" +" geometry ST_MLineFromText text WKT " +"integer srid geometry ST_MLineFromText text WKT " +msgstr "" +" geometry ST_MLineFromText text WKT " +"integer srid geometry ST_MLineFromText text WKT " + +#. Tag: para +#: reference_constructor.xml:1307 +#, no-c-format +msgid "" +"Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is " +"not give, it defaults to -1." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1313 +#, no-c-format +msgid "Returns null if the WKT is not a MULTILINESTRING" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1316 reference_constructor.xml:1377 +#, no-c-format +msgid "" +"If you are absolutely sure all your WKT geometries are points, don't use " +"this function. It is slower than ST_GeomFromText since it adds an additional " +"validation step." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1322 +#, no-c-format +msgid "&sqlmm_compliant;SQL-MM 3: 9.4.4" +msgstr "&sqlmm_compliant;SQL-MM 3: 9.4.4" + +#. Tag: programlisting +#: reference_constructor.xml:1330 +#, no-c-format +msgid "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');" +msgstr "SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');" + +#. Tag: refname +#: reference_constructor.xml:1343 +#, no-c-format +msgid "ST_MPointFromText" +msgstr "ST_MPointFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:1345 reference_constructor.xml:1675 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not " +"give, it defaults to -1." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:1350 +#, no-c-format +msgid "" +" geometry ST_MPointFromText text WKT " +"integer srid geometry " +"ST_MPointFromText text WKT " +msgstr "" +" geometry ST_MPointFromText text WKT " +"integer srid geometry " +"ST_MPointFromText text WKT " + +#. Tag: para +#: reference_constructor.xml:1368 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not give, it " +"defaults to -1." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1374 +#, no-c-format +msgid "Returns null if the WKT is not a MULTIPOINT" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1382 +#, no-c-format +msgid "&sfs_compliant; 3.2.6.2" +msgstr "&sfs_compliant; 3.2.6.2" + +#. Tag: para +#: reference_constructor.xml:1383 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 9.2.4" +msgstr "&sqlmm_compliant; SQL-MM 3: 9.2.4" + +#. Tag: programlisting +#: reference_constructor.xml:1391 +#, no-c-format +msgid "" +"SELECT ST_MPointFromText('MULTIPOINT(1 2, 3 4)');\n" +"SELECT ST_MPointFromText('MULTIPOINT(-70.9590 42.1180, -70.9611 42.1223)', " +"4326);" +msgstr "" +"SELECT ST_MPointFromText('MULTIPOINT(1 2, 3 4)');\n" +"SELECT ST_MPointFromText('MULTIPOINT(-70.9590 42.1180, -70.9611 42.1223)', " +"4326);" + +#. Tag: refname +#: reference_constructor.xml:1404 +#, no-c-format +msgid "ST_MPolyFromText" +msgstr "ST_MPolyFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:1406 +#, no-c-format +msgid "" +"Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not " +"give, it defaults to -1." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:1411 +#, no-c-format +msgid "" +" geometry ST_MPolyFromText text WKT " +"integer srid geometry ST_MPolyFromText text WKT " +msgstr "" +" geometry ST_MPolyFromText text WKT " +"integer srid geometry ST_MPolyFromText text WKT " + +#. Tag: para +#: reference_constructor.xml:1429 +#, no-c-format +msgid "" +"Makes a MultiPolygon from WKT with the given SRID. If SRID is not give, it " +"defaults to -1." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1435 +#, no-c-format +msgid "Throws an error if the WKT is not a MULTIPOLYGON" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1438 +#, no-c-format +msgid "" +"If you are absolutely sure all your WKT geometries are multipolygons, don't " +"use this function. It is slower than ST_GeomFromText since it adds an " +"additional validation step." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1444 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 9.6.4" +msgstr "&sqlmm_compliant; SQL-MM 3: 9.6.4" + +#. Tag: programlisting +#: reference_constructor.xml:1452 +#, no-c-format +msgid "" +"SELECT ST_MPolyFromText('MULTIPOLYGON(((0 0 1,20 0 1,20 20 1,0 20 1,0 0 1)," +"(5 5 3,5 7 3,7 7 3,7 5 3,5 5 3)))');\n" +"SELECt ST_MPolyFromText('MULTIPOLYGON(((-70.916 42.1002,-70.9468 " +"42.0946,-70.9765 42.0872,-70.9754 42.0875,-70.9749 42.0879,-70.9752 " +"42.0881,-70.9754 42.0891,-70.9758 42.0894,-70.9759 42.0897,-70.9759 " +"42.0899,-70.9754 42.0902,-70.9756 42.0906,-70.9753 42.0907,-70.9753 " +"42.0917,-70.9757 42.0924,-70.9755 42.0928,-70.9755 42.0942,-70.9751 " +"42.0948,-70.9755 42.0953,-70.9751 42.0958,-70.9751 42.0962,-70.9759 " +"42.0983,-70.9767 42.0987,-70.9768 42.0991,-70.9771 42.0997,-70.9771 " +"42.1003,-70.9768 42.1005,-70.977 42.1011,-70.9766 42.1019,-70.9768 " +"42.1026,-70.9769 42.1033,-70.9775 42.1042,-70.9773 42.1043,-70.9776 " +"42.1043,-70.9778 42.1048,-70.9773 42.1058,-70.9774 42.1061,-70.9779 " +"42.1065,-70.9782 42.1078,-70.9788 42.1085,-70.9798 42.1087,-70.9806 " +"42.109,-70.9807 42.1093,-70.9806 42.1099,-70.9809 42.1109,-70.9808 " +"42.1112,-70.9798 42.1116,-70.9792 42.1127,-70.979 42.1129,-70.9787 " +"42.1134,-70.979 42.1139,-70.9791 42.1141,-70.9987 42.1116,-71.0022 42.1273,\n" +" -70.9408 42.1513,-70.9315 42.1165,-70.916 42.1002)))',4326);" +msgstr "" +"SELECT ST_MPolyFromText('MULTIPOLYGON(((0 0 1,20 0 1,20 20 1,0 20 1,0 0 1)," +"(5 5 3,5 7 3,7 7 3,7 5 3,5 5 3)))');\n" +"SELECt ST_MPolyFromText('MULTIPOLYGON(((-70.916 42.1002,-70.9468 " +"42.0946,-70.9765 42.0872,-70.9754 42.0875,-70.9749 42.0879,-70.9752 " +"42.0881,-70.9754 42.0891,-70.9758 42.0894,-70.9759 42.0897,-70.9759 " +"42.0899,-70.9754 42.0902,-70.9756 42.0906,-70.9753 42.0907,-70.9753 " +"42.0917,-70.9757 42.0924,-70.9755 42.0928,-70.9755 42.0942,-70.9751 " +"42.0948,-70.9755 42.0953,-70.9751 42.0958,-70.9751 42.0962,-70.9759 " +"42.0983,-70.9767 42.0987,-70.9768 42.0991,-70.9771 42.0997,-70.9771 " +"42.1003,-70.9768 42.1005,-70.977 42.1011,-70.9766 42.1019,-70.9768 " +"42.1026,-70.9769 42.1033,-70.9775 42.1042,-70.9773 42.1043,-70.9776 " +"42.1043,-70.9778 42.1048,-70.9773 42.1058,-70.9774 42.1061,-70.9779 " +"42.1065,-70.9782 42.1078,-70.9788 42.1085,-70.9798 42.1087,-70.9806 " +"42.109,-70.9807 42.1093,-70.9806 42.1099,-70.9809 42.1109,-70.9808 " +"42.1112,-70.9798 42.1116,-70.9792 42.1127,-70.979 42.1129,-70.9787 " +"42.1134,-70.979 42.1139,-70.9791 42.1141,-70.9987 42.1116,-71.0022 42.1273,\n" +" -70.9408 42.1513,-70.9315 42.1165,-70.916 42.1002)))',4326);" + +#. Tag: refname +#: reference_constructor.xml:1465 +#, no-c-format +msgid "ST_Point" +msgstr "ST_Point" + +#. Tag: refpurpose +#: reference_constructor.xml:1467 +#, no-c-format +msgid "" +"Returns an ST_Point with the given coordinate values. OGC alias for " +"ST_MakePoint." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1472 +#, no-c-format +msgid "" +"geometry ST_Point " +"float x_lon " +"float y_lat" +msgstr "" +"geometry ST_Point " +"float x_lon " +"float y_lat" + +#. Tag: para +#: reference_constructor.xml:1483 +#, no-c-format +msgid "" +"Returns an ST_Point with the given coordinate values. MM compliant alias for " +"ST_MakePoint that takes just an x and y." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1486 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.2" +msgstr "&sqlmm_compliant; SQL-MM 3: 6.1.2" + +#. Tag: title +#: reference_constructor.xml:1492 +#, no-c-format +msgid "Examples: Geometry" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1494 +#, no-c-format +msgid "SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)" +msgstr "SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)" + +#. Tag: title +#: reference_constructor.xml:1498 +#, no-c-format +msgid "Examples: Geography" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1500 +#, no-c-format +msgid "" +"SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) " +"As geography);" +msgstr "" +"SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) " +"As geography);" + +#. Tag: programlisting +#: reference_constructor.xml:1501 +#, no-c-format +msgid "" +"-- the :: is PostgreSQL short-hand for casting.\n" +"SELECT ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326)::" +"geography;" +msgstr "" + +#. Tag: programlisting +#: reference_constructor.xml:1503 +#, no-c-format +msgid "" +"--If your point coordinates are in a different spatial reference from WGS-84 " +"long lat, then you need to transform before casting\n" +"-- This example we convert a point in Pennsylvania State Plane feet to WGS " +"84 and then geography\n" +"SELECT ST_Transform(ST_SetSRID(ST_Point(3637510, 3014852),2273),4326)::" +"geography;" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1510 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_constructor.xml:1516 +#, no-c-format +msgid "ST_PointFromText" +msgstr "ST_PointFromText" + +#. Tag: refpurpose +#: reference_constructor.xml:1517 +#, no-c-format +msgid "" +"Makes a point Geometry from WKT with the given SRID. If SRID is not given, " +"it defaults to unknown." +msgstr "" + +#. Tag: funcsynopsis +#: reference_constructor.xml:1521 +#, no-c-format +msgid "" +" geometry ST_PointFromText text WKT " +" geometry " +"ST_PointFromText text " +"WKT integer " +"srid " +msgstr "" +" geometry ST_PointFromText text WKT " +" geometry " +"ST_PointFromText text " +"WKT integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:1537 +#, no-c-format +msgid "" +"Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text " +"representation. If SRID is not give, it defaults to unknown (currently -1). " +"If geometry is not a WKT point representation, returns null. If completely " +"invalid WKT, then throws an error." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1543 +#, no-c-format +msgid "" +"There are 2 variants of ST_PointFromText function, the first takes no SRID " +"and returns a geometry with no defined spatial reference system. The second " +"takes a spatial reference id as the second argument and returns an " +"ST_Geometry that includes this srid as part of its meta-data. The srid must " +"be defined in the spatial_ref_sys table." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1550 +#, no-c-format +msgid "" +"If you are absolutely sure all your WKT geometries are points, don't use " +"this function. It is slower than ST_GeomFromText since it adds an additional " +"validation step. If you are building points from long lat coordinates and " +"care more about performance and accuracy than OGC compliance, use or OGC compliant alias ." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1555 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.8" +msgstr "&sqlmm_compliant; SQL-MM 3: 6.1.8" + +#. Tag: programlisting +#: reference_constructor.xml:1560 +#, no-c-format +msgid "" +"SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n" +"SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);" +msgstr "" +"SELECT ST_PointFromText('POINT(-71.064544 42.28787)');\n" +"SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);" + +#. Tag: para +#: reference_constructor.xml:1564 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_constructor.xml:1570 +#, no-c-format +msgid "ST_PointFromWKB" +msgstr "ST_PointFromWKB" + +#. Tag: refpurpose +#: reference_constructor.xml:1572 +#, no-c-format +msgid "Makes a geometry from WKB with the given SRID" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1593 +#, no-c-format +msgid "" +"The ST_PointFromWKB function, takes a well-known binary " +"representation of geometry and a Spatial Reference System ID (SRID) and creates an instance of the appropriate geometry type - in this " +"case, a POINT geometry. This function plays the role of " +"the Geometry Factory in SQL." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1599 +#, no-c-format +msgid "" +"If an SRID is not specified, it defaults to -1. NULL is " +"returned if the input bytea does not represent a " +"POINT geometry." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1602 +#, no-c-format +msgid "&sfs_compliant; s3.2.7.2" +msgstr "&sfs_compliant; s3.2.7.2" + +#. Tag: para +#: reference_constructor.xml:1603 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 6.1.9" +msgstr "&sqlmm_compliant; SQL-MM 3: 6.1.9" + +#. Tag: programlisting +#: reference_constructor.xml:1611 +#, no-c-format +msgid "" +"SELECT\n" +" ST_AsText(\n" +" ST_PointFromWKB(\n" +" ST_AsEWKB('POINT(2 5)'::geometry)\n" +" )\n" +" );\n" +" st_astext\n" +"------------\n" +" POINT(2 5)\n" +"(1 row)\n" +"\n" +"SELECT\n" +" ST_AsText(\n" +" ST_PointFromWKB(\n" +" ST_AsEWKB('LINESTRING(2 5, 2 6)'::geometry)\n" +" )\n" +" );\n" +" st_astext\n" +"-----------\n" +"\n" +"(1 row)" +msgstr "" +"SELECT\n" +" ST_AsText(\n" +" ST_PointFromWKB(\n" +" ST_AsEWKB('POINT(2 5)'::geometry)\n" +" )\n" +" );\n" +" st_astext\n" +"------------\n" +" POINT(2 5)\n" +"(1 row)\n" +"\n" +"SELECT\n" +" ST_AsText(\n" +" ST_PointFromWKB(\n" +" ST_AsEWKB('LINESTRING(2 5, 2 6)'::geometry)\n" +" )\n" +" );\n" +" st_astext\n" +"-----------\n" +"\n" +"(1 row)" + +#. Tag: refname +#: reference_constructor.xml:1624 +#, no-c-format +msgid "ST_Polygon" +msgstr "ST_Polygon" + +#. Tag: refpurpose +#: reference_constructor.xml:1626 +#, no-c-format +msgid "" +"Returns a polygon built from the specified linestring and SRID." +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1631 +#, no-c-format +msgid "" +"geometry ST_Polygon " +"geometry aLineString integer srid" +msgstr "" +"geometry ST_Polygon " +"geometry aLineString integer srid" + +#. Tag: para +#: reference_constructor.xml:1642 +#, no-c-format +msgid "" +"Returns a polygon built from the specified linestring and SRID." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1646 +#, no-c-format +msgid "" +"ST_Polygon is similar to first version oST_MakePolygon except it also sets " +"the spatial ref sys (SRID) of the polygon. Will not work with " +"MULTILINESTRINGS so use LineMerge to merge multilines. Also does not create " +"polygons with holes. Use ST_MakePolygon for that." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1651 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.3.2" +msgstr "&sqlmm_compliant; SQL-MM 3: 8.3.2" + +#. Tag: programlisting +#: reference_constructor.xml:1660 +#, no-c-format +msgid "" +"--a 2d polygon\n" +"SELECT ST_Polygon(ST_GeomFromText('LINESTRING(75.15 29.53,77 29,77.6 29.5, " +"75.15 29.53)'), 4326);\n" +"\n" +"--result--\n" +"POLYGON((75.15 29.53,77 29,77.6 29.5,75.15 29.53))\n" +"--a 3d polygon\n" +"SELECT ST_AsEWKT(ST_Polygon(ST_GeomFromEWKT('LINESTRING(75.15 29.53 1,77 29 " +"1,77.6 29.5 1, 75.15 29.53 1)'), 4326));\n" +"\n" +"result\n" +"------\n" +"SRID=4326;POLYGON((75.15 29.53 1,77 29 1,77.6 29.5 1,75.15 29.53 1))" +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1667 +#, no-c-format +msgid "" +", , , , , " +msgstr "" +", , , , , " + +#. Tag: refname +#: reference_constructor.xml:1673 +#, no-c-format +msgid "ST_PolygonFromText" +msgstr "ST_PolygonFromText" + +#. Tag: funcsynopsis +#: reference_constructor.xml:1680 +#, no-c-format +msgid "" +" geometry ST_PolygonFromText text WKT " +" geometry " +"ST_PolygonFromText text WKT integer " +"srid " +msgstr "" +" geometry ST_PolygonFromText text WKT " +" geometry " +"ST_PolygonFromText text WKT integer " +"srid " + +#. Tag: para +#: reference_constructor.xml:1696 +#, no-c-format +msgid "" +"Makes a Geometry from WKT with the given SRID. If SRID is not give, it " +"defaults to -1. Returns null if WKT is not a polygon." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1703 +#, no-c-format +msgid "" +"If you are absolutely sure all your WKT geometries are polygons, don't use " +"this function. It is slower than ST_GeomFromText since it adds an additional " +"validation step." +msgstr "" + +#. Tag: para +#: reference_constructor.xml:1706 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.3.6" +msgstr "&sqlmm_compliant; SQL-MM 3: 8.3.6" + +#. Tag: programlisting +#: reference_constructor.xml:1712 +#, no-c-format +msgid "" +"SELECT ST_PolygonFromText('POLYGON((-71.1776585052917 " +"42.3902909739571,-71.1776820268866 42.3903701743239,\n" +"-71.1776063012595 42.3903825660754,-71.1775826583081 " +"42.3903033653531,-71.1776585052917 42.3902909739571))');\n" +"st_polygonfromtext\n" +"------------------\n" +"010300000001000000050000006...\n" +"\n" +"\n" +"SELECT ST_PolygonFromText('POINT(1 2)') IS NULL as point_is_notpoly;\n" +"\n" +"point_is_not_poly\n" +"----------\n" +"t" +msgstr "" +"SELECT ST_PolygonFromText('POLYGON((-71.1776585052917 " +"42.3902909739571,-71.1776820268866 42.3903701743239,\n" +"-71.1776063012595 42.3903825660754,-71.1775826583081 " +"42.3903033653531,-71.1776585052917 42.3902909739571))');\n" +"st_polygonfromtext\n" +"------------------\n" +"010300000001000000050000006...\n" +"\n" +"\n" +"SELECT ST_PolygonFromText('POINT(1 2)') IS NULL as point_is_notpoly;\n" +"\n" +"point_is_not_poly\n" +"----------\n" +"t" + +#. Tag: refname +#: reference_constructor.xml:1725 +#, no-c-format +msgid "ST_WKBToSQL" +msgstr "ST_WKBToSQL" + +#. Tag: refpurpose +#: reference_constructor.xml:1726 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from Well-Known Binary representation " +"(WKB). This is an alias name for ST_GeomFromWKB that takes no srid" +msgstr "" + +#. Tag: funcprototype +#: reference_constructor.xml:1730 +#, no-c-format +msgid "" +"geometry ST_WKBToSQL " +"bytea WKB" +msgstr "" +"geometry ST_WKBToSQL " +"bytea WKB" + +#. Tag: para +#: reference_constructor.xml:1738 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.36" +msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.36" + +#. Tag: refname +#: reference_constructor.xml:1748 +#, no-c-format +msgid "ST_WKTToSQL" +msgstr "ST_WKTToSQL" + +#. Tag: funcprototype +#: reference_constructor.xml:1753 +#, no-c-format +msgid "" +"geometry ST_WKTToSQL " +"text WKT" +msgstr "" +"geometry ST_WKTToSQL " +"text WKT" + +#. Tag: para +#: reference_constructor.xml:1761 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.34" +msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.34" diff --git a/doc/po/pl/reference_editor.xml.po b/doc/po/pl/reference_editor.xml.po new file mode 100644 index 000000000..11516892c --- /dev/null +++ b/doc/po/pl/reference_editor.xml.po @@ -0,0 +1,2697 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2014-01-02 14:22+0000\n" +"Last-Translator: Jakub Bobrowski \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_editor.xml:3 +#, no-c-format +msgid "Geometry Editors" +msgstr "" + +#. Tag: refname +#: reference_editor.xml:7 +#, no-c-format +msgid "ST_AddPoint" +msgstr "ST_AddPoint" + +#. Tag: refpurpose +#: reference_editor.xml:8 +#, no-c-format +msgid "" +"Adds a point to a LineString before point <position> (0-based index)." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:13 +#, no-c-format +msgid "" +"geometry ST_AddPoint " +"geometry linestring " +"geometry point" +msgstr "" +"geometry ST_AddPoint " +"geometry linestring " +"geometry point" + +#. Tag: funcprototype +#: reference_editor.xml:20 +#, no-c-format +msgid "" +"geometry ST_AddPoint " +"geometry linestring " +"geometry point " +"integer position" +msgstr "" +"geometry ST_AddPoint " +"geometry linestring " +"geometry point " +"integer position" + +#. Tag: title +#: reference_editor.xml:30 reference_editor.xml:89 reference_editor.xml:148 +#: reference_editor.xml:193 reference_editor.xml:235 reference_editor.xml:277 +#: reference_editor.xml:317 reference_editor.xml:357 reference_editor.xml:407 +#: reference_editor.xml:453 reference_editor.xml:495 reference_editor.xml:543 +#: reference_editor.xml:582 reference_editor.xml:616 reference_editor.xml:649 +#: reference_editor.xml:693 reference_editor.xml:742 reference_editor.xml:789 +#: reference_editor.xml:838 reference_editor.xml:902 reference_editor.xml:962 +#: reference_editor.xml:1004 reference_editor.xml:1047 +#: reference_editor.xml:1124 reference_editor.xml:1202 +#: reference_editor.xml:1338 reference_editor.xml:1421 +#: reference_editor.xml:1475 +#, no-c-format +msgid "Description" +msgstr "Opis" + +#. Tag: para +#: reference_editor.xml:32 +#, no-c-format +msgid "" +"Adds a point to a LineString before point <position> (0-based index). " +"Third parameter can be omitted or set to -1 for appending." +msgstr "" + +#. Tag: para +#: reference_editor.xml:35 reference_editor.xml:460 reference_editor.xml:619 +#: reference_editor.xml:1009 +#, no-c-format +msgid "Availability: 1.1.0" +msgstr "Dostępność: 1.1.0" + +#. Tag: para +#: reference_editor.xml:36 reference_editor.xml:111 reference_editor.xml:158 +#: reference_editor.xml:200 reference_editor.xml:241 reference_editor.xml:321 +#: reference_editor.xml:366 reference_editor.xml:416 reference_editor.xml:620 +#: reference_editor.xml:702 reference_editor.xml:752 reference_editor.xml:800 +#: reference_editor.xml:851 reference_editor.xml:917 reference_editor.xml:1011 +#: reference_editor.xml:1155 reference_editor.xml:1429 +#: reference_editor.xml:1488 +#, no-c-format +msgid "&Z_support;" +msgstr "&Z_support;" + +#. Tag: title +#: reference_editor.xml:40 reference_editor.xml:117 reference_editor.xml:163 +#: reference_editor.xml:205 reference_editor.xml:247 reference_editor.xml:287 +#: reference_editor.xml:327 reference_editor.xml:372 reference_editor.xml:421 +#: reference_editor.xml:465 reference_editor.xml:514 reference_editor.xml:554 +#: reference_editor.xml:590 reference_editor.xml:624 reference_editor.xml:655 +#: reference_editor.xml:711 reference_editor.xml:758 reference_editor.xml:807 +#: reference_editor.xml:859 reference_editor.xml:924 reference_editor.xml:976 +#: reference_editor.xml:1015 reference_editor.xml:1063 +#: reference_editor.xml:1160 reference_editor.xml:1236 +#: reference_editor.xml:1366 reference_editor.xml:1434 +#: reference_editor.xml:1494 +#, no-c-format +msgid "Examples" +msgstr "Przykłady" + +#. Tag: programlisting +#: reference_editor.xml:41 +#, no-c-format +msgid "" +"--guarantee all linestrings in a table are closed\n" +" --by adding the start point of each linestring to the end of " +"the line string\n" +" --only for those that are not closed\n" +" UPDATE sometable\n" +" SET the_geom = ST_AddPoint(the_geom, " +"ST_StartPoint(the_geom))\n" +" FROM sometable\n" +" WHERE ST_IsClosed(the_geom) = false;\n" +"\n" +" --Adding point to a 3-d line\n" +" SELECT ST_AsEWKT(ST_AddPoint(ST_GeomFromEWKT('LINESTRING(0 0 " +"1, 1 1 1)'), ST_MakePoint(1, 2, 3)));\n" +"\n" +" --result\n" +" st_asewkt\n" +" ----------\n" +" LINESTRING(0 0 1,1 1 1,1 2 3)" +msgstr "" + +#. Tag: title +#: reference_editor.xml:44 reference_editor.xml:124 reference_editor.xml:170 +#: reference_editor.xml:212 reference_editor.xml:254 reference_editor.xml:294 +#: reference_editor.xml:334 reference_editor.xml:381 reference_editor.xml:427 +#: reference_editor.xml:470 reference_editor.xml:519 reference_editor.xml:559 +#: reference_editor.xml:595 reference_editor.xml:628 reference_editor.xml:718 +#: reference_editor.xml:765 reference_editor.xml:814 reference_editor.xml:866 +#: reference_editor.xml:931 reference_editor.xml:981 reference_editor.xml:1019 +#: reference_editor.xml:1071 reference_editor.xml:1167 +#: reference_editor.xml:1311 reference_editor.xml:1388 +#: reference_editor.xml:1447 reference_editor.xml:1501 +#, no-c-format +msgid "See Also" +msgstr "Zobacz także" + +#. Tag: para +#: reference_editor.xml:45 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_editor.xml:51 +#, no-c-format +msgid "ST_Affine" +msgstr "ST_Affine" + +#. Tag: refpurpose +#: reference_editor.xml:53 +#, no-c-format +msgid "" +"Applies a 3d affine transformation to the geometry to do things " +"like translate, rotate, scale in one step." +msgstr "" + +#. Tag: funcsynopsis +#: reference_editor.xml:57 +#, no-c-format +msgid "" +" geometry ST_Affine " +"geometry geomA " +"float a " +"float b " +"float c " +"float d " +"float e " +"float f " +"float g " +"float h " +"float i " +"float xoff " +"float yoff " +"float zoff geometry ST_Affine geometry geomA float a float b float d float e float xoff float yoff " +msgstr "" +" geometry ST_Affine " +"geometry geomA " +"float a " +"float b " +"float c " +"float d " +"float e " +"float f " +"float g " +"float h " +"float i " +"float xoff " +"float yoff " +"float zoff geometry ST_Affine geometry geomA float a float b float d float e float xoff float yoff " + +#. Tag: para +#: reference_editor.xml:91 +#, no-c-format +msgid "" +"Applies a 3d affine transformation to the geometry to do things like " +"translate, rotate, scale in one step." +msgstr "" + +#. Tag: para +#: reference_editor.xml:92 +#, no-c-format +msgid "" +"Version 1: The call ST_Affine(geom, a, b, c, d, e, f, g, h, " +"i, xoff, yoff, zoff) represents the transformation matrix " +"/ a b c xoff \\\n" +"| d e f yoff |\n" +"| g h i zoff |\n" +"\\ 0 0 0 1 / and the vertices are transformed as " +"follows: x' = a*x + b*y + c*z + xoff\n" +"y' = d*x + e*y + f*z + yoff\n" +"z' = g*x + h*y + i*z + zoff All of the translate / scale " +"functions below are expressed via such an affine transformation." +msgstr "" + +#. Tag: para +#: reference_editor.xml:99 +#, no-c-format +msgid "" +"Version 2: Applies a 2d affine transformation to the geometry. The call " +"ST_Affine(geom, a, b, d, e, xoff, yoff) " +"represents the transformation matrix / a b 0 xoff " +"\\ / a b xoff \\\n" +"| d e 0 yoff | rsp. | d e yoff |\n" +"| 0 0 1 0 | \\ 0 0 1 /\n" +"\\ 0 0 0 1 / and the vertices are transformed as " +"follows: x' = a*x + b*y + xoff\n" +"y' = d*x + e*y + yoff\n" +"z' = z This method is a subcase of the 3D method above." +msgstr "" + +#. Tag: para +#: reference_editor.xml:105 reference_editor.xml:699 reference_editor.xml:749 +#: reference_editor.xml:797 reference_editor.xml:846 reference_editor.xml:915 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_editor.xml:106 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from Affine to ST_Affine in 1.2.2" +msgstr "" +"Dostępność: 1.1.2. Nazwa zmieniona z Affine na ST_Affine w wersji 1.2.2" + +#. Tag: para +#: reference_editor.xml:107 reference_editor.xml:849 reference_editor.xml:911 +#: reference_editor.xml:1356 reference_editor.xml:1426 +#: reference_editor.xml:1484 +#, no-c-format +msgid "" +"Prior to 1.3.4, this function crashes if used with geometries that contain " +"CURVES. This is fixed in 1.3.4+" +msgstr "" + +#. Tag: para +#: reference_editor.xml:109 reference_editor.xml:157 reference_editor.xml:198 +#: reference_editor.xml:240 reference_editor.xml:365 reference_editor.xml:417 +#: reference_editor.xml:704 reference_editor.xml:751 reference_editor.xml:799 +#: reference_editor.xml:853 reference_editor.xml:916 reference_editor.xml:1361 +#, no-c-format +msgid "&P_support;" +msgstr "&P_support;" + +#. Tag: para +#: reference_editor.xml:110 reference_editor.xml:705 reference_editor.xml:753 +#: reference_editor.xml:801 reference_editor.xml:854 reference_editor.xml:919 +#, no-c-format +msgid "&T_support;" +msgstr "&T_support;" + +#. Tag: para +#: reference_editor.xml:112 reference_editor.xml:156 reference_editor.xml:199 +#: reference_editor.xml:242 reference_editor.xml:282 reference_editor.xml:322 +#: reference_editor.xml:367 reference_editor.xml:703 reference_editor.xml:852 +#: reference_editor.xml:918 reference_editor.xml:1059 +#: reference_editor.xml:1360 reference_editor.xml:1430 +#: reference_editor.xml:1489 +#, no-c-format +msgid "&curve_support;" +msgstr "&curve_support;" + +#. Tag: programlisting +#: reference_editor.xml:119 +#, no-c-format +msgid "" +"--Rotate a 3d line 180 degrees about the z axis. Note this is long-hand for " +"doing ST_Rotate();\n" +" SELECT ST_AsEWKT(ST_Affine(the_geom, cos(pi()), -sin(pi()), 0, sin(pi()), " +"cos(pi()), 0, 0, 0, 1, 0, 0, 0)) As using_affine,\n" +" ST_AsEWKT(ST_Rotate(the_geom, pi())) As using_rotate\n" +" FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As " +"the_geom) As foo;\n" +" using_affine | using_rotate\n" +"-----------------------------+-----------------------------\n" +" LINESTRING(-1 -2 3,-1 -4 3) | LINESTRING(-1 -2 3,-1 -4 3)\n" +"(1 row)\n" +"\n" +"--Rotate a 3d line 180 degrees in both the x and z axis\n" +"SELECT ST_AsEWKT(ST_Affine(the_geom, cos(pi()), -sin(pi()), 0, sin(pi()), " +"cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), 0, 0, 0))\n" +" FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As " +"the_geom) As foo;\n" +" st_asewkt\n" +"-------------------------------\n" +" LINESTRING(-1 -2 -3,-1 -4 -3)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:126 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_editor.xml:132 +#, no-c-format +msgid "ST_Force_2D" +msgstr "ST_Force_2D" + +#. Tag: refpurpose +#: reference_editor.xml:134 +#, no-c-format +msgid "" +"Forces the geometries into a \"2-dimensional mode\" so that all output " +"representations will only have the X and Y coordinates." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:140 +#, no-c-format +msgid "" +"geometry ST_Force_2D " +"geometry geomA" +msgstr "" +"geometry ST_Force_2D " +"geometry geomA" + +#. Tag: para +#: reference_editor.xml:150 +#, no-c-format +msgid "" +"Forces the geometries into a \"2-dimensional mode\" so that all output " +"representations will only have the X and Y coordinates. This is useful for " +"force OGC-compliant output (since OGC only specifies 2-D geometries)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:155 reference_editor.xml:197 reference_editor.xml:239 +#: reference_editor.xml:362 reference_editor.xml:415 reference_editor.xml:1358 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:165 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_Force_2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 " +"5 2, 6 7 2, 5 6 2)')));\n" +" st_asewkt\n" +"-------------------------------------\n" +"CIRCULARSTRING(1 1,2 3,4 5,6 7,5 6)\n" +"\n" +"SELECT ST_AsEWKT(ST_Force_2D('POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 " +"2,1 3 2,1 1 2))'));\n" +"\n" +" st_asewkt\n" +"----------------------------------------------\n" +" POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))" +msgstr "" +"SELECT ST_AsEWKT(ST_Force_2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 " +"5 2, 6 7 2, 5 6 2)')));\n" +" st_asewkt\n" +"-------------------------------------\n" +"CIRCULARSTRING(1 1,2 3,4 5,6 7,5 6)\n" +"\n" +"SELECT ST_AsEWKT(ST_Force_2D('POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 " +"2,1 3 2,1 1 2))'));\n" +"\n" +" st_asewkt\n" +"----------------------------------------------\n" +" POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))" + +#. Tag: refname +#: reference_editor.xml:178 +#, no-c-format +msgid "ST_Force_3D" +msgstr "ST_Force_3D" + +#. Tag: refpurpose +#: reference_editor.xml:180 +#, no-c-format +msgid "Forces the geometries into XYZ mode. This is an alias for ST_Force_3DZ." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:185 +#, no-c-format +msgid "" +"geometry ST_Force_3D " +"geometry geomA" +msgstr "" +"geometry ST_Force_3D " +"geometry geomA" + +#. Tag: para +#: reference_editor.xml:195 +#, no-c-format +msgid "" +"Forces the geometries into XYZ mode. This is an alias for ST_Force_3DZ. If a " +"geometry has no Z component, then a 0 Z coordinate is tacked on." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:207 +#, no-c-format +msgid "" +"--Nothing happens to an already 3D geometry\n" +" SELECT " +"ST_AsEWKT(ST_Force_3D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 " +"7 2, 5 6 2)')));\n" +" st_asewkt\n" +"-----------------------------------------------\n" +" CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)\n" +"\n" +"\n" +"SELECT ST_AsEWKT(ST_Force_3D('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 " +"1))'));\n" +"\n" +" st_asewkt\n" +"--------------------------------------------------------------\n" +" POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))" +msgstr "" + +#. Tag: para +#: reference_editor.xml:214 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_editor.xml:220 +#, no-c-format +msgid "ST_Force_3DZ" +msgstr "ST_Force_3DZ" + +#. Tag: refpurpose +#: reference_editor.xml:222 +#, no-c-format +msgid "Forces the geometries into XYZ mode. This is a synonym for ST_Force_3D." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:227 +#, no-c-format +msgid "" +"geometry ST_Force_3DZ " +"geometry geomA" +msgstr "" +"geometry ST_Force_3DZ " +"geometry geomA" + +#. Tag: para +#: reference_editor.xml:237 +#, no-c-format +msgid "" +"Forces the geometries into XYZ mode. This is a synonym for ST_Force_3DZ. If " +"a geometry has no Z component, then a 0 Z coordinate is tacked on." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:249 +#, no-c-format +msgid "" +"--Nothing happens to an already 3D geometry\n" +"SELECT ST_AsEWKT(ST_Force_3DZ(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, " +"4 5 2, 6 7 2, 5 6 2)')));\n" +" st_asewkt\n" +"-----------------------------------------------\n" +" CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)\n" +"\n" +"\n" +"SELECT ST_AsEWKT(ST_Force_3DZ('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 " +"1))'));\n" +"\n" +" st_asewkt\n" +"--------------------------------------------------------------\n" +" POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))" +msgstr "" + +#. Tag: para +#: reference_editor.xml:256 reference_editor.xml:336 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_editor.xml:262 +#, no-c-format +msgid "ST_Force_3DM" +msgstr "ST_Force_3DM" + +#. Tag: refpurpose +#: reference_editor.xml:264 +#, no-c-format +msgid "Forces the geometries into XYM mode." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:269 +#, no-c-format +msgid "" +"geometry ST_Force_3DM " +"geometry geomA" +msgstr "" +"geometry ST_Force_3DM " +"geometry geomA" + +#. Tag: para +#: reference_editor.xml:279 +#, no-c-format +msgid "" +"Forces the geometries into XYM mode. If a geometry has no M component, then " +"a 0 M coordinate is tacked on. If it has a Z component, then Z is removed" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:289 +#, no-c-format +msgid "" +"--Nothing happens to an already 3D geometry\n" +"SELECT ST_AsEWKT(ST_Force_3DM(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, " +"4 5 2, 6 7 2, 5 6 2)')));\n" +" st_asewkt\n" +"------------------------------------------------\n" +" CIRCULARSTRINGM(1 1 0,2 3 0,4 5 0,6 7 0,5 6 0)\n" +"\n" +"\n" +"SELECT ST_AsEWKT(ST_Force_3DM('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 " +"1,1 3 1,1 1 1))'));\n" +"\n" +" st_asewkt\n" +"---------------------------------------------------------------\n" +" POLYGONM((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))" +msgstr "" + +#. Tag: para +#: reference_editor.xml:296 reference_editor.xml:383 +#, no-c-format +msgid "" +", , , , " +msgstr "" +", , , , " + +#. Tag: refname +#: reference_editor.xml:302 +#, no-c-format +msgid "ST_Force_4D" +msgstr "ST_Force_4D" + +#. Tag: refpurpose +#: reference_editor.xml:304 +#, no-c-format +msgid "Forces the geometries into XYZM mode." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:309 +#, no-c-format +msgid "" +"geometry ST_Force_4D " +"geometry geomA" +msgstr "" +"geometry ST_Force_4D " +"geometry geomA" + +#. Tag: para +#: reference_editor.xml:319 +#, no-c-format +msgid "" +"Forces the geometries into XYZM mode. 0 is tacked on for missing Z and M " +"dimensions." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:329 +#, no-c-format +msgid "" +"--Nothing happens to an already 3D geometry\n" +"SELECT ST_AsEWKT(ST_Force_4D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 " +"5 2, 6 7 2, 5 6 2)')));\n" +" st_asewkt\n" +"---------------------------------------------------------\n" +" CIRCULARSTRING(1 1 2 0,2 3 2 0,4 5 2 0,6 7 2 0,5 6 2 0)\n" +"\n" +"\n" +"\n" +"SELECT ST_AsEWKT(ST_Force_4D('MULTILINESTRINGM((0 0 1,0 5 2,5 0 3,0 0 4),(1 " +"1 1,3 1 1,1 3 1,1 1 1))'));\n" +"\n" +" st_asewkt\n" +"--------------------------------------------------------------------------------------\n" +" MULTILINESTRING((0 0 0 1,0 5 0 2,5 0 0 3,0 0 0 4),(1 1 0 1,3 1 0 1,1 3 0 " +"1,1 1 0 1))" +msgstr "" + +#. Tag: refname +#: reference_editor.xml:342 +#, no-c-format +msgid "ST_Force_Collection" +msgstr "ST_Force_Collection" + +#. Tag: refpurpose +#: reference_editor.xml:344 +#, no-c-format +msgid "Converts the geometry into a GEOMETRYCOLLECTION." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:349 +#, no-c-format +msgid "" +"geometry ST_Force_Collection " +"geometry geomA" +msgstr "" +"geometry ST_Force_Collection " +"geometry geomA" + +#. Tag: para +#: reference_editor.xml:359 +#, no-c-format +msgid "" +"Converts the geometry into a GEOMETRYCOLLECTION. This is useful for " +"simplifying the WKB representation." +msgstr "" + +#. Tag: para +#: reference_editor.xml:363 +#, no-c-format +msgid "" +"Availability: 1.2.2, prior to 1.3.4 this function will crash with Curves. " +"This is fixed in 1.3.4+" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:374 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_Force_Collection('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 " +"1 1,3 1 1,1 3 1,1 1 1))'));\n" +"\n" +" st_asewkt\n" +"----------------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION(POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 " +"1)))\n" +"\n" +"\n" +" SELECT ST_AsText(ST_Force_Collection('CIRCULARSTRING(220227 150406,2220227 " +"150407,220227 150406)'));\n" +" st_astext\n" +"--------------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION(CIRCULARSTRING(220227 150406,2220227 150407,220227 " +"150406))\n" +"(1 row)" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:376 +#, no-c-format +msgid "" +"-- POLYHEDRAL example --\n" +"SELECT ST_AsEWKT(ST_Force_Collection('POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 " +"1,0 1 0,0 0 0)),\n" +" ((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),\n" +" ((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),\n" +" ((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),\n" +" ((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),\n" +" ((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))'))\n" +"\n" +" st_asewkt\n" +"----------------------------------------------------------------------------------\n" +"GEOMETRYCOLLECTION(\n" +" POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),\n" +" POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),\n" +" POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),\n" +" POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),\n" +" POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),\n" +" POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))\n" +")" +msgstr "" + +#. Tag: refname +#: reference_editor.xml:390 +#, no-c-format +msgid "ST_ForceRHR" +msgstr "ST_ForceRHR" + +#. Tag: refpurpose +#: reference_editor.xml:392 +#, no-c-format +msgid "" +"Forces the orientation of the vertices in a polygon to follow the Right-Hand-" +"Rule." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:398 +#, no-c-format +msgid "" +"boolean ST_ForceRHR " +"geometry g" +msgstr "" +"boolean ST_ForceRHR " +"geometry g" + +#. Tag: para +#: reference_editor.xml:409 +#, no-c-format +msgid "" +"Forces the orientation of the vertices in a polygon to follow the Right-Hand-" +"Rule. In GIS terminology, this means that the area that is bounded by the " +"polygon is to the right of the boundary. In particular, the exterior ring is " +"orientated in a clockwise direction and the interior rings in a counter-" +"clockwise direction." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:423 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(\n" +" ST_ForceRHR(\n" +" 'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 " +"2))'\n" +" )\n" +");\n" +" st_asewkt\n" +"--------------------------------------------------------------\n" +" POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 2,1 3 2,1 1 2))\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:429 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_editor.xml:437 +#, no-c-format +msgid "ST_LineMerge" +msgstr "ST_LineMerge" + +#. Tag: refpurpose +#: reference_editor.xml:439 +#, no-c-format +msgid "" +"Returns a (set of) LineString(s) formed by sewing together a MULTILINESTRING." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:445 +#, no-c-format +msgid "" +"geometry ST_LineMerge " +"geometry amultilinestring" +msgstr "" +"geometry ST_LineMerge " +"geometry amultilinestring" + +#. Tag: para +#: reference_editor.xml:455 +#, no-c-format +msgid "" +"Returns a (set of) LineString(s) formed by sewing together the constituent " +"line work of a MULTILINESTRING." +msgstr "" + +#. Tag: para +#: reference_editor.xml:457 +#, no-c-format +msgid "" +"Only use with MULTILINESTRING/LINESTRINGs. If you feed a polygon or geometry " +"collection into this function, it will return an empty GEOMETRYCOLLECTION" +msgstr "" + +#. Tag: para +#: reference_editor.xml:461 +#, no-c-format +msgid "requires GEOS >= 2.1.0" +msgstr "wymaga GEOS >= 2.1.0" + +#. Tag: programlisting +#: reference_editor.xml:467 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_LineMerge(\n" +"ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 " +"-33,-46 -32))')\n" +" )\n" +");\n" +"st_astext\n" +"--------------------------------------------------------------------------------------------------\n" +"LINESTRING(-29 -27,-30 -29.7,-36 -31,-45 -33,-46 -32)\n" +"(1 row)\n" +"\n" +"--If can't be merged - original MULTILINESTRING is returned\n" +"SELECT ST_AsText(ST_LineMerge(\n" +"ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 " +"-33.2,-46 -32))')\n" +")\n" +");\n" +"st_astext\n" +"----------------\n" +"MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))" +msgstr "" + +#. Tag: para +#: reference_editor.xml:471 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_editor.xml:477 +#, no-c-format +msgid "ST_CollectionExtract" +msgstr "ST_CollectionExtract" + +#. Tag: refpurpose +#: reference_editor.xml:479 +#, no-c-format +msgid "" +"Given a (multi)geometry, returns a (multi)geometry consisting only of " +"elements of the specified type." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:486 +#, no-c-format +msgid "" +"geometry ST_CollectionExtract " +"geometry collection integer type" +msgstr "" +"geometry ST_CollectionExtract " +"geometry collection integer type" + +#. Tag: para +#: reference_editor.xml:497 +#, no-c-format +msgid "" +"Given a (multi)geometry, returns a (multi)geometry consisting only of " +"elements of the specified type. Sub-geometries that are not the specified " +"type are ignored. If there are no sub-geometries of the right type, an EMPTY " +"geometry will be returned. Only points, lines and polygons are supported. " +"Type numbers are 1 == POINT, 2 == LINESTRING, 3 == POLYGON." +msgstr "" + +#. Tag: para +#: reference_editor.xml:503 +#, no-c-format +msgid "Availability: 1.5.0" +msgstr "Dostępność: 1.5.0" + +#. Tag: para +#: reference_editor.xml:505 +#, no-c-format +msgid "" +"Prior to 1.5.3 this function returned non-collection inputs untouched, no " +"matter type. In 1.5.3 non-matching single geometries result in a NULL " +"return. In of 2.0.0 every case of missing match results in a typed EMPTY " +"return." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:516 +#, no-c-format +msgid "" +"-- Constants: 1 == POINT, 2 == LINESTRING, 3 == POLYGON\n" +"SELECT " +"ST_AsText(ST_CollectionExtract(ST_GeomFromText('GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(POINT(0 " +"0)))'),1));\n" +"st_astext\n" +"---------------\n" +"MULTIPOINT(0 0)\n" +"(1 row)\n" +"\n" +"SELECT " +"ST_AsText(ST_CollectionExtract(ST_GeomFromText('GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(LINESTRING(0 " +"0, 1 1)),LINESTRING(2 2, 3 3))'),2));\n" +"st_astext\n" +"---------------\n" +"MULTILINESTRING((0 0, 1 1), (2 2, 3 3))\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:520 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_editor.xml:526 +#, no-c-format +msgid "ST_CollectionHomogenize" +msgstr "ST_CollectionHomogenize" + +#. Tag: refpurpose +#: reference_editor.xml:528 +#, no-c-format +msgid "" +"Given a geometry collection, returns the \"simplest\" representation of the " +"contents." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:535 +#, no-c-format +msgid "" +"geometry ST_CollectionHomogenize " +"geometry collection" +msgstr "" + +#. Tag: para +#: reference_editor.xml:545 +#, no-c-format +msgid "" +"Given a geometry collection, returns the \"simplest\" representation of the " +"contents. Singletons will be returned as singletons. Collections that are " +"homogeneous will be returned as the appropriate multi-type." +msgstr "" + +#. Tag: para +#: reference_editor.xml:549 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "Dostępność: 2.0" + +#. Tag: programlisting +#: reference_editor.xml:556 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 " +"0))')); \n" +"\n" +" st_astext\n" +" ------------\n" +" POINT(0 0)\n" +" (1 row)\n" +"\n" +" SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0)," +"POINT(1 1))')); \n" +"\n" +" st_astext\n" +" ---------------------\n" +" MULTIPOINT(0 0,1 1)\n" +" (1 row)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:560 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_editor.xml:566 +#, no-c-format +msgid "ST_Multi" +msgstr "ST_Multi" + +#. Tag: refpurpose +#: reference_editor.xml:568 +#, no-c-format +msgid "" +"Returns the geometry as a MULTI* geometry. If the geometry is " +"already a MULTI*, it is returned unchanged." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:574 +#, no-c-format +msgid "" +"geometry ST_Multi " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_editor.xml:584 +#, no-c-format +msgid "" +"Returns the geometry as a MULTI* geometry. If the geometry is already " +"a MULTI*, it is returned unchanged." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:592 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Multi(ST_GeomFromText('POLYGON((743238 2967416,743238 " +"2967450,\n" +" 743265 2967450,743265.625 2967416,743238 " +"2967416))')));\n" +" st_astext\n" +" --------------------------------------------------------------------------------------------------\n" +" MULTIPOLYGON(((743238 2967416,743238 2967450,743265 " +"2967450,743265.625 2967416,\n" +" 743238 2967416)))\n" +" (1 row)" +msgstr "" + +#. Tag: refname +#: reference_editor.xml:602 +#, no-c-format +msgid "ST_RemovePoint" +msgstr "ST_RemovePoint" + +#. Tag: refpurpose +#: reference_editor.xml:603 +#, no-c-format +msgid "Removes point from a linestring. Offset is 0-based." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:607 +#, no-c-format +msgid "" +"geometry ST_RemovePoint " +"geometry linestring " +"integer offset" +msgstr "" + +#. Tag: para +#: reference_editor.xml:618 +#, no-c-format +msgid "" +"Removes point from a linestring. Useful for turning a closed ring into an " +"open line string" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:625 +#, no-c-format +msgid "" +"--guarantee no LINESTRINGS are closed\n" +"--by removing the end point. The below assumes the_geom is of type " +"LINESTRING\n" +"UPDATE sometable\n" +" SET the_geom = ST_RemovePoint(the_geom, ST_NPoints(the_geom) - 1)\n" +" FROM sometable\n" +" WHERE ST_IsClosed(the_geom) = true;" +msgstr "" + +#. Tag: para +#: reference_editor.xml:629 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_editor.xml:635 +#, no-c-format +msgid "ST_Reverse" +msgstr "ST_Reverse" + +#. Tag: refpurpose +#: reference_editor.xml:636 +#, no-c-format +msgid "Returns the geometry with vertex order reversed." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:641 +#, no-c-format +msgid "" +"geometry ST_Reverse " +"geometry g1" +msgstr "" +"geometry ST_Reverse " +"geometry g1" + +#. Tag: para +#: reference_editor.xml:651 +#, no-c-format +msgid "Can be used on any geometry and reverses the order of the vertexes." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:656 +#, no-c-format +msgid "" +"SELECT ST_AsText(the_geom) as line, ST_AsText(ST_Reverse(the_geom)) As " +"reverseline\n" +"FROM\n" +"(SELECT ST_MakeLine(ST_MakePoint(1,2),\n" +" ST_MakePoint(1,10)) As the_geom) as foo;\n" +"--result\n" +" line | reverseline\n" +"---------------------+----------------------\n" +"LINESTRING(1 2,1 10) | LINESTRING(1 10,1 2)" +msgstr "" + +#. Tag: refname +#: reference_editor.xml:662 +#, no-c-format +msgid "ST_Rotate" +msgstr "ST_Rotate" + +#. Tag: refpurpose +#: reference_editor.xml:664 +#, no-c-format +msgid "Rotate a geometry rotRadians counter-clockwise about an origin." +msgstr "" + +#. Tag: funcsynopsis +#: reference_editor.xml:668 +#, no-c-format +msgid "" +" geometry ST_Rotate " +"geometry geomA " +"float rotRadians geometry ST_Rotate geometry geomA float rotRadians float x0 float y0 geometry " +"ST_Rotate geometry " +"geomA float " +"rotRadians geometry " +"pointOrigin " +msgstr "" +" geometry ST_Rotate " +"geometry geomA " +"float rotRadians geometry ST_Rotate geometry geomA float rotRadians float x0 float y0 geometry " +"ST_Rotate geometry " +"geomA float " +"rotRadians geometry " +"pointOrigin " + +#. Tag: para +#: reference_editor.xml:695 +#, no-c-format +msgid "" +"Rotates geometry rotRadians counter-clockwise about the origin. The rotation " +"origin can be specified either as a POINT geometry, or as x and y " +"coordinates. If the origin is not specified, the geometry is rotated about " +"POINT(0 0)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:700 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 additional parameters for specifying the origin of rotation " +"were added." +msgstr "" + +#. Tag: para +#: reference_editor.xml:701 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from Rotate to ST_Rotate in 1.2.2" +msgstr "" +"Dostępność: 1.1.2. Nazwę zmieniono z Rotate na ST_Rotate w wersji 1.2.2" + +#. Tag: programlisting +#: reference_editor.xml:713 +#, no-c-format +msgid "" +"--Rotate 180 degrees\n" +"SELECT ST_AsEWKT(ST_Rotate('LINESTRING (50 160, 50 50, 100 50)', pi()));\n" +" st_asewkt\n" +"---------------------------------------\n" +" LINESTRING(-50 -160,-50 -50,-100 -50)\n" +"(1 row)\n" +"\n" +"--Rotate 30 degrees counter-clockwise at x=50, y=160\n" +"SELECT ST_AsEWKT(ST_Rotate('LINESTRING (50 160, 50 50, 100 50)', pi()/6, 50, " +"160));\n" +" st_asewkt\n" +"---------------------------------------------------------------------------\n" +" LINESTRING(50 160,105 64.7372055837117,148.301270189222 89.7372055837117)\n" +"(1 row)\n" +"\n" +"--Rotate 60 degrees clockwise from centroid\n" +"SELECT ST_AsEWKT(ST_Rotate(geom, -pi()/3, ST_Centroid(geom)))\n" +"FROM (SELECT 'LINESTRING (50 160, 50 50, 100 50)'::geometry AS geom) AS " +"foo;\n" +" st_asewkt\n" +"--------------------------------------------------------------\n" +" LINESTRING(116.4225 130.6721,21.1597 75.6721,46.1597 32.3708)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:720 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_editor.xml:726 +#, no-c-format +msgid "ST_RotateX" +msgstr "ST_RotateX" + +#. Tag: refpurpose +#: reference_editor.xml:728 +#, no-c-format +msgid "Rotate a geometry rotRadians about the X axis." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:733 +#, no-c-format +msgid "" +"geometry ST_RotateX " +"geometry geomA " +"float rotRadians" +msgstr "" + +#. Tag: para +#: reference_editor.xml:744 +#, no-c-format +msgid "Rotate a geometry geomA - rotRadians about the X axis." +msgstr "" + +#. Tag: para +#: reference_editor.xml:746 +#, no-c-format +msgid "" +"ST_RotateX(geomA, rotRadians) is short-hand for " +"ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, " +"sin(rotRadians), cos(rotRadians), 0, 0, 0)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:750 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2" +msgstr "" +"Dostępność: 1.1.2. Nazwa zmieniona z RotateX na ST_RotateX w wersji 1.2.2" + +#. Tag: programlisting +#: reference_editor.xml:760 +#, no-c-format +msgid "" +"--Rotate a line 90 degrees along x-axis\n" +"SELECT ST_AsEWKT(ST_RotateX(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), " +"pi()/2));\n" +" st_asewkt\n" +"---------------------------\n" +" LINESTRING(1 -3 2,1 -1 1)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:767 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_editor.xml:773 +#, no-c-format +msgid "ST_RotateY" +msgstr "ST_RotateY" + +#. Tag: refpurpose +#: reference_editor.xml:775 +#, no-c-format +msgid "Rotate a geometry rotRadians about the Y axis." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:780 +#, no-c-format +msgid "" +"geometry ST_RotateY " +"geometry geomA " +"float rotRadians" +msgstr "" +"geometry ST_RotateY " +"geometry geomA " +"float rotRadians" + +#. Tag: para +#: reference_editor.xml:791 +#, no-c-format +msgid "Rotate a geometry geomA - rotRadians about the y axis." +msgstr "" + +#. Tag: para +#: reference_editor.xml:793 +#, no-c-format +msgid "" +"ST_RotateY(geomA, rotRadians) is short-hand for " +"ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -" +"sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:796 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2" +msgstr "" +"Dostępność: 1.1.2. Nazwa zmieniona z RotateY na ST_RotateY w wersji 1.2.2" + +#. Tag: programlisting +#: reference_editor.xml:809 +#, no-c-format +msgid "" +"--Rotate a line 90 degrees along y-axis\n" +" SELECT ST_AsEWKT(ST_RotateY(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), " +"pi()/2));\n" +" st_asewkt\n" +"---------------------------\n" +" LINESTRING(3 2 -1,1 1 -1)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:816 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_editor.xml:822 +#, no-c-format +msgid "ST_RotateZ" +msgstr "ST_RotateZ" + +#. Tag: refpurpose +#: reference_editor.xml:824 +#, no-c-format +msgid "Rotate a geometry rotRadians about the Z axis." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:829 +#, no-c-format +msgid "" +"geometry ST_RotateZ " +"geometry geomA " +"float rotRadians" +msgstr "" +"geometry ST_RotateZ " +"geometry geomA " +"float rotRadians" + +#. Tag: para +#: reference_editor.xml:840 +#, no-c-format +msgid "Rotate a geometry geomA - rotRadians about the Z axis." +msgstr "" + +#. Tag: para +#: reference_editor.xml:842 +#, no-c-format +msgid "This is a synonym for ST_Rotate" +msgstr "" + +#. Tag: para +#: reference_editor.xml:843 +#, no-c-format +msgid "" +"ST_RotateZ(geomA, rotRadians) is short-hand for SELECT " +"ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), " +"cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)." +msgstr "" +"ST_RotateZ(geomA, rotRadians) is short-hand for SELECT " +"ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), " +"cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)." + +#. Tag: para +#: reference_editor.xml:848 +#, no-c-format +msgid "Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2" +msgstr "" +"Dostępność: 1.1.2. Nazwa zmieniona z RotateZ na ST_RotateZ w wersji 1.2.2" + +#. Tag: programlisting +#: reference_editor.xml:861 +#, no-c-format +msgid "" +"--Rotate a line 90 degrees along z-axis\n" +"SELECT ST_AsEWKT(ST_RotateZ(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), " +"pi()/2));\n" +" st_asewkt\n" +"---------------------------\n" +" LINESTRING(-2 1 3,-1 1 1)\n" +"\n" +" --Rotate a curved circle around z-axis\n" +"SELECT ST_AsEWKT(ST_RotateZ(the_geom, pi()/2))\n" +"FROM (SELECT ST_LineToCurve(ST_Buffer(ST_GeomFromText('POINT(234 567)'), 3)) " +"As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"----------------------------------------------------------------------------------------------------------------------------\n" +" CURVEPOLYGON(CIRCULARSTRING(-567 237,-564.87867965644 236.12132034356,-564 " +"234,-569.12132034356 231.87867965644,-567 237))" +msgstr "" + +#. Tag: para +#: reference_editor.xml:868 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_editor.xml:874 +#, no-c-format +msgid "ST_Scale" +msgstr "ST_Scale" + +#. Tag: refpurpose +#: reference_editor.xml:876 +#, no-c-format +msgid "" +"Scales the geometry to a new size by multiplying the ordinates " +"with the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor)." +msgstr "" + +#. Tag: funcsynopsis +#: reference_editor.xml:883 +#, no-c-format +msgid "" +" geometry ST_Scale " +"geometry geomA " +"float XFactor " +"float YFactor " +"float ZFactor geometry ST_Scale geometry geomA float XFactor float YFactor " +msgstr "" +" geometry ST_Scale " +"geometry geomA " +"float XFactor " +"float YFactor " +"float ZFactor geometry ST_Scale geometry geomA float XFactor float YFactor " + +#. Tag: para +#: reference_editor.xml:904 +#, no-c-format +msgid "" +"Scales the geometry to a new size by multiplying the ordinates with " +"the parameters. Ie: ST_Scale(geom, Xfactor, Yfactor, Zfactor)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:908 +#, no-c-format +msgid "" +"ST_Scale(geomA, XFactor, YFactor, ZFactor) is short-hand for " +"ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, ZFactor, 0, 0, " +"0)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:914 reference_editor.xml:1487 +#, no-c-format +msgid "Availability: 1.1.0." +msgstr "Dostępność: 1.1.0" + +#. Tag: programlisting +#: reference_editor.xml:926 +#, no-c-format +msgid "" +"--Version 1: scale X, Y, Z\n" +"SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, " +"0.75, 0.8));\n" +" st_asewkt\n" +"--------------------------------------\n" +" LINESTRING(0.5 1.5 2.4,0.5 0.75 0.8)\n" +"\n" +"--Version 2: Scale X Y\n" +" SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, " +"0.75));\n" +" st_asewkt\n" +"----------------------------------\n" +" LINESTRING(0.5 1.5 3,0.5 0.75 1)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:933 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_editor.xml:939 +#, no-c-format +msgid "ST_Segmentize" +msgstr "ST_Segmentize" + +#. Tag: refpurpose +#: reference_editor.xml:941 +#, no-c-format +msgid "" +"Return a modified geometry/geography having no segment longer than the given " +"distance. Distance computation is performed in 2d only. For geometry, length " +"units are in units of spatial reference. For geography, units are in meters." +msgstr "" + +#. Tag: funcsynopsis +#: reference_editor.xml:947 +#, no-c-format +msgid "" +" geometry ST_Segmentize geometry geom float max_segment_length geometry " +"ST_Segmentize geography geog float " +"max_segment_length " +msgstr "" +" geometry ST_Segmentize geometry geom float max_segment_length geometry " +"ST_Segmentize geography geog float " +"max_segment_length " + +#. Tag: para +#: reference_editor.xml:964 +#, no-c-format +msgid "" +"Returns a modified geometry having no segment longer than the given " +"max_segment_length. Distance computation is performed in " +"2d only. For geometry, length units are in units of spatial reference. For " +"geography, units are in meters." +msgstr "" + +#. Tag: para +#: reference_editor.xml:967 reference_editor.xml:1428 +#, no-c-format +msgid "Availability: 1.2.2" +msgstr "Dostępność: 1.2.2" + +#. Tag: para +#: reference_editor.xml:968 +#, no-c-format +msgid "Enhanced: 2.1.0 support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_editor.xml:969 +#, no-c-format +msgid "" +"Changed: 2.1.0 As a result of the introduction of geography support: The " +"construct SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5); " +"will result in ambiguous function error. You need to have properly typed " +"object e.g. a geometry/geography column, use ST_GeomFromText, " +"ST_GeogFromText or SELECT ST_Segmentize('LINESTRING(1 2, 3 4)'::" +"geometry,0.5);" +msgstr "" + +#. Tag: para +#: reference_editor.xml:971 +#, no-c-format +msgid "" +"This will only increase segments. It will not lengthen segments shorter than " +"max length" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:978 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Segmentize(\n" +"ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 " +"-33,-46 -32))')\n" +" ,5)\n" +");\n" +"st_astext\n" +"--------------------------------------------------------------------------------------------------\n" +"MULTILINESTRING((-29 -27,-30 -29.7,-34.886615700134 -30.758766735029,-36 " +"-31,\n" +"-40.8809353009198 -32.0846522890933,-45 -33),\n" +"(-45 -33,-46 -32))\n" +"(1 row)\n" +"\n" +"SELECT ST_AsText(ST_Segmentize(ST_GeomFromText('POLYGON((-29 28, -30 40, -29 " +"28))'),10));\n" +"st_astext\n" +"-----------------------\n" +"POLYGON((-29 28,-29.8304547985374 37.9654575824488,-30 40,-29.1695452014626 " +"30.0345424175512,-29 28))\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_editor.xml:988 +#, no-c-format +msgid "ST_SetPoint" +msgstr "ST_SetPoint" + +#. Tag: refpurpose +#: reference_editor.xml:989 +#, no-c-format +msgid "Replace point N of linestring with given point. Index is 0-based." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:994 +#, no-c-format +msgid "" +"geometry ST_SetPoint " +"geometry linestring " +"integer zerobasedposition geometry point" +msgstr "" +"geometry ST_SetPoint " +"geometry linestring " +"integer zerobasedposition geometry point" + +#. Tag: para +#: reference_editor.xml:1006 +#, no-c-format +msgid "" +"Replace point N of linestring with given point. Index is 0-based. This is " +"especially useful in triggers when trying to maintain relationship of joints " +"when one vertex moves." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1016 +#, no-c-format +msgid "" +"--Change first point in line string from -1 3 to -1 1\n" +"SELECT ST_AsText(ST_SetPoint('LINESTRING(-1 2,-1 3)', 0, 'POINT(-1 1)'));\n" +" st_astext\n" +"-----------------------\n" +" LINESTRING(-1 1,-1 3)\n" +"\n" +"---Change last point in a line string (lets play with 3d linestring this " +"time)\n" +"SELECT ST_AsEWKT(ST_SetPoint(foo.the_geom, ST_NumPoints(foo.the_geom) - 1, " +"ST_GeomFromEWKT('POINT(-1 1 3)')))\n" +"FROM (SELECT ST_GeomFromEWKT('LINESTRING(-1 2 3,-1 3 4, 5 6 7)') As " +"the_geom) As foo;\n" +" st_asewkt\n" +"-----------------------\n" +"LINESTRING(-1 2 3,-1 3 4,-1 1 3)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1020 +#, no-c-format +msgid "" +", , , , " +msgstr "" +", , , , " + +#. Tag: refname +#: reference_editor.xml:1026 +#, no-c-format +msgid "ST_SetSRID" +msgstr "ST_SetSRID" + +#. Tag: refpurpose +#: reference_editor.xml:1028 +#, no-c-format +msgid "Sets the SRID on a geometry to a particular integer value." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:1034 +#, no-c-format +msgid "" +"geometry ST_SetSRID " +"geometry geom " +"integer srid" +msgstr "" +"geometry ST_SetSRID " +"geometry geom " +"integer srid" + +#. Tag: para +#: reference_editor.xml:1049 +#, no-c-format +msgid "" +"Sets the SRID on a geometry to a particular integer value. Useful in " +"constructing bounding boxes for queries." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1053 +#, no-c-format +msgid "" +"This function does not transform the geometry coordinates in any way - it " +"simply sets the meta data defining the spatial reference system the geometry " +"is assumed to be in. Use if you want to " +"transform the geometry into a new projection." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1058 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "&sfs_compliant;" + +#. Tag: para +#: reference_editor.xml:1064 +#, no-c-format +msgid "-- Mark a point as WGS 84 long lat --" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1065 +#, no-c-format +msgid "" +"SELECT ST_SetSRID(ST_Point(-123.365556, 48.428611),4326) As wgs84long_lat;\n" +"-- the ewkt representation (wrap with ST_AsEWKT) -\n" +"SRID=4326;POINT(-123.365556 48.428611)" +msgstr "" +"SELECT ST_SetSRID(ST_Point(-123.365556, 48.428611),4326) As wgs84long_lat;\n" +"-- the ewkt representation (wrap with ST_AsEWKT) -\n" +"SRID=4326;POINT(-123.365556 48.428611)" + +#. Tag: para +#: reference_editor.xml:1066 +#, no-c-format +msgid "" +"-- Mark a point as WGS 84 long lat and then transform to web mercator " +"(Spherical Mercator) --" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1067 +#, no-c-format +msgid "" +"SELECT ST_Transform(ST_SetSRID(ST_Point(-123.365556, 48.428611),4326),3785) " +"As spere_merc;\n" +"-- the ewkt representation (wrap with ST_AsEWKT) -\n" +"SRID=3785;POINT(-13732990.8753491 6178458.96425423)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1073 +#, no-c-format +msgid "" +", , , , , " +msgstr "" +", , , , , " + +#. Tag: refname +#: reference_editor.xml:1080 +#, no-c-format +msgid "ST_SnapToGrid" +msgstr "ST_SnapToGrid" + +#. Tag: refpurpose +#: reference_editor.xml:1082 +#, no-c-format +msgid "Snap all points of the input geometry to a regular grid." +msgstr "" + +#. Tag: funcsynopsis +#: reference_editor.xml:1088 +#, no-c-format +msgid "" +" geometry ST_SnapToGrid geometry geomA float originX float originY float sizeX float sizeY geometry " +"ST_SnapToGrid geometry geomA float " +"sizeX float " +"sizeY " +"geometry ST_SnapToGrid " +"geometry geomA " +"float size geometry ST_SnapToGrid geometry geomA geometry " +"pointOrigin float " +"sizeX float " +"sizeY float " +"sizeZ float " +"sizeM " +msgstr "" +" geometry ST_SnapToGrid geometry geomA float originX float originY float sizeX float sizeY geometry " +"ST_SnapToGrid geometry geomA float " +"sizeX float " +"sizeY " +"geometry ST_SnapToGrid " +"geometry geomA " +"float size geometry ST_SnapToGrid geometry geomA geometry " +"pointOrigin float " +"sizeX float " +"sizeY float " +"sizeZ float " +"sizeM " + +#. Tag: para +#: reference_editor.xml:1126 +#, no-c-format +msgid "" +"Variant 1,2,3: Snap all points of the input geometry to the grid defined by " +"its origin and cell size. Remove consecutive points falling on the same " +"cell, eventually returning NULL if output points are not enough to define a " +"geometry of the given type. Collapsed geometries in a collection are " +"stripped from it. Useful for reducing precision." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1134 +#, no-c-format +msgid "" +"Variant 4: Introduced 1.1.0 - Snap all points of the input geometry to the " +"grid defined by its origin (the second argument, must be a point) and cell " +"sizes. Specify 0 as size for any dimension you don't want to snap to a grid." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1140 +#, no-c-format +msgid "" +"The returned geometry might loose its simplicity (see )." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1145 +#, no-c-format +msgid "" +"Before release 1.1.0 this function always returned a 2d geometry. Starting " +"at 1.1.0 the returned geometry will have same dimensionality as the input " +"one with higher dimension values untouched. Use the version taking a second " +"geometry argument to define all grid dimensions." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1152 +#, no-c-format +msgid "Availability: 1.0.0RC1" +msgstr "Dostępność: 1.0.0RC1" + +#. Tag: para +#: reference_editor.xml:1153 +#, no-c-format +msgid "Availability: 1.1.0 - Z and M support" +msgstr "Dostępność: 1.1.0 - wsparcie dla Z i M" + +#. Tag: programlisting +#: reference_editor.xml:1162 +#, no-c-format +msgid "" +"--Snap your geometries to a precision grid of 10^-3\n" +"UPDATE mytable\n" +" SET the_geom = ST_SnapToGrid(the_geom, 0.001);\n" +"\n" +"SELECT ST_AsText(ST_SnapToGrid(\n" +" ST_GeomFromText('LINESTRING(1.1115678 2.123, " +"4.111111 3.2374897, 4.11112 3.23748667)'),\n" +" 0.001)\n" +" );\n" +" st_astext\n" +"-------------------------------------\n" +" LINESTRING(1.112 2.123,4.111 3.237)\n" +" --Snap a 4d geometry\n" +"SELECT ST_AsEWKT(ST_SnapToGrid(\n" +" ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 2.3456 1.11111,\n" +" 4.111111 3.2374897 3.1234 1.1111, -1.11111112 2.123 2.3456 " +"1.1111112)'),\n" +" ST_GeomFromEWKT('POINT(1.12 2.22 3.2 4.4444)'),\n" +" 0.1, 0.1, 0.1, 0.01) );\n" +" st_asewkt\n" +"------------------------------------------------------------------------------\n" +" LINESTRING(-1.08 2.12 2.3 1.1144,4.12 3.22 3.1 1.1144,-1.08 2.12 2.3 " +"1.1144)\n" +"\n" +"\n" +"--With a 4d geometry - the ST_SnapToGrid(geom,size) only touches x and y " +"coords but keeps m and z the same\n" +"SELECT ST_AsEWKT(ST_SnapToGrid(ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 " +"3 2.3456,\n" +" 4.111111 3.2374897 3.1234 1.1111)'),\n" +" 0.01) );\n" +" st_asewkt\n" +"---------------------------------------------------------\n" +" LINESTRING(-1.11 2.12 3 2.3456,4.11 3.24 3.1234 1.1111)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1169 +#, no-c-format +msgid "" +", , , , , " +msgstr "" +", , , , , " + +#. Tag: refname +#: reference_editor.xml:1182 +#, no-c-format +msgid "ST_Snap" +msgstr "ST_Snap" + +#. Tag: refpurpose +#: reference_editor.xml:1184 +#, no-c-format +msgid "" +"Snap segments and vertices of input geometry to vertices of a reference " +"geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:1192 +#, no-c-format +msgid "" +"geometry ST_Snap " +"geometry input " +"geometry reference " +"float tolerance" +msgstr "" +"geometry ST_Snap " +"geometry input " +"geometry reference " +"float tolerance" + +#. Tag: para +#: reference_editor.xml:1204 +#, no-c-format +msgid "" +"Snaps the vertices and segments of a geometry another Geometry's vertices. A " +"snap distance tolerance is used to control where snapping is performed." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1209 +#, no-c-format +msgid "" +"Snapping one geometry to another can improve robustness for overlay " +"operations by eliminating nearly-coincident edges (which cause problems " +"during noding and intersection calculation)." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1216 +#, no-c-format +msgid "" +"Too much snapping can result in invalid topology being created, so the " +"number and location of snapped vertices is decided using heuristics to " +"determine when it is safe to snap. This can result in some potential snaps " +"being omitted, however." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1225 +#, no-c-format +msgid "" +"The returned geometry might loose its simplicity (see ) and validity (see )." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1232 +#, no-c-format +msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." +msgstr "Dostępność: 2.0.0 wymaga GEOS >= 3.3.0." + +#. Tag: para +#: reference_editor.xml:1249 +#, no-c-format +msgid "A multipolygon shown with a linestring (before any snapping)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1260 +#, no-c-format +msgid "" +"A multipolygon snapped to linestring to tolerance: 1.01 of distance. The new " +"multipolygon is shown with reference linestring" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1264 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS " +"polysnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" ((26 125, 26 200, 126 200, 126 125, 26 125 ),\n" +" ( 51 150, 101 150, 76 175, 51 150 )), \n" +" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n" +" \n" +" ) As foo;\n" +"\n" +" polysnapped\n" +"---------------------------------------------------------------------\n" +" MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),\n" +" (51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))" +msgstr "" +"SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS " +"polysnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" ((26 125, 26 200, 126 200, 126 125, 26 125 ),\n" +" ( 51 150, 101 150, 76 175, 51 150 )), \n" +" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n" +" \n" +" ) As foo;\n" +"\n" +" polysnapped\n" +"---------------------------------------------------------------------\n" +" MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),\n" +" (51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))" + +#. Tag: para +#: reference_editor.xml:1271 +#, no-c-format +msgid "" +"A multipolygon snapped to linestring to tolerance: 1.25 of distance. The new " +"multipolygon is shown with reference linestring" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1275 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_Snap(poly,line, ST_Distance(poly,line)*1.25)\n" +" ) AS polysnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n" +" ( 51 150, 101 150, 76 175, 51 150 )),\n" +" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n" +" \n" +" ) As foo;\n" +"\n" +" polysnapped\n" +"---------------------------------------------------------------------\n" +"MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),\n" +"(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))" +msgstr "" +"SELECT ST_AsText(\n" +" ST_Snap(poly,line, ST_Distance(poly,line)*1.25)\n" +" ) AS polysnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n" +" ( 51 150, 101 150, 76 175, 51 150 )),\n" +" (( 151 100, 151 200, 176 175, 151 100 )))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n" +" \n" +" ) As foo;\n" +"\n" +" polysnapped\n" +"---------------------------------------------------------------------\n" +"MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),\n" +"(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))" + +#. Tag: para +#: reference_editor.xml:1284 +#, no-c-format +msgid "" +"The linestring snapped to the original multipolygon at tolerance 1.01 of " +"distance. The new linestring is shown with reference multipolygon" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1288 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_Snap(line, poly, ST_Distance(poly,line)*1.01)\n" +" ) AS linesnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" ((26 125, 26 200, 126 200, 126 125, 26 125),\n" +" (51 150, 101 150, 76 175, 51 150 )), \n" +" ((151 100, 151 200, 176 175, 151 100)))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n" +" ) As foo;\n" +"\n" +" linesnapped\n" +"----------------------------------------\n" +" LINESTRING(5 107,26 125,54 84,101 100)" +msgstr "" +"SELECT ST_AsText(\n" +" ST_Snap(line, poly, ST_Distance(poly,line)*1.01)\n" +" ) AS linesnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" ((26 125, 26 200, 126 200, 126 125, 26 125),\n" +" (51 150, 101 150, 76 175, 51 150 )), \n" +" ((151 100, 151 200, 176 175, 151 100)))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line\n" +" ) As foo;\n" +"\n" +" linesnapped\n" +"----------------------------------------\n" +" LINESTRING(5 107,26 125,54 84,101 100)" + +#. Tag: para +#: reference_editor.xml:1296 +#, no-c-format +msgid "" +"The linestring snapped to the original multipolygon at tolerance 1.25 of " +"distance. The new linestring is shown with reference multipolygon" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1300 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_Snap(line, poly, ST_Distance(poly,line)*1.25)\n" +" ) AS linesnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n" +" (51 150, 101 150, 76 175, 51 150 )), \n" +" ((151 100, 151 200, 176 175, 151 100 )))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As " +"line \n" +" ) As foo;\n" +" linesnapped\n" +"---------------------------------------\n" +"LINESTRING(26 125,54 84,101 100)" +msgstr "" +"SELECT ST_AsText(\n" +" ST_Snap(line, poly, ST_Distance(poly,line)*1.25)\n" +" ) AS linesnapped\n" +"FROM (SELECT \n" +" ST_GeomFromText('MULTIPOLYGON(\n" +" (( 26 125, 26 200, 126 200, 126 125, 26 125 ),\n" +" (51 150, 101 150, 76 175, 51 150 )), \n" +" ((151 100, 151 200, 176 175, 151 100 )))') As poly,\n" +" ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As " +"line \n" +" ) As foo;\n" +" linesnapped\n" +"---------------------------------------\n" +"LINESTRING(26 125,54 84,101 100)" + +#. Tag: refname +#: reference_editor.xml:1321 +#, no-c-format +msgid "ST_Transform" +msgstr "ST_Transform" + +#. Tag: refpurpose +#: reference_editor.xml:1323 +#, no-c-format +msgid "" +"Returns a new geometry with its coordinates transformed to the SRID " +"referenced by the integer parameter." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:1329 +#, no-c-format +msgid "" +"geometry ST_Transform " +"geometry g1 " +"integer srid" +msgstr "" +"geometry ST_Transform " +"geometry g1 " +"integer srid" + +#. Tag: para +#: reference_editor.xml:1340 +#, no-c-format +msgid "" +"Returns a new geometry with its coordinates transformed to spatial reference " +"system referenced by the SRID integer parameter. The destination SRID must " +"exist in the SPATIAL_REF_SYS table." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1343 +#, no-c-format +msgid "" +"ST_Transform is often confused with ST_SetSRID(). ST_Transform actually " +"changes the coordinates of a geometry from one spatial reference system to " +"another, while ST_SetSRID() simply changes the SRID identifier of the " +"geometry" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1348 +#, no-c-format +msgid "" +"Requires PostGIS be compiled with Proj support. Use to confirm you have proj support compiled in." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1352 +#, no-c-format +msgid "" +"If using more than one transformation, it is useful to have a functional " +"index on the commonly used transformations to take advantage of index usage." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1359 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.6" +msgstr "&sqlmm_compliant; SQL-MM 3: 5.1.6" + +#. Tag: para +#: reference_editor.xml:1367 +#, no-c-format +msgid "Change Mass state plane US feet geometry to WGS 84 long lat" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1368 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Transform(ST_GeomFromText('POLYGON((743238 " +"2967416,743238 2967450,\n" +" 743265 2967450,743265.625 2967416,743238 2967416))',2249),4326)) As " +"wgs_geom;\n" +"\n" +" wgs_geom\n" +"---------------------------\n" +" POLYGON((-71.1776848522251 42.3902896512902,-71.1776843766326 " +"42.3903829478009,\n" +"-71.1775844305465 42.3903826677917,-71.1775825927231 " +"42.3902893647987,-71.177684\n" +"8522251 42.3902896512902));\n" +"(1 row)\n" +"\n" +"--3D Circular String example\n" +"SELECT ST_AsEWKT(ST_Transform(ST_GeomFromEWKT('SRID=2249;" +"CIRCULARSTRING(743238 2967416 1,743238 2967450 2,743265 2967450 3,743265.625 " +"2967416 3,743238 2967416 4)'),4326));\n" +"\n" +" st_asewkt\n" +"--------------------------------------------------------------------------------------\n" +" SRID=4326;CIRCULARSTRING(-71.1776848522251 42.3902896512902 " +"1,-71.1776843766326 42.3903829478009 2,\n" +" -71.1775844305465 42.3903826677917 3,\n" +" -71.1775825927231 42.3902893647987 3,-71.1776848522251 42.3902896512902 4)" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1369 +#, no-c-format +msgid "" +"Example of creating a partial functional index. For tables where you are not " +"sure all the geometries will be filled in, its best to use a partial index " +"that leaves out null geometries which will both conserve space and make your " +"index smaller and more efficient." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1371 +#, no-c-format +msgid "" +"CREATE INDEX idx_the_geom_26986_parcels\n" +" ON parcels\n" +" USING gist\n" +" (ST_Transform(the_geom, 26986))\n" +" WHERE the_geom IS NOT NULL;" +msgstr "" +"CREATE INDEX idx_the_geom_26986_parcels\n" +" ON parcels\n" +" USING gist\n" +" (ST_Transform(the_geom, 26986))\n" +" WHERE the_geom IS NOT NULL;" + +#. Tag: title +#: reference_editor.xml:1375 +#, no-c-format +msgid "Configuring transformation behaviour" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1376 +#, no-c-format +msgid "" +"Sometimes coordinate transformation involving a grid-shift can fail, for " +"example if PROJ.4 has not been built with grid-shift files or the coordinate " +"does not lie within the range for which the grid shift is defined. By " +"default, PostGIS will throw an error if a grid shift file is not present, " +"but this behaviour can be configured on a per-SRID basis by altering the " +"proj4text value within the spatial_ref_sys table." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1377 +#, no-c-format +msgid "" +"For example, the proj4text parameter +datum=NAD87 is a shorthand form for " +"the following +nadgrids parameter:" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1378 +#, no-c-format +msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat" +msgstr "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat" + +#. Tag: para +#: reference_editor.xml:1379 +#, no-c-format +msgid "" +"The @ prefix means no error is reported if the files are not present, but if " +"the end of the list is reached with no file having been appropriate (ie. " +"found and overlapping) then an error is issued." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1380 +#, no-c-format +msgid "" +"If, conversely, you wanted to ensure that at least the standard files were " +"present, but that if all files were scanned without a hit a null " +"transformation is applied you could use:" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1381 +#, no-c-format +msgid "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null" +msgstr "+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null" + +#. Tag: para +#: reference_editor.xml:1382 +#, no-c-format +msgid "" +"The null grid shift file is a valid grid shift file covering the whole world " +"and applying no shift. So for a complete example, if you wanted to alter " +"PostGIS so that transformations to SRID 4267 that didn't lie within the " +"correct range did not throw an ERROR, you would use the following:" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1383 +#, no-c-format +msgid "" +"UPDATE spatial_ref_sys SET proj4text = '+proj=longlat +ellps=clrk66 " +"+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null +no_defs' WHERE srid " +"= 4267;" +msgstr "" +"UPDATE spatial_ref_sys SET proj4text = '+proj=longlat +ellps=clrk66 " +"+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null +no_defs' WHERE srid " +"= 4267;" + +#. Tag: para +#: reference_editor.xml:1390 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_editor.xml:1396 +#, no-c-format +msgid "ST_Translate" +msgstr "ST_Translate" + +#. Tag: refpurpose +#: reference_editor.xml:1398 +#, no-c-format +msgid "" +"Translates the geometry to a new location using the numeric parameters as " +"offsets. Ie: ST_Translate(geom, X, Y) or ST_Translate(geom, X, Y,Z)." +msgstr "" + +#. Tag: funcsynopsis +#: reference_editor.xml:1403 +#, no-c-format +msgid "" +" geometry ST_Translate geometry g1 float deltax float deltay geometry " +"ST_Translate geometry " +"g1 float " +"deltax float " +"deltay float " +"deltaz " +msgstr "" +" geometry ST_Translate geometry g1 float deltax float deltay geometry " +"ST_Translate geometry " +"g1 float " +"deltax float " +"deltay float " +"deltaz " + +#. Tag: para +#: reference_editor.xml:1423 +#, no-c-format +msgid "" +"Returns a new geometry whose coordinates are translated delta x,delta y," +"delta z units. Units are based on the units defined in spatial reference " +"(SRID) for this geometry." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1435 +#, no-c-format +msgid "Move a point 1 degree longitude" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1436 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 " +"42.37)',4326),1,0)) As wgs_transgeomtxt;\n" +"\n" +" wgs_transgeomtxt\n" +" ---------------------\n" +" POINT(-70.01 42.37)" +msgstr "" +"SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 " +"42.37)',4326),1,0)) As wgs_transgeomtxt;\n" +"\n" +" wgs_transgeomtxt\n" +" ---------------------\n" +" POINT(-70.01 42.37)" + +#. Tag: para +#: reference_editor.xml:1437 +#, no-c-format +msgid "Move a linestring 1 degree longitude and 1/2 degree latitude" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1438 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Translate(ST_GeomFromText('LINESTRING(-71.01 " +"42.37,-71.11 42.38)',4326),1,0.5)) As wgs_transgeomtxt;\n" +" wgs_transgeomtxt\n" +" ---------------------------------------\n" +" LINESTRING(-70.01 42.87,-70.11 42.88)" +msgstr "" +"SELECT ST_AsText(ST_Translate(ST_GeomFromText('LINESTRING(-71.01 " +"42.37,-71.11 42.38)',4326),1,0.5)) As wgs_transgeomtxt;\n" +" wgs_transgeomtxt\n" +" ---------------------------------------\n" +" LINESTRING(-70.01 42.87,-70.11 42.88)" + +#. Tag: para +#: reference_editor.xml:1439 +#, no-c-format +msgid "Move a 3d point" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1440 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));\n" +" st_asewkt\n" +" ---------\n" +" POINT(5 12 3)" +msgstr "" +"SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));\n" +" st_asewkt\n" +" ---------\n" +" POINT(5 12 3)" + +#. Tag: para +#: reference_editor.xml:1441 +#, no-c-format +msgid "Move a curve and a point" +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1442 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 " +"3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));\n" +" st_astext\n" +"------------------------------------------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 " +"7.1213,7 9,9 11,5 5)),POINT(2 5))" +msgstr "" +"SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 " +"3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));\n" +" st_astext\n" +"------------------------------------------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 " +"7.1213,7 9,9 11,5 5)),POINT(2 5))" + +#. Tag: para +#: reference_editor.xml:1448 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_editor.xml:1454 +#, no-c-format +msgid "ST_TransScale" +msgstr "ST_TransScale" + +#. Tag: refpurpose +#: reference_editor.xml:1456 +#, no-c-format +msgid "" +"Translates the geometry using the deltaX and deltaY args, then " +"scales it using the XFactor, YFactor args, working in 2D only." +msgstr "" + +#. Tag: funcprototype +#: reference_editor.xml:1463 +#, no-c-format +msgid "" +"geometry ST_TransScale " +"geometry geomA " +"float deltaX " +"float deltaY " +"float XFactor " +"float YFactor" +msgstr "" +"geometry ST_TransScale " +"geometry geomA " +"float deltaX " +"float deltaY " +"float XFactor " +"float YFactor" + +#. Tag: para +#: reference_editor.xml:1477 +#, no-c-format +msgid "" +"Translates the geometry using the deltaX and deltaY args, then scales " +"it using the XFactor, YFactor args, working in 2D only." +msgstr "" + +#. Tag: para +#: reference_editor.xml:1480 +#, no-c-format +msgid "" +"ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor) is short-" +"hand for ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, " +"deltaX*XFactor, deltaY*YFactor, 0)." +msgstr "" + +#. Tag: programlisting +#: reference_editor.xml:1496 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_TransScale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), " +"0.5, 1, 1, 2));\n" +" st_asewkt\n" +"-----------------------------\n" +" LINESTRING(1.5 6 3,1.5 4 1)\n" +"\n" +"\n" +"--Buffer a point to get an approximation of a circle, convert to curve and " +"then translate 1,2 and scale it 3,4\n" +" SELECT ST_AsText(ST_Transscale(ST_LineToCurve(ST_Buffer('POINT(234 567)', " +"3)),1,2,3,4));\n" +" st_astext\n" +"------------------------------------------------------------------------------------------------------------------------------\n" +" CURVEPOLYGON(CIRCULARSTRING(714 2276,711.363961030679 2267.51471862576,705 " +"2264,698.636038969321 2284.48528137424,714 2276))" +msgstr "" + +#. Tag: para +#: reference_editor.xml:1503 +#, no-c-format +msgid ", " +msgstr ", " diff --git a/doc/po/pl/reference_exception.xml.po b/doc/po/pl/reference_exception.xml.po new file mode 100644 index 000000000..f0d4d7ec6 --- /dev/null +++ b/doc/po/pl/reference_exception.xml.po @@ -0,0 +1,238 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2014-01-03 08:07+0000\n" +"Last-Translator: Jakub Bobrowski \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_exception.xml:3 +#, no-c-format +msgid "Exceptional Functions" +msgstr "" + +#. Tag: para +#: reference_exception.xml:4 +#, no-c-format +msgid "" +"These functions are rarely used functions that should only be used if your " +"data is corrupted in someway. They are used for troubleshooting corruption " +"and also fixing things that should under normal circumstances, never happen." +msgstr "" + +#. Tag: refname +#: reference_exception.xml:9 +#, no-c-format +msgid "PostGIS_AddBBox" +msgstr "PostGIS_AddBBox" + +#. Tag: refpurpose +#: reference_exception.xml:11 +#, no-c-format +msgid "Add bounding box to the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_exception.xml:16 +#, no-c-format +msgid "" +"geometry PostGIS_AddBBox " +"geometry geomA" +msgstr "" +"geometry PostGIS_AddBBox " +"geometry geomA" + +#. Tag: title +#: reference_exception.xml:24 reference_exception.xml:70 +#: reference_exception.xml:119 +#, no-c-format +msgid "Description" +msgstr "Opis" + +#. Tag: para +#: reference_exception.xml:26 +#, no-c-format +msgid "" +"Add bounding box to the geometry. This would make bounding box based queries " +"faster, but will increase the size of the geometry." +msgstr "" + +#. Tag: para +#: reference_exception.xml:31 +#, no-c-format +msgid "" +"Bounding boxes are automatically added to geometries so in general this is " +"not needed unless the generated bounding box somehow becomes corrupted or " +"you have an old install that is lacking bounding boxes. Then you need to " +"drop the old and readd." +msgstr "" + +#. Tag: para +#: reference_exception.xml:35 reference_exception.xml:83 +#: reference_exception.xml:124 +#, no-c-format +msgid "&curve_support;" +msgstr "&curve_support;" + +#. Tag: title +#: reference_exception.xml:40 reference_exception.xml:88 +#: reference_exception.xml:129 +#, no-c-format +msgid "Examples" +msgstr "Przykłady" + +#. Tag: programlisting +#: reference_exception.xml:42 +#, no-c-format +msgid "" +"UPDATE sometable\n" +" SET the_geom = PostGIS_AddBBox(the_geom)\n" +" WHERE PostGIS_HasBBox(the_geom) = false;" +msgstr "" +"UPDATE sometable\n" +" SET the_geom = PostGIS_AddBBox(the_geom)\n" +" WHERE PostGIS_HasBBox(the_geom) = false;" + +#. Tag: title +#: reference_exception.xml:47 reference_exception.xml:95 +#: reference_exception.xml:136 +#, no-c-format +msgid "See Also" +msgstr "Zobacz także" + +#. Tag: para +#: reference_exception.xml:49 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_exception.xml:55 +#, no-c-format +msgid "PostGIS_DropBBox" +msgstr "PostGIS_DropBBox" + +#. Tag: refpurpose +#: reference_exception.xml:57 +#, no-c-format +msgid "Drop the bounding box cache from the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_exception.xml:62 +#, no-c-format +msgid "" +"geometry PostGIS_DropBBox " +"geometry geomA" +msgstr "" +"geometry PostGIS_DropBBox " +"geometry geomA" + +#. Tag: para +#: reference_exception.xml:72 +#, no-c-format +msgid "" +"Drop the bounding box cache from the geometry. This reduces geometry size, " +"but makes bounding-box based queries slower. It is also used to drop a " +"corrupt bounding box. A tale-tell sign of a corrupt cached bounding box is " +"when your ST_Intersects and other relation queries leave out geometries that " +"rightfully should return true." +msgstr "" + +#. Tag: para +#: reference_exception.xml:77 +#, no-c-format +msgid "" +"Bounding boxes are automatically added to geometries and improve speed of " +"queries so in general this is not needed unless the generated bounding box " +"somehow becomes corrupted or you have an old install that is lacking " +"bounding boxes. Then you need to drop the old and readd. This kind of " +"corruption has been observed in 8.3-8.3.6 series whereby cached bboxes were " +"not always recalculated when a geometry changed and upgrading to a newer " +"version without a dump reload will not correct already corrupted boxes. So " +"one can manually correct using below and readd the bbox or do a dump reload." +msgstr "" + +#. Tag: programlisting +#: reference_exception.xml:90 +#, no-c-format +msgid "" +"--This example drops bounding boxes where the cached box is not correct\n" +" --The force to ST_AsBinary before applying Box2D " +"forces a recalculation of the box, and Box2D applied to the table geometry " +"always\n" +" -- returns the cached bounding box.\n" +" UPDATE sometable\n" +" SET the_geom = PostGIS_DropBBox(the_geom)\n" +" WHERE Not (Box2D(ST_AsBinary(the_geom)) = Box2D(the_geom));\n" +"\n" +" UPDATE sometable\n" +" SET the_geom = PostGIS_AddBBox(the_geom)\n" +" WHERE Not PostGIS_HasBBOX(the_geom);" +msgstr "" + +#. Tag: para +#: reference_exception.xml:97 +#, no-c-format +msgid ", , " +msgstr ", , " + +#. Tag: refname +#: reference_exception.xml:104 +#, no-c-format +msgid "PostGIS_HasBBox" +msgstr "PostGIS_HasBBox" + +#. Tag: refpurpose +#: reference_exception.xml:106 +#, no-c-format +msgid "Returns TRUE if the bbox of this geometry is cached, FALSE otherwise." +msgstr "" + +#. Tag: funcprototype +#: reference_exception.xml:111 +#, no-c-format +msgid "" +"boolean PostGIS_HasBBox " +"geometry geomA" +msgstr "" +"boolean PostGIS_HasBBox " +"geometry geomA" + +#. Tag: para +#: reference_exception.xml:121 +#, no-c-format +msgid "" +"Returns TRUE if the bbox of this geometry is cached, FALSE otherwise. Use " +" and " +"to control caching." +msgstr "" + +#. Tag: programlisting +#: reference_exception.xml:131 +#, no-c-format +msgid "" +"SELECT the_geom\n" +"FROM sometable WHERE PostGIS_HasBBox(the_geom) = false;" +msgstr "" +"SELECT the_geom\n" +"FROM sometable WHERE PostGIS_HasBBox(the_geom) = false;" + +#. Tag: para +#: reference_exception.xml:138 +#, no-c-format +msgid ", " +msgstr ", " diff --git a/doc/po/pl/reference_guc.xml.po b/doc/po/pl/reference_guc.xml.po new file mode 100644 index 000000000..d7eaaf780 --- /dev/null +++ b/doc/po/pl/reference_guc.xml.po @@ -0,0 +1,408 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2014-10-10 23:07+0000\n" +"PO-Revision-Date: 2014-10-13 17:58+0000\n" +"Last-Translator: FULL NAME \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: para +#: reference_guc.xml:5 +#, no-c-format +msgid "" +"This section lists custom PostGIS Grand Unified Custom Variables(GUC). These " +"can be set globally, by database, by session or by transaction. Best set at " +"global or database level." +msgstr "" + +#. Tag: title +#: reference_guc.xml:8 +#, no-c-format +msgid "PostGIS Grand Unified Custom Variables (GUCs)" +msgstr "" + +#. Tag: refname +#: reference_guc.xml:12 +#, no-c-format +msgid "postgis.backend" +msgstr "" + +#. Tag: refpurpose +#: reference_guc.xml:13 +#, no-c-format +msgid "" +"The backend to service a function where GEOS and SFCGAL overlap. Options: " +"geos or sfcgal. Defaults to geos." +msgstr "" + +#. Tag: title +#: reference_guc.xml:17 reference_guc.xml:45 reference_guc.xml:99 +#: reference_guc.xml:191 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_guc.xml:18 +#, no-c-format +msgid "" +"This GUC is only relevant if you compiled PostGIS with sfcgal support. By " +"default geos backend is used for functions where both " +"GEOS and SFCGAL have the same named function. This variable allows you to " +"override and make sfcgal the backend to service the request." +msgstr "" + +#. Tag: para +#: reference_guc.xml:19 +#, no-c-format +msgid "Availability: 2.1.0" +msgstr "" + +#. Tag: title +#: reference_guc.xml:23 reference_guc.xml:69 reference_guc.xml:150 +#: reference_guc.xml:217 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: para +#: reference_guc.xml:24 +#, no-c-format +msgid "Sets backend just for life of connection" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:25 +#, no-c-format +msgid "set postgis.backend = sfcgal;" +msgstr "" + +#. Tag: para +#: reference_guc.xml:27 +#, no-c-format +msgid "Sets backend for new connections to database" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:28 +#, no-c-format +msgid "ALTER DATABASE mygisdb SET postgis.backend = sfcgal;" +msgstr "" + +#. Tag: title +#: reference_guc.xml:31 reference_guc.xml:83 reference_guc.xml:170 +#: reference_guc.xml:229 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: reference_guc.xml:38 +#, no-c-format +msgid "postgis.gdal_datapath" +msgstr "" + +#. Tag: refpurpose +#: reference_guc.xml:39 +#, no-c-format +msgid "" +"A configuration option to assign the value of GDAL's GDAL_DATA option. If " +"not set, the environmentally set GDAL_DATA variable is used." +msgstr "" + +#. Tag: para +#: reference_guc.xml:46 +#, no-c-format +msgid "" +"A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. " +"The postgis.gdal_datapath value should be the complete " +"physical path to GDAL's data files." +msgstr "" + +#. Tag: para +#: reference_guc.xml:49 +#, no-c-format +msgid "" +"This configuration option is of most use for Windows platforms where GDAL's " +"data files path is not hard-coded. This option should also be set when " +"GDAL's data files are not located in GDAL's expected path." +msgstr "" + +#. Tag: para +#: reference_guc.xml:54 +#, no-c-format +msgid "" +"This option can be set in PostgreSQL's configuration file postgresql.conf. " +"It can also be set by connection or transaction." +msgstr "" + +#. Tag: para +#: reference_guc.xml:58 reference_guc.xml:145 reference_guc.xml:212 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: para +#: reference_guc.xml:61 +#, no-c-format +msgid "" +"Additional information about GDAL_DATA is available at GDAL's Configuration Options." +msgstr "" + +#. Tag: para +#: reference_guc.xml:70 +#, no-c-format +msgid "Set and reset postgis.gdal_datapath" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:72 +#, no-c-format +msgid "" +"SET postgis.gdal_datapath TO '/usr/local/share/gdal.hidden';\n" +"SET postgis.gdal_datapath TO default;" +msgstr "" + +#. Tag: para +#: reference_guc.xml:77 +#, no-c-format +msgid "Setting on windows for a particular database" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:78 +#, no-c-format +msgid "" +"ALTER DATABASE gisdb\n" +"SET postgis.gdal_datapath = 'C:/Program Files/PostgreSQL/9.3/gdal-data';" +msgstr "" + +#. Tag: para +#: reference_guc.xml:84 +#, no-c-format +msgid "," +msgstr "" + +#. Tag: refname +#: reference_guc.xml:92 +#, no-c-format +msgid "postgis.gdal_enabled_drivers" +msgstr "" + +#. Tag: refpurpose +#: reference_guc.xml:93 +#, no-c-format +msgid "" +"A configuration option to set the enabled GDAL drivers in the PostGIS " +"environment. Affects the GDAL configuration variable GDAL_SKIP." +msgstr "" + +#. Tag: para +#: reference_guc.xml:100 +#, no-c-format +msgid "" +"A configuration option to set the enabled GDAL drivers in the PostGIS " +"environment. Affects the GDAL configuration variable GDAL_SKIP. This option " +"can be set in PostgreSQL's configuration file: postgresql.conf. It can also " +"be set by connection or transaction." +msgstr "" + +#. Tag: para +#: reference_guc.xml:104 +#, no-c-format +msgid "" +"The initial value of postgis.gdal_enabled_drivers may " +"also be set by passing the environment variable " +"POSTGIS_GDAL_ENABLED_DRIVERS with the list of enabled " +"drivers to the process starting PostgreSQL." +msgstr "" + +#. Tag: para +#: reference_guc.xml:108 +#, no-c-format +msgid "" +"Enabled GDAL specified drivers can be specified by the driver's short-name " +"or code. Driver short-names or codes can be found at GDAL Raster Formats. Multiple drivers " +"can be specified by putting a space between each driver." +msgstr "" + +#. Tag: para +#: reference_guc.xml:113 +#, no-c-format +msgid "" +"There are three special codes available for postgis." +"gdal_enabled_drivers. The codes are case-sensitive." +msgstr "" + +#. Tag: para +#: reference_guc.xml:118 +#, no-c-format +msgid "" +"DISABLE_ALL disables all GDAL drivers. If present, " +"DISABLE_ALL overrides all other values in " +"postgis.gdal_enabled_drivers." +msgstr "" + +#. Tag: para +#: reference_guc.xml:121 +#, no-c-format +msgid "ENABLE_ALL enables all GDAL drivers." +msgstr "" + +#. Tag: para +#: reference_guc.xml:124 +#, no-c-format +msgid "" +"VSICURL enables GDAL's /vsicurl/ " +"virtual file system." +msgstr "" + +#. Tag: para +#: reference_guc.xml:128 +#, no-c-format +msgid "" +"When postgis.gdal_enabled_drivers is set to DISABLE_ALL, " +"attempts to use out-db rasters, ST_FromGDALRaster(), ST_AsGDALRaster(), " +"ST_AsTIFF(), ST_AsJPEG() and ST_AsPNG() will result in error messages." +msgstr "" + +#. Tag: para +#: reference_guc.xml:134 +#, no-c-format +msgid "" +"In the standard PostGIS installation, postgis.gdal_enabled_drivers is set to DISABLE_ALL." +msgstr "" + +#. Tag: para +#: reference_guc.xml:140 +#, no-c-format +msgid "" +"Additional information about GDAL_SKIP is available at GDAL's Configuration Options." +msgstr "" + +#. Tag: para +#: reference_guc.xml:151 +#, no-c-format +msgid "Set and reset postgis.gdal_enabled_drivers" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:153 +#, no-c-format +msgid "" +"SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';\n" +"SET postgis.gdal_enabled_drivers = default;" +msgstr "" + +#. Tag: para +#: reference_guc.xml:158 +#, no-c-format +msgid "Enable all GDAL Drivers" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:159 +#, no-c-format +msgid "SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';" +msgstr "" + +#. Tag: para +#: reference_guc.xml:163 +#, no-c-format +msgid "Disable all GDAL Drivers" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:164 +#, no-c-format +msgid "SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';" +msgstr "" + +#. Tag: para +#: reference_guc.xml:171 +#, no-c-format +msgid "" +", , , " +", ," +msgstr "" + +#. Tag: refname +#: reference_guc.xml:184 +#, no-c-format +msgid "postgis.enable_outdb_rasters" +msgstr "" + +#. Tag: refpurpose +#: reference_guc.xml:185 +#, no-c-format +msgid "A boolean configuration option to enable access to out-db raster bands." +msgstr "" + +#. Tag: para +#: reference_guc.xml:192 +#, no-c-format +msgid "" +"A boolean configuration option to enable access to out-db raster bands. This " +"option can be set in PostgreSQL's configuration file: postgresql.conf. It " +"can also be set by connection or transaction." +msgstr "" + +#. Tag: para +#: reference_guc.xml:196 +#, no-c-format +msgid "" +"The initial value of postgis.enable_outdb_rasters may " +"also be set by passing the environment variable " +"POSTGIS_ENABLE_OUTDB_RASTERS with a non-zero value to the " +"process starting PostgreSQL." +msgstr "" + +#. Tag: para +#: reference_guc.xml:201 +#, no-c-format +msgid "" +"Even if postgis.enable_outdb_rasters is True, the GUC " +"postgis.enable_outdb_rasters determines the accessible " +"raster formats." +msgstr "" + +#. Tag: para +#: reference_guc.xml:207 +#, no-c-format +msgid "" +"In the standard PostGIS installation, postgis.enable_outdb_rasters is set to False." +msgstr "" + +#. Tag: para +#: reference_guc.xml:218 +#, no-c-format +msgid "Set and reset postgis.enable_outdb_rasters" +msgstr "" + +#. Tag: programlisting +#: reference_guc.xml:220 +#, no-c-format +msgid "" +"SET postgis.enable_outdb_rasters TO True;\n" +"SET postgis.enable_outdb_rasters = default;\n" +"SET postgis.enable_outdb_rasters = True;\n" +"SET postgis.enable_outdb_rasters = False;" +msgstr "" diff --git a/doc/po/pl/reference_lrs.xml.po b/doc/po/pl/reference_lrs.xml.po new file mode 100644 index 000000000..8c3999072 --- /dev/null +++ b/doc/po/pl/reference_lrs.xml.po @@ -0,0 +1,878 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2014-01-03 08:17+0000\n" +"Last-Translator: Jakub Bobrowski \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_lrs.xml:3 +#, no-c-format +msgid "Linear Referencing" +msgstr "" + +#. Tag: refname +#: reference_lrs.xml:7 +#, no-c-format +msgid "ST_Line_Interpolate_Point" +msgstr "ST_Line_Interpolate_Point" + +#. Tag: refpurpose +#: reference_lrs.xml:9 +#, no-c-format +msgid "" +"Returns a point interpolated along a line. Second argument is a float8 " +"between 0 and 1 representing fraction of total length of linestring the " +"point has to be located." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:15 +#, no-c-format +msgid "" +"geometry ST_Line_Interpolate_Point " +"geometry a_linestring float a_fraction" +msgstr "" +"geometry ST_Line_Interpolate_Point " +"geometry a_linestring float a_fraction" + +#. Tag: title +#: reference_lrs.xml:24 reference_lrs.xml:85 reference_lrs.xml:136 +#: reference_lrs.xml:202 reference_lrs.xml:260 reference_lrs.xml:311 +#: reference_lrs.xml:356 reference_lrs.xml:400 +#, no-c-format +msgid "Description" +msgstr "Opis" + +#. Tag: para +#: reference_lrs.xml:26 +#, no-c-format +msgid "" +"Returns a point interpolated along a line. First argument must be a " +"LINESTRING. Second argument is a float8 between 0 and 1 representing " +"fraction of total linestring length the point has to be located." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:30 reference_lrs.xml:147 +#, no-c-format +msgid "" +"See for computing the line location " +"nearest to a Point." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:34 +#, no-c-format +msgid "" +"Since release 1.1.1 this function also interpolates M and Z values (when " +"present), while prior releases set them to 0.0." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:38 +#, no-c-format +msgid "Availability: 0.8.2, Z and M supported added in 1.1.1" +msgstr "Dostępność: 0.8.2 - wsparcie dla Z i M dodano w wersji 1.1.1" + +#. Tag: para +#: reference_lrs.xml:39 reference_lrs.xml:157 reference_lrs.xml:319 +#: reference_lrs.xml:362 reference_lrs.xml:406 +#, no-c-format +msgid "&Z_support;" +msgstr "&Z_support;" + +#. Tag: title +#: reference_lrs.xml:44 reference_lrs.xml:101 reference_lrs.xml:161 +#: reference_lrs.xml:225 reference_lrs.xml:276 reference_lrs.xml:323 +#: reference_lrs.xml:366 reference_lrs.xml:410 +#, no-c-format +msgid "Examples" +msgstr "Przykłady" + +#. Tag: para +#: reference_lrs.xml:50 +#, no-c-format +msgid "A linestring with the interpolated point at 20% position (0.20)" +msgstr "" + +#. Tag: programlisting +#: reference_lrs.xml:53 +#, no-c-format +msgid "" +"--Return point 20% along 2d line\n" +"SELECT ST_AsEWKT(ST_Line_Interpolate_Point(the_line, 0.20))\n" +" FROM (SELECT ST_GeomFromEWKT('LINESTRING(25 50, 100 125, 150 190)') " +"as the_line) As foo;\n" +" st_asewkt\n" +"----------------\n" +" POINT(51.5974135047432 76.5974135047432)" +msgstr "" + +#. Tag: programlisting +#: reference_lrs.xml:54 +#, no-c-format +msgid "" +"--Return point mid-way of 3d line\n" +"SELECT ST_AsEWKT(ST_Line_Interpolate_Point(the_line, 0.5))\n" +" FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 4 5 6, 6 7 8)') as " +"the_line) As foo;\n" +"\n" +" st_asewkt\n" +"--------------------\n" +" POINT(3.5 4.5 5.5)\n" +"\n" +"\n" +"--find closest point on a line to a point or other geometry\n" +" SELECT ST_AsText(ST_Line_Interpolate_Point(foo.the_line, " +"ST_Line_Locate_Point(foo.the_line, ST_GeomFromText('POINT(4 3)'))))\n" +"FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As the_line) As " +"foo;\n" +" st_astext\n" +"----------------\n" +" POINT(3 4)" +msgstr "" + +#. Tag: title +#: reference_lrs.xml:59 reference_lrs.xml:108 reference_lrs.xml:175 +#: reference_lrs.xml:231 reference_lrs.xml:283 reference_lrs.xml:330 +#: reference_lrs.xml:372 +#, no-c-format +msgid "See Also" +msgstr "Zobacz także" + +#. Tag: para +#: reference_lrs.xml:61 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_lrs.xml:67 +#, no-c-format +msgid "ST_Line_Locate_Point" +msgstr "ST_Line_Locate_Point" + +#. Tag: refpurpose +#: reference_lrs.xml:69 +#, no-c-format +msgid "" +"Returns a float between 0 and 1 representing the location of the closest " +"point on LineString to the given Point, as a fraction of total 2d line " +"length." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:76 +#, no-c-format +msgid "" +"float ST_Line_Locate_Point " +"geometry a_linestring geometry a_point" +msgstr "" +"float ST_Line_Locate_Point " +"geometry a_linestring geometry a_point" + +#. Tag: para +#: reference_lrs.xml:87 +#, no-c-format +msgid "" +"Returns a float between 0 and 1 representing the location of the closest " +"point on LineString to the given Point, as a fraction of total 2d line length." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:91 +#, no-c-format +msgid "" +"You can use the returned location to extract a Point () or a substring ()." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:94 +#, no-c-format +msgid "This is useful for approximating numbers of addresses" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:96 +#, no-c-format +msgid "Availability: 1.1.0" +msgstr "Dostępność: 1.1.0" + +#. Tag: programlisting +#: reference_lrs.xml:103 +#, no-c-format +msgid "" +"--Rough approximation of finding the street number of a point along the " +"street\n" +"--Note the whole foo thing is just to generate dummy data that looks\n" +"--like house centroids and street\n" +"--We use ST_DWithin to exclude\n" +"--houses too far away from the street to be considered on the street\n" +"SELECT ST_AsText(house_loc) As as_text_house_loc,\n" +" startstreet_num +\n" +" CAST( (endstreet_num - startstreet_num)\n" +" * ST_Line_Locate_Point(street_line, house_loc) As " +"integer) As street_num\n" +"FROM\n" +"(SELECT ST_GeomFromText('LINESTRING(1 2, 3 4)') As street_line,\n" +" ST_MakePoint(x*1.01,y*1.03) As house_loc, 10 As startstreet_num,\n" +" 20 As endstreet_num\n" +"FROM generate_series(1,3) x CROSS JOIN generate_series(2,4) As y)\n" +"As foo\n" +"WHERE ST_DWithin(street_line, house_loc, 0.2);\n" +"\n" +" as_text_house_loc | street_num\n" +"-------------------+------------\n" +" POINT(1.01 2.06) | 10\n" +" POINT(2.02 3.09) | 15\n" +" POINT(3.03 4.12) | 20\n" +"\n" +" --find closest point on a line to a point or other geometry\n" +" SELECT ST_AsText(ST_Line_Interpolate_Point(foo.the_line, " +"ST_Line_Locate_Point(foo.the_line, ST_GeomFromText('POINT(4 3)'))))\n" +"FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As the_line) As " +"foo;\n" +" st_astext\n" +"----------------\n" +" POINT(3 4)" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:110 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_lrs.xml:116 +#, no-c-format +msgid "ST_Line_Substring" +msgstr "ST_Line_Substring" + +#. Tag: refpurpose +#: reference_lrs.xml:118 +#, no-c-format +msgid "" +"Return a linestring being a substring of the input one starting and ending " +"at the given fractions of total 2d length. Second and third arguments are " +"float8 values between 0 and 1." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:126 +#, no-c-format +msgid "" +"geometry ST_Line_Substring " +"geometry a_linestring float startfraction float endfraction" +msgstr "" +"geometry ST_Line_Substring " +"geometry a_linestring float startfraction float endfraction" + +#. Tag: para +#: reference_lrs.xml:138 +#, no-c-format +msgid "" +"Return a linestring being a substring of the input one starting and ending " +"at the given fractions of total 2d length. Second and third arguments are " +"float8 values between 0 and 1. This only works with LINESTRINGs. To use with " +"contiguous MULTILINESTRINGs use in conjunction with ." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:144 +#, no-c-format +msgid "" +"If 'start' and 'end' have the same value this is equivalent to ." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:151 +#, no-c-format +msgid "" +"Since release 1.1.1 this function also interpolates M and Z values (when " +"present), while prior releases set them to unspecified values." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:156 +#, no-c-format +msgid "Availability: 1.1.0, Z and M supported added in 1.1.1" +msgstr "Dostępność: 1.1.0 - wsparcie dla Z i M" + +#. Tag: para +#: reference_lrs.xml:167 +#, no-c-format +msgid "A linestring seen with 1/3 midrange overlaid (0.333, 0.666)" +msgstr "" + +#. Tag: programlisting +#: reference_lrs.xml:170 +#, no-c-format +msgid "" +"--Return the approximate 1/3 mid-range part of a linestring\n" +"SELECT ST_AsText(ST_Line_SubString(ST_GeomFromText('LINESTRING(25 50, 100 " +"125, 150 190)'), 0.333, 0.666));\n" +"\n" +" st_astext\n" +"------------------------------------------------------------------------------------------------\n" +"LINESTRING(69.2846934853974 94.2846934853974,100 125,111.700356260683 " +"140.210463138888)\n" +"\n" +"--The below example simulates a while loop in\n" +"--SQL using PostgreSQL generate_series() to cut all\n" +"--linestrings in a table to 100 unit segments\n" +"-- of which no segment is longer than 100 units\n" +"-- units are measured in the SRID units of measurement\n" +"-- It also assumes all geometries are LINESTRING or contiguous " +"MULTILINESTRING\n" +"--and no geometry is longer than 100 units*10000\n" +"--for better performance you can reduce the 10000\n" +"--to match max number of segments you expect\n" +"\n" +"SELECT field1, field2, ST_Line_Substring(the_geom, 100.00*n/length,\n" +" CASE\n" +" WHEN 100.00*(n+1) < length THEN 100.00*(n+1)/length\n" +" ELSE 1\n" +" END) As the_geom\n" +"FROM\n" +" (SELECT sometable.field1, sometable.field2,\n" +" ST_LineMerge(sometable.the_geom) AS the_geom,\n" +" ST_Length(sometable.the_geom) As length\n" +" FROM sometable\n" +" ) AS t\n" +"CROSS JOIN generate_series(0,10000) AS n\n" +"WHERE n*100.00/length < 1;" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:177 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_lrs.xml:183 +#, no-c-format +msgid "ST_LocateAlong" +msgstr "ST_LocateAlong" + +#. Tag: refpurpose +#: reference_lrs.xml:185 +#, no-c-format +msgid "" +"Return a derived geometry collection value with elements that " +"match the specified measure. Polygonal elements are not supported." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:192 +#, no-c-format +msgid "" +"geometry ST_LocateAlong " +"geometry ageom_with_measure float a_measure float offset" +msgstr "" +"geometry ST_LocateAlong " +"geometry ageom_with_measure float a_measure float offset" + +#. Tag: para +#: reference_lrs.xml:204 +#, no-c-format +msgid "" +"Return a derived geometry collection value with elements that match " +"the specified measure. Polygonal elements are not supported." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:208 +#, no-c-format +msgid "" +"If an offset is provided, the resultant will be offset to the left or right " +"of the input line by the specified number of units. A positive offset will " +"be to the left, and a negative one to the right." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:213 reference_lrs.xml:266 +#, no-c-format +msgid "" +"Semantic is specified by: ISO/IEC CD 13249-3:200x(E) - Text for Continuation " +"CD Editing Meeting" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:216 +#, no-c-format +msgid "Availability: 1.1.0 by old name ST_Locate_Along_Measure." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:217 +#, no-c-format +msgid "" +"Changed: 2.0.0 in prior versions this used to be called " +"ST_Locate_Along_Measure. The old name has been deprecated and will be " +"removed in the future but is still available." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:218 +#, no-c-format +msgid "Use this function only for geometries with an M component" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:220 reference_lrs.xml:272 +#, no-c-format +msgid "&M_support;" +msgstr "&M_support;" + +#. Tag: programlisting +#: reference_lrs.xml:226 +#, no-c-format +msgid "" +"SELECT ST_AsText(the_geom)\n" +" FROM\n" +" (SELECT ST_LocateAlong(\n" +" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 " +"3),\n" +" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"-----------------------------------------------------------\n" +" MULTIPOINT M (1 2 3)\n" +"\n" +"--Geometry collections are difficult animals so dump them\n" +"--to make them more digestable\n" +"SELECT ST_AsText((ST_Dump(the_geom)).geom)\n" +" FROM\n" +" (SELECT ST_LocateAlong(\n" +" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 " +"3),\n" +" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"---------------\n" +" POINTM(1 2 3)\n" +" POINTM(9 4 3)\n" +" POINTM(1 2 3)" +msgstr "" +"SELECT ST_AsText(the_geom)\n" +" FROM\n" +" (SELECT ST_LocateAlong(\n" +" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 " +"3),\n" +" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"-----------------------------------------------------------\n" +" MULTIPOINT M (1 2 3)\n" +"\n" +"--Geometry collections are difficult animals so dump them\n" +"--to make them more digestable\n" +"SELECT ST_AsText((ST_Dump(the_geom)).geom)\n" +" FROM\n" +" (SELECT ST_LocateAlong(\n" +" ST_GeomFromText('MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 " +"3),\n" +" (1 2 3, 5 4 5))'),3) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"---------------\n" +" POINTM(1 2 3)\n" +" POINTM(9 4 3)\n" +" POINTM(1 2 3)" + +#. Tag: para +#: reference_lrs.xml:233 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_lrs.xml:239 +#, no-c-format +msgid "ST_LocateBetween" +msgstr "ST_LocateBetween" + +#. Tag: refpurpose +#: reference_lrs.xml:241 +#, no-c-format +msgid "" +"Return a derived geometry collection value with elements that " +"match the specified range of measures inclusively. Polygonal elements are " +"not supported." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:248 +#, no-c-format +msgid "" +"geometry ST_LocateBetween " +"geometry geomA " +"float measure_start float measure_end float offset" +msgstr "" +"geometry ST_LocateBetween " +"geometry geomA " +"float measure_start float measure_end float offset" + +#. Tag: para +#: reference_lrs.xml:262 +#, no-c-format +msgid "" +"Return a derived geometry collection value with elements that match " +"the specified range of measures inclusively. Polygonal elements are not " +"supported." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:269 +#, no-c-format +msgid "Availability: 1.1.0 by old name ST_Locate_Between_Measures." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:270 +#, no-c-format +msgid "" +"Changed: 2.0.0 - in prior versions this used to be called " +"ST_Locate_Between_Measures. The old name has been deprecated and will be " +"removed in the future but is still available for backward compatibility." +msgstr "" + +#. Tag: programlisting +#: reference_lrs.xml:278 +#, no-c-format +msgid "" +"SELECT ST_AsText(the_geom)\n" +" FROM\n" +" (SELECT ST_LocateBetween(\n" +" ST_GeomFromText('MULTILINESTRING M ((1 2 3, 3 4 2, 9 " +"4 3),\n" +" (1 2 3, 5 4 5))'),1.5, 3) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION M (LINESTRING M (1 2 3,3 4 2,9 4 3),POINT M (1 2 3))\n" +"\n" +"--Geometry collections are difficult animals so dump them\n" +"--to make them more digestable\n" +"SELECT ST_AsText((ST_Dump(the_geom)).geom)\n" +" FROM\n" +" (SELECT ST_LocateBetween(\n" +" ST_GeomFromText('MULTILINESTRING M ((1 2 3, 3 4 2, 9 " +"4 3),\n" +" (1 2 3, 5 4 5))'),1.5, 3) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"--------------------------------\n" +" LINESTRING M (1 2 3,3 4 2,9 4 3)\n" +" POINT M (1 2 3)" +msgstr "" + +#. Tag: para +#: reference_lrs.xml:285 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_lrs.xml:291 +#, no-c-format +msgid "ST_LocateBetweenElevations" +msgstr "ST_LocateBetweenElevations" + +#. Tag: refpurpose +#: reference_lrs.xml:293 +#, no-c-format +msgid "" +"Return a derived geometry (collection) value with elements that intersect " +"the specified range of elevations inclusively. Only 3D, 4D LINESTRINGS and " +"MULTILINESTRINGS are supported." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:300 +#, no-c-format +msgid "" +"geometry ST_LocateBetweenElevations " +"geometry geom_mline float elevation_start float " +"elevation_end" +msgstr "" +"geometry ST_LocateBetweenElevations " +"geometry geom_mline float elevation_start float " +"elevation_end" + +#. Tag: para +#: reference_lrs.xml:313 +#, no-c-format +msgid "" +"Return a derived geometry (collection) value with elements that intersect " +"the specified range of elevations inclusively. Only 3D, 3DM LINESTRINGS and " +"MULTILINESTRINGS are supported." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:317 +#, no-c-format +msgid "Availability: 1.4.0" +msgstr "Dostępność: 1.4.0" + +#. Tag: programlisting +#: reference_lrs.xml:325 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_LocateBetweenElevations(\n" +" ST_GeomFromEWKT('LINESTRING(1 2 3, 4 5 6)'),2,4)) As " +"ewelev;\n" +" ewelev\n" +"----------------------------------------------------------------\n" +" MULTILINESTRING((1 2 3,2 3 4))\n" +"\n" +"SELECT ST_AsEWKT(ST_LocateBetweenElevations(\n" +" ST_GeomFromEWKT('LINESTRING(1 2 6, 4 5 -1, 7 8 " +"9)'),6,9)) As ewelev;\n" +"\n" +" ewelev\n" +"----------------------------------------------------------------\n" +"GEOMETRYCOLLECTION(POINT(1 2 6),LINESTRING(6.1 7.1 6,7 8 9))\n" +"\n" +"--Geometry collections are difficult animals so dump them\n" +"--to make them more digestable\n" +"SELECT ST_AsEWKT((ST_Dump(the_geom)).geom)\n" +" FROM\n" +" (SELECT ST_LocateBetweenElevations(\n" +" ST_GeomFromEWKT('LINESTRING(1 2 6, 4 5 -1, 7 8 " +"9)'),6,9) As the_geom) As foo;\n" +"\n" +" st_asewkt\n" +"--------------------------------\n" +"POINT(1 2 6)\n" +"LINESTRING(6.1 7.1 6,7 8 9)" +msgstr "" + +#. Tag: refname +#: reference_lrs.xml:339 +#, no-c-format +msgid "ST_InterpolatePoint" +msgstr "ST_InterpolatePoint" + +#. Tag: refpurpose +#: reference_lrs.xml:341 +#, no-c-format +msgid "" +"Return the value of the measure dimension of a geometry at the " +"point closed to the provided point." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:346 +#, no-c-format +msgid "" +"float ST_InterpolatePoint " +"geometry line " +"geometry point" +msgstr "" +"float ST_InterpolatePoint " +"geometry line " +"geometry point" + +#. Tag: para +#: reference_lrs.xml:358 +#, no-c-format +msgid "" +"Return the value of the measure dimension of a geometry at the point " +"closed to the provided point." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:360 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "Dostępność: 2.0.0" + +#. Tag: programlisting +#: reference_lrs.xml:368 +#, no-c-format +msgid "" +"SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');\n" +" st_interpolatepoint \n" +" ---------------------\n" +" 10" +msgstr "" +"SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');\n" +" st_interpolatepoint \n" +" ---------------------\n" +" 10" + +#. Tag: para +#: reference_lrs.xml:374 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_lrs.xml:382 +#, no-c-format +msgid "ST_AddMeasure" +msgstr "ST_AddMeasure" + +#. Tag: refpurpose +#: reference_lrs.xml:384 +#, no-c-format +msgid "" +"Return a derived geometry with measure elements linearly " +"interpolated between the start and end points. If the geometry has no " +"measure dimension, one is added. If the geometry has a measure dimension, it " +"is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are " +"supported." +msgstr "" + +#. Tag: funcprototype +#: reference_lrs.xml:389 +#, no-c-format +msgid "" +"geometry ST_AddMeasure " +"geometry geom_mline float measure_start float measure_end" +msgstr "" +"geometry ST_AddMeasure " +"geometry geom_mline float measure_start float measure_end" + +#. Tag: para +#: reference_lrs.xml:402 +#, no-c-format +msgid "" +"Return a derived geometry with measure elements linearly interpolated " +"between the start and end points. If the geometry has no measure dimension, " +"one is added. If the geometry has a measure dimension, it is over-written " +"with new values. Only LINESTRINGS and MULTILINESTRINGS are supported." +msgstr "" + +#. Tag: para +#: reference_lrs.xml:404 +#, no-c-format +msgid "Availability: 1.5.0" +msgstr "Dostępność: 1.5.0" + +#. Tag: programlisting +#: reference_lrs.xml:412 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('LINESTRING(1 0, 2 0, 4 0)'),1,4)) As ewelev;\n" +" ewelev \n" +"--------------------------------\n" +" LINESTRINGM(1 0 1,2 0 2,4 0 4)\n" +"\n" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('LINESTRING(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n" +" ewelev \n" +"----------------------------------------\n" +" LINESTRING(1 0 4 10,2 0 4 20,4 0 4 40)\n" +"\n" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('LINESTRINGM(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n" +" ewelev \n" +"----------------------------------------\n" +" LINESTRINGM(1 0 10,2 0 20,4 0 40)\n" +" \n" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('MULTILINESTRINGM((1 0 4, 2 0 4, 4 0 4),(1 0 4, 2 0 4, 4 0 " +"4))'),10,70)) As ewelev;\n" +" ewelev \n" +"-----------------------------------------------------------------\n" +" MULTILINESTRINGM((1 0 10,2 0 20,4 0 40),(1 0 40,2 0 50,4 0 70))" +msgstr "" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('LINESTRING(1 0, 2 0, 4 0)'),1,4)) As ewelev;\n" +" ewelev \n" +"--------------------------------\n" +" LINESTRINGM(1 0 1,2 0 2,4 0 4)\n" +"\n" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('LINESTRING(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n" +" ewelev \n" +"----------------------------------------\n" +" LINESTRING(1 0 4 10,2 0 4 20,4 0 4 40)\n" +"\n" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('LINESTRINGM(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;\n" +" ewelev \n" +"----------------------------------------\n" +" LINESTRINGM(1 0 10,2 0 20,4 0 40)\n" +" \n" +"SELECT ST_AsText(ST_AddMeasure(\n" +"ST_GeomFromEWKT('MULTILINESTRINGM((1 0 4, 2 0 4, 4 0 4),(1 0 4, 2 0 4, 4 0 " +"4))'),10,70)) As ewelev;\n" +" ewelev \n" +"-----------------------------------------------------------------\n" +" MULTILINESTRINGM((1 0 10,2 0 20,4 0 40),(1 0 40,2 0 50,4 0 70))" diff --git a/doc/po/pl/reference_management.xml.po b/doc/po/pl/reference_management.xml.po new file mode 100644 index 000000000..7126d13b1 --- /dev/null +++ b/doc/po/pl/reference_management.xml.po @@ -0,0 +1,1145 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_management.xml:3 +#, no-c-format +msgid "Management Functions" +msgstr "" + +#. Tag: refname +#: reference_management.xml:7 +#, no-c-format +msgid "AddGeometryColumn" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:9 +#, no-c-format +msgid "" +"Adds a geometry column to an existing table of attributes. By default uses " +"type modifier to define rather than constraints. Pass in false for " +"use_typmod to get old check constraint based behavior" +msgstr "" + +#. Tag: funcsynopsis +#: reference_management.xml:15 +#, no-c-format +msgid "" +" text AddGeometryColumn varchar table_name varchar column_name integer srid varchar type integer dimension boolean " +"use_typmod=true " +" text AddGeometryColumn varchar schema_name varchar table_name varchar column_name integer srid varchar type integer dimension boolean " +"use_typmod=true " +" text AddGeometryColumn varchar catalog_name varchar " +"schema_name varchar table_name varchar column_name integer " +" srid varchar type integer " +"dimension boolean use_typmod=true " +msgstr "" + +#. Tag: title +#: reference_management.xml:92 reference_management.xml:188 +#: reference_management.xml:254 reference_management.xml:298 +#: reference_management.xml:344 reference_management.xml:386 +#: reference_management.xml:427 reference_management.xml:458 +#: reference_management.xml:499 reference_management.xml:540 +#: reference_management.xml:583 reference_management.xml:631 +#: reference_management.xml:677 reference_management.xml:726 +#: reference_management.xml:862 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_management.xml:94 +#, no-c-format +msgid "" +"Adds a geometry column to an existing table of attributes. The " +"schema_name is the name of the table schema. The " +"srid must be an integer value reference to an entry in " +"the SPATIAL_REF_SYS table. The type must be a string " +"corresponding to the geometry type, eg, 'POLYGON' or 'MULTILINESTRING' . An " +"error is thrown if the schemaname doesn't exist (or not visible in the " +"current search_path) or the specified SRID, geometry type, or dimension is " +"invalid." +msgstr "" + +#. Tag: para +#: reference_management.xml:104 +#, no-c-format +msgid "" +"Changed: 2.0.0 This function no longer updates geometry_columns since " +"geometry_columns is a view that reads from system catalogs. It by default " +"also does not create constraints, but instead uses the built in type " +"modifier behavior of PostgreSQL. So for example building a wgs84 POINT " +"column with this function is now equivalent to: ALTER TABLE some_table " +"ADD COLUMN geom geometry(Point,4326);" +msgstr "" + +#. Tag: para +#: reference_management.xml:107 +#, no-c-format +msgid "" +"Changed: 2.0.0 If you require the old behavior of constraints use the " +"default use_typmod, but set it to false." +msgstr "" + +#. Tag: para +#: reference_management.xml:111 +#, no-c-format +msgid "" +"Changed: 2.0.0 Views can no longer be manually registered in " +"geometry_columns, however views built against geometry typmod tables " +"geometries and used without wrapper functions will register themselves " +"correctly because they inherit the typmod behavior of their parent table " +"column. Views that use geometry functions that output other geometries will " +"need to be cast to typmod geometries for these view geometry columns to be " +"registered correctly in geometry_columns. Refer to ." +msgstr "" + +#. Tag: para +#: reference_management.xml:117 reference_management.xml:194 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_management.xml:118 reference_management.xml:195 +#: reference_management.xml:868 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_management.xml:119 reference_management.xml:196 +#: reference_management.xml:869 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_management.xml:120 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 use_typmod argument introduced. Defaults to creating typmod " +"geometry column instead of constraint-based." +msgstr "" + +#. Tag: title +#: reference_management.xml:124 reference_management.xml:203 +#: reference_management.xml:267 reference_management.xml:306 +#: reference_management.xml:351 reference_management.xml:393 +#: reference_management.xml:433 reference_management.xml:464 +#: reference_management.xml:506 reference_management.xml:548 +#: reference_management.xml:600 reference_management.xml:646 +#: reference_management.xml:683 reference_management.xml:784 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:126 +#, no-c-format +msgid "" +"-- Create schema to hold data\n" +"CREATE SCHEMA my_schema;\n" +"-- Create a new simple PostgreSQL table\n" +"CREATE TABLE my_schema.my_spatial_table (id serial);\n" +"\n" +"-- Describing the table shows a simple table with a single \"id\" column.\n" +"postgis=# \\d my_schema.my_spatial_table\n" +" Table \"my_schema." +"my_spatial_table\"\n" +" Column | Type | Modifiers\n" +"--------+---------" +"+-------------------------------------------------------------------------\n" +" id | integer | not null default nextval('my_schema." +"my_spatial_table_id_seq'::regclass)\n" +"\n" +"-- Add a spatial column to the table\n" +"SELECT AddGeometryColumn " +"('my_schema','my_spatial_table','geom',4326,'POINT',2);\n" +"\n" +"-- Add a point using the old constraint based behavior\n" +"SELECT AddGeometryColumn " +"('my_schema','my_spatial_table','geom_c',4326,'POINT',2, false);\n" +"\n" +"--Add a curvepolygon using old constraint behavior\n" +"SELECT AddGeometryColumn " +"('my_schema','my_spatial_table','geomcp_c',4326,'CURVEPOLYGON',2, false);\n" +"\n" +"-- Describe the table again reveals the addition of a new geometry columns.\n" +"\\d my_schema.my_spatial_table\n" +" addgeometrycolumn \n" +"-------------------------------------------------------------------------\n" +" my_schema.my_spatial_table.geomcp_c SRID:4326 TYPE:CURVEPOLYGON DIMS:2 \n" +"(1 row)\n" +"\n" +" Table \"my_schema.my_spatial_table\"\n" +" Column | Type | " +"Modifiers \n" +"----------+----------------------" +"+-------------------------------------------------------------------------\n" +" id | integer | not null default nextval('my_schema." +"my_spatial_table_id_seq'::regclass)\n" +" geom | geometry(Point,4326) | \n" +" geom_c | geometry | \n" +" geomcp_c | geometry | \n" +"Check constraints:\n" +" \"enforce_dims_geom_c\" CHECK (st_ndims(geom_c) = 2)\n" +" \"enforce_dims_geomcp_c\" CHECK (st_ndims(geomcp_c) = 2)\n" +" \"enforce_geotype_geom_c\" CHECK (geometrytype(geom_c) = 'POINT'::text " +"OR geom_c IS NULL)\n" +" \"enforce_geotype_geomcp_c\" CHECK (geometrytype(geomcp_c) = " +"'CURVEPOLYGON'::text OR geomcp_c IS NULL)\n" +" \"enforce_srid_geom_c\" CHECK (st_srid(geom_c) = 4326)\n" +" \"enforce_srid_geomcp_c\" CHECK (st_srid(geomcp_c) = 4326)\n" +" \n" +"-- geometry_columns view also registers the new columns --\n" +"SELECT f_geometry_column As col_name, type, srid, coord_dimension As ndims \n" +" FROM geometry_columns\n" +" WHERE f_table_name = 'my_spatial_table' AND f_table_schema = " +"'my_schema';\n" +"\n" +" col_name | type | srid | ndims \n" +"----------+--------------+------+-------\n" +" geom | Point | 4326 | 2\n" +" geom_c | Point | 4326 | 2\n" +" geomcp_c | CurvePolygon | 4326 | 2" +msgstr "" + +#. Tag: title +#: reference_management.xml:130 reference_management.xml:208 +#: reference_management.xml:272 reference_management.xml:312 +#: reference_management.xml:357 reference_management.xml:399 +#: reference_management.xml:470 reference_management.xml:512 +#: reference_management.xml:554 reference_management.xml:606 +#: reference_management.xml:652 reference_management.xml:689 +#: reference_management.xml:873 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_management.xml:132 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:138 +#, no-c-format +msgid "DropGeometryColumn" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:140 +#, no-c-format +msgid "Removes a geometry column from a spatial table." +msgstr "" + +#. Tag: funcsynopsis +#: reference_management.xml:145 +#, no-c-format +msgid "" +" text DropGeometryColumn varchar table_name varchar column_name text " +"DropGeometryColumn varchar schema_name varchar " +" table_name varchar " +" column_name " +" text DropGeometryColumn varchar catalog_name varchar " +"schema_name varchar table_name varchar column_name " +msgstr "" + +#. Tag: para +#: reference_management.xml:190 +#, no-c-format +msgid "" +"Removes a geometry column from a spatial table. Note that schema_name will " +"need to match the f_table_schema field of the table's row in the " +"geometry_columns table." +msgstr "" + +#. Tag: para +#: reference_management.xml:198 +#, no-c-format +msgid "" +"Changed: 2.0.0 This function is provided for backward compatibility. Now " +"that since geometry_columns is now a view against the system catalogs, you " +"can drop a geometry column like any other table column using ALTER " +"TABLE" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:205 +#, no-c-format +msgid "" +"SELECT DropGeometryColumn ('my_schema','my_spatial_table','geom');\n" +" ----RESULT output ---\n" +" dropgeometrycolumn\n" +"------------------------------------------------------\n" +" my_schema.my_spatial_table.geom effectively removed.\n" +" \n" +"-- In PostGIS 2.0+ the above is also equivalent to the standard\n" +"-- the standard alter table. Both will deregister from geometry_columns\n" +"ALTER TABLE my_schema.my_spatial_table DROP column geom;" +msgstr "" + +#. Tag: para +#: reference_management.xml:210 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:216 +#, no-c-format +msgid "DropGeometryTable" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:218 +#, no-c-format +msgid "Drops a table and all its references in geometry_columns." +msgstr "" + +#. Tag: funcsynopsis +#: reference_management.xml:223 +#, no-c-format +msgid "" +" boolean DropGeometryTable varchar table_name boolean " +"DropGeometryTable varchar schema_name varchar " +" table_name " +" boolean DropGeometryTable varchar catalog_name varchar " +"schema_name varchar table_name " +msgstr "" + +#. Tag: para +#: reference_management.xml:256 +#, no-c-format +msgid "" +"Drops a table and all its references in geometry_columns. Note: uses " +"current_schema() on schema-aware pgsql installations if schema is not " +"provided." +msgstr "" + +#. Tag: para +#: reference_management.xml:261 +#, no-c-format +msgid "" +"Changed: 2.0.0 This function is provided for backward compatibility. Now " +"that since geometry_columns is now a view against the system catalogs, you " +"can drop a table with geometry columns like any other table using DROP " +"TABLE" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:269 +#, no-c-format +msgid "" +"SELECT DropGeometryTable ('my_schema','my_spatial_table');\n" +"----RESULT output ---\n" +"my_schema.my_spatial_table dropped.\n" +" \n" +"-- The above is now equivalent to --\n" +"DROP TABLE my_schema.my_spatial_table;" +msgstr "" + +#. Tag: para +#: reference_management.xml:274 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:281 +#, no-c-format +msgid "PostGIS_Full_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:283 +#, no-c-format +msgid "Reports full postgis version and build configuration infos." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:289 +#, no-c-format +msgid "" +"text PostGIS_Full_Version " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:300 +#, no-c-format +msgid "" +"Reports full postgis version and build configuration infos. Also informs " +"about synchronization between libraries and scripts suggesting upgrades as " +"needed." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:308 +#, no-c-format +msgid "" +"SELECT PostGIS_Full_Version();\n" +" postgis_full_version\n" +"----------------------------------------------------------------------------------\n" +" POSTGIS=\"1.3.3\" GEOS=\"3.1.0-CAPI-1.5.0\" PROJ=\"Rel. 4.4.9, 29 Oct " +"2004\" USE_STATS\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:314 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:327 +#, no-c-format +msgid "PostGIS_GEOS_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:329 +#, no-c-format +msgid "Returns the version number of the GEOS library." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:335 +#, no-c-format +msgid "" +"text PostGIS_GEOS_Version " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:346 +#, no-c-format +msgid "" +"Returns the version number of the GEOS library, or NULL " +"if GEOS support is not enabled." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:353 +#, no-c-format +msgid "" +"SELECT PostGIS_GEOS_Version();\n" +" postgis_geos_version\n" +"----------------------\n" +" 3.1.0-CAPI-1.5.0\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:359 +#, no-c-format +msgid "" +", , , , " +"" +msgstr "" + +#. Tag: refname +#: reference_management.xml:369 +#, no-c-format +msgid "PostGIS_LibXML_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:371 +#, no-c-format +msgid "Returns the version number of the libxml2 library." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:377 +#, no-c-format +msgid "" +"text PostGIS_LibXML_Version " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:388 +#, no-c-format +msgid "Returns the version number of the LibXML2 library." +msgstr "" + +#. Tag: para +#: reference_management.xml:389 +#, no-c-format +msgid "Availability: 1.5" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:395 +#, no-c-format +msgid "" +"SELECT PostGIS_LibXML_Version();\n" +" postgis_libxml_version\n" +"----------------------\n" +" 2.7.6\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:401 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:411 +#, no-c-format +msgid "PostGIS_Lib_Build_Date" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:413 +#, no-c-format +msgid "Returns build date of the PostGIS library." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:418 +#, no-c-format +msgid "" +"text PostGIS_Lib_Build_Date " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:429 +#, no-c-format +msgid "Returns build date of the PostGIS library." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:435 +#, no-c-format +msgid "" +"SELECT PostGIS_Lib_Build_Date();\n" +" postgis_lib_build_date\n" +"------------------------\n" +" 2008-06-21 17:53:21\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_management.xml:441 +#, no-c-format +msgid "PostGIS_Lib_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:443 +#, no-c-format +msgid "" +"Returns the version number of the PostGIS library." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:449 +#, no-c-format +msgid "" +"text PostGIS_Lib_Version " +msgstr "" + +#. Tag: para +#: reference_management.xml:460 +#, no-c-format +msgid "Returns the version number of the PostGIS library." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:466 +#, no-c-format +msgid "" +"SELECT PostGIS_Lib_Version();\n" +" postgis_lib_version\n" +"---------------------\n" +" 1.3.3\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:472 +#, no-c-format +msgid "" +", , , , " +"" +msgstr "" + +#. Tag: refname +#: reference_management.xml:482 +#, no-c-format +msgid "PostGIS_PROJ_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:484 +#, no-c-format +msgid "Returns the version number of the PROJ4 library." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:490 +#, no-c-format +msgid "" +"text PostGIS_PROJ_Version " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:501 +#, no-c-format +msgid "" +"Returns the version number of the PROJ4 library, or NULL " +"if PROJ4 support is not enabled." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:508 +#, no-c-format +msgid "" +"SELECT PostGIS_PROJ_Version();\n" +" postgis_proj_version\n" +"-------------------------\n" +" Rel. 4.4.9, 29 Oct 2004\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:514 reference_management.xml:556 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:524 +#, no-c-format +msgid "PostGIS_Scripts_Build_Date" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:526 +#, no-c-format +msgid "Returns build date of the PostGIS scripts." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:531 +#, no-c-format +msgid "" +"text PostGIS_Scripts_Build_Date " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:542 +#, no-c-format +msgid "Returns build date of the PostGIS scripts." +msgstr "" + +#. Tag: para +#: reference_management.xml:544 +#, no-c-format +msgid "Availability: 1.0.0RC1" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:550 +#, no-c-format +msgid "" +"SELECT PostGIS_Scripts_Build_Date();\n" +" postgis_scripts_build_date\n" +"-------------------------\n" +" 2007-08-18 09:09:26\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_management.xml:566 +#, no-c-format +msgid "PostGIS_Scripts_Installed" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:568 +#, no-c-format +msgid "" +"Returns version of the postgis scripts installed in this " +"database." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:574 +#, no-c-format +msgid "" +"text PostGIS_Scripts_Installed " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:585 +#, no-c-format +msgid "" +"Returns version of the postgis scripts installed in this database." +msgstr "" + +#. Tag: para +#: reference_management.xml:589 +#, no-c-format +msgid "" +"If the output of this function doesn't match the output of you probably missed to properly upgrade an " +"existing database. See the Upgrading " +"section for more info." +msgstr "" + +#. Tag: para +#: reference_management.xml:596 reference_management.xml:642 +#, no-c-format +msgid "Availability: 0.9.0" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:602 +#, no-c-format +msgid "" +"SELECT PostGIS_Scripts_Installed();\n" +" postgis_scripts_installed\n" +"-------------------------\n" +" 1.5.0SVN\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:608 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:614 +#, no-c-format +msgid "PostGIS_Scripts_Released" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:616 +#, no-c-format +msgid "" +"Returns the version number of the postgis.sql script released " +"with the installed postgis lib." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:622 +#, no-c-format +msgid "" +"text PostGIS_Scripts_Released " +"" +msgstr "" + +#. Tag: para +#: reference_management.xml:633 +#, no-c-format +msgid "" +"Returns the version number of the postgis.sql script released with the " +"installed postgis lib." +msgstr "" + +#. Tag: para +#: reference_management.xml:637 +#, no-c-format +msgid "" +"Starting with version 1.1.0 this function returns the same value of . Kept for backward compatibility." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:648 +#, no-c-format +msgid "" +"SELECT PostGIS_Scripts_Released();\n" +" postgis_scripts_released\n" +"-------------------------\n" +" 1.3.4SVN\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:654 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:660 +#, no-c-format +msgid "PostGIS_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:662 +#, no-c-format +msgid "" +"Returns PostGIS version number and compile-time options." +msgstr "" + +#. Tag: funcprototype +#: reference_management.xml:668 +#, no-c-format +msgid "" +"text PostGIS_Version " +msgstr "" + +#. Tag: para +#: reference_management.xml:679 +#, no-c-format +msgid "Returns PostGIS version number and compile-time options." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:685 +#, no-c-format +msgid "" +"SELECT PostGIS_Version();\n" +" postgis_version\n" +"---------------------------------------\n" +" 1.3 USE_GEOS=1 USE_PROJ=1 USE_STATS=1\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_management.xml:691 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_management.xml:701 +#, no-c-format +msgid "Populate_Geometry_Columns" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:703 +#, no-c-format +msgid "" +"Ensures geometry columns are defined with type modifiers or have appropriate " +"spatial constraints This ensures they will be registered correctly in " +"geometry_columns view. By default will convert all " +"geometry columns with no type modifier to ones with type modifiers. To get " +"old behavior set use_typmod=false" +msgstr "" + +#. Tag: funcsynopsis +#: reference_management.xml:709 +#, no-c-format +msgid "" +" text Populate_Geometry_Columns boolean " +"use_typmod=true " +" int Populate_Geometry_Columns oid relation_oid boolean use_typmod=true " +msgstr "" + +#. Tag: para +#: reference_management.xml:728 +#, no-c-format +msgid "" +"Ensures geometry columns have appropriate type modifiers or spatial " +"constraints to ensure they are registered correctly in " +"geometry_columns table." +msgstr "" + +#. Tag: para +#: reference_management.xml:730 +#, no-c-format +msgid "" +"For backwards compatibility and for spatial needs such as tble inheritance " +"where each child table may have different geometry type, the old check " +"constraint behavior is still supported. If you need the old behavior, you " +"need to pass in the new optional argument as false " +"use_typmod=false. When this is done geometry columns will " +"be created with no type modifiers but will have 3 constraints defined. In " +"particular, this means that every geometry column belonging to a table has " +"at least three constraints:" +msgstr "" + +#. Tag: para +#: reference_management.xml:738 +#, no-c-format +msgid "" +"enforce_dims_the_geom - ensures every geometry has the " +"same dimension (see )" +msgstr "" + +#. Tag: para +#: reference_management.xml:744 +#, no-c-format +msgid "" +"enforce_geotype_the_geom - ensures every geometry is of " +"the same type (see )" +msgstr "" + +#. Tag: para +#: reference_management.xml:750 +#, no-c-format +msgid "" +"enforce_srid_the_geom - ensures every geometry is in the " +"same projection (see )" +msgstr "" + +#. Tag: para +#: reference_management.xml:756 +#, no-c-format +msgid "" +"If a table oid is provided, this function tries to " +"determine the srid, dimension, and geometry type of all geometry columns in " +"the table, adding constraints as necessary. If successful, an appropriate " +"row is inserted into the geometry_columns table, otherwise, the exception is " +"caught and an error notice is raised describing the problem." +msgstr "" + +#. Tag: para +#: reference_management.xml:763 +#, no-c-format +msgid "" +"If the oid of a view is provided, as with a table oid, " +"this function tries to determine the srid, dimension, and type of all the " +"geometries in the view, inserting appropriate entries into the " +"geometry_columns table, but nothing is done to enforce " +"constraints." +msgstr "" + +#. Tag: para +#: reference_management.xml:769 +#, no-c-format +msgid "" +"The parameterless variant is a simple wrapper for the parameterized variant " +"that first truncates and repopulates the geometry_columns table for every " +"spatial table and view in the database, adding spatial constraints to tables " +"where appropriate. It returns a summary of the number of geometry columns " +"detected in the database and the number that were inserted into the " +"geometry_columns table. The parameterized version simply " +"returns the number of rows inserted into the geometry_columns table." +msgstr "" + +#. Tag: para +#: reference_management.xml:777 +#, no-c-format +msgid "Availability: 1.4.0" +msgstr "" + +#. Tag: para +#: reference_management.xml:778 +#, no-c-format +msgid "" +"Changed: 2.0.0 By default, now uses type modifiers instead of check " +"constraints to constrain geometry types. You can still use check constraint " +"behavior instead by using the new use_typmod and setting " +"it to false." +msgstr "" + +#. Tag: para +#: reference_management.xml:780 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 use_typmod optional argument was " +"introduced that allows controlling if columns are created with typmodifiers " +"or with check constraints." +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:786 +#, no-c-format +msgid "" +"CREATE TABLE public.myspatial_table(gid serial, geom geometry);\n" +"INSERT INTO myspatial_table(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, 3 " +"4)',4326) );\n" +"-- This will now use typ modifiers. For this to work, there must exist " +"data\n" +"SELECT Populate_Geometry_Columns('public.myspatial_table'::regclass);\n" +"\n" +"populate_geometry_columns\n" +"--------------------------\n" +" 1\n" +" \n" +" \n" +"\\d myspatial_table\n" +"\n" +" Table \"public.myspatial_table\"\n" +" Column | Type | " +"Modifiers \n" +"--------+---------------------------" +"+---------------------------------------------------------------\n" +" gid | integer | not null default " +"nextval('myspatial_table_gid_seq'::regclass)\n" +" geom | geometry(LineString,4326) |" +msgstr "" + +#. Tag: programlisting +#: reference_management.xml:788 +#, no-c-format +msgid "" +"-- This will change the geometry columns to use constraints if they are not " +"typmod or have constraints already. \n" +"--For this to work, there must exist data\n" +"CREATE TABLE public.myspatial_table_cs(gid serial, geom geometry);\n" +"INSERT INTO myspatial_table_cs(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, " +"3 4)',4326) );\n" +"SELECT Populate_Geometry_Columns('public.myspatial_table_cs'::regclass, " +"false);\n" +"populate_geometry_columns\n" +"--------------------------\n" +" 1\n" +"\\d myspatial_table_cs\n" +"\n" +" Table \"public.myspatial_table_cs\"\n" +" Column | Type | " +"Modifiers \n" +"--------+----------" +"+------------------------------------------------------------------\n" +" gid | integer | not null default nextval('myspatial_table_cs_gid_seq'::" +"regclass)\n" +" geom | geometry | \n" +"Check constraints:\n" +" \"enforce_dims_geom\" CHECK (st_ndims(geom) = 2)\n" +" \"enforce_geotype_geom\" CHECK (geometrytype(geom) = 'LINESTRING'::text " +"OR geom IS NULL)\n" +" \"enforce_srid_geom\" CHECK (st_srid(geom) = 4326)" +msgstr "" + +#. Tag: refname +#: reference_management.xml:803 +#, no-c-format +msgid "UpdateGeometrySRID" +msgstr "" + +#. Tag: refpurpose +#: reference_management.xml:805 +#, no-c-format +msgid "" +"Updates the SRID of all features in a geometry column, geometry_columns " +"metadata and srid table constraint" +msgstr "" + +#. Tag: funcsynopsis +#: reference_management.xml:810 +#, no-c-format +msgid "" +" text UpdateGeometrySRID varchar table_name varchar column_name integer srid text " +"UpdateGeometrySRID varchar schema_name varchar " +" table_name varchar " +" column_name " +"integer srid text UpdateGeometrySRID varchar catalog_name varchar " +"schema_name varchar table_name varchar column_name integer " +" srid " +msgstr "" + +#. Tag: para +#: reference_management.xml:864 +#, no-c-format +msgid "" +"Updates the SRID of all features in a geometry column, updating constraints " +"and reference in geometry_columns. Note: uses current_schema() on schema-" +"aware pgsql installations if schema is not provided." +msgstr "" diff --git a/doc/po/pl/reference_measure.xml.po b/doc/po/pl/reference_measure.xml.po new file mode 100644 index 000000000..87c8393b2 --- /dev/null +++ b/doc/po/pl/reference_measure.xml.po @@ -0,0 +1,4945 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-10-11 21:39+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_measure.xml:3 +#, no-c-format +msgid "Spatial Relationships and Measurements" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:6 +#, no-c-format +msgid "ST_3DClosestPoint" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:8 +#, no-c-format +msgid "" +"Returns the 3-dimensional point on g1 that is closest to g2. This is the " +"first point of the 3D shortest line." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:14 +#, no-c-format +msgid "" +"geometry ST_3DClosestPoint " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: title +#: reference_measure.xml:27 reference_measure.xml:92 reference_measure.xml:143 +#: reference_measure.xml:195 reference_measure.xml:252 +#: reference_measure.xml:302 reference_measure.xml:371 +#: reference_measure.xml:417 reference_measure.xml:489 +#: reference_measure.xml:547 reference_measure.xml:621 +#: reference_measure.xml:739 reference_measure.xml:812 +#: reference_measure.xml:964 reference_measure.xml:1045 +#: reference_measure.xml:1127 reference_measure.xml:1187 +#: reference_measure.xml:1353 reference_measure.xml:1488 +#: reference_measure.xml:1566 reference_measure.xml:1627 +#: reference_measure.xml:1679 reference_measure.xml:1726 +#: reference_measure.xml:1775 reference_measure.xml:1828 +#: reference_measure.xml:1910 reference_measure.xml:1973 +#: reference_measure.xml:2022 reference_measure.xml:2082 +#: reference_measure.xml:2145 reference_measure.xml:2195 +#: reference_measure.xml:2228 reference_measure.xml:2273 +#: reference_measure.xml:2325 reference_measure.xml:2376 +#: reference_measure.xml:2428 reference_measure.xml:2516 +#: reference_measure.xml:2559 reference_measure.xml:2651 +#: reference_measure.xml:2700 reference_measure.xml:2737 +#: reference_measure.xml:2779 reference_measure.xml:2826 +#: reference_measure.xml:2884 reference_measure.xml:2950 +#: reference_measure.xml:2993 reference_measure.xml:3072 +#: reference_measure.xml:3220 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_measure.xml:29 +#, no-c-format +msgid "" +"Returns the 3-dimensional point on g1 that is closest to g2. This is the " +"first point of the 3D shortest line. The 3D length of the 3D shortest line " +"is the 3D distance." +msgstr "" + +#. Tag: para +#: reference_measure.xml:32 reference_measure.xml:97 reference_measure.xml:148 +#: reference_measure.xml:210 reference_measure.xml:265 +#: reference_measure.xml:311 reference_measure.xml:376 +#: reference_measure.xml:430 reference_measure.xml:2027 +#: reference_measure.xml:2232 reference_measure.xml:2287 +#: reference_measure.xml:2384 reference_measure.xml:2741 +#: reference_measure.xml:2787 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_measure.xml:34 reference_measure.xml:99 reference_measure.xml:150 +#: reference_measure.xml:212 reference_measure.xml:267 +#: reference_measure.xml:313 reference_measure.xml:378 +#: reference_measure.xml:432 reference_measure.xml:499 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_measure.xml:35 reference_measure.xml:102 +#: reference_measure.xml:153 reference_measure.xml:209 +#: reference_measure.xml:259 reference_measure.xml:310 +#: reference_measure.xml:380 reference_measure.xml:429 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: title +#: reference_measure.xml:39 reference_measure.xml:106 +#: reference_measure.xml:157 reference_measure.xml:217 +#: reference_measure.xml:317 reference_measure.xml:384 +#: reference_measure.xml:436 reference_measure.xml:505 +#: reference_measure.xml:563 reference_measure.xml:647 +#: reference_measure.xml:749 reference_measure.xml:850 +#: reference_measure.xml:1003 reference_measure.xml:1081 +#: reference_measure.xml:1156 reference_measure.xml:1253 +#: reference_measure.xml:1388 reference_measure.xml:1511 +#: reference_measure.xml:1580 reference_measure.xml:1652 +#: reference_measure.xml:1693 reference_measure.xml:1741 +#: reference_measure.xml:1789 reference_measure.xml:1846 +#: reference_measure.xml:1943 reference_measure.xml:1992 +#: reference_measure.xml:2033 reference_measure.xml:2238 +#: reference_measure.xml:2292 reference_measure.xml:2344 +#: reference_measure.xml:2390 reference_measure.xml:2438 +#: reference_measure.xml:2531 reference_measure.xml:2581 +#: reference_measure.xml:2747 reference_measure.xml:2791 +#: reference_measure.xml:2836 reference_measure.xml:2920 +#: reference_measure.xml:2960 reference_measure.xml:3009 +#: reference_measure.xml:3122 reference_measure.xml:3252 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: para +#: reference_measure.xml:44 +#, no-c-format +msgid "linestring and point -- both 3d and 2d closest point" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:45 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt, \n" +" ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt\n" +" FROM (SELECT 'POINT(100 100 30)'::geometry As pt, \n" +" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 " +"1000)'::geometry As line\n" +" ) As foo;\n" +" \n" +" \n" +" cp3d_line_pt " +"| cp2d_line_pt\n" +"-----------------------------------------------------------" +"+------------------------------------------\n" +" POINT(54.6993798867619 128.935022917228 11.5475869506606) | " +"POINT(73.0769230769231 115.384615384615)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:49 +#, no-c-format +msgid "linestring and multipoint -- both 3d and 2d closest point" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:50 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt, \n" +" ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt\n" +" FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt, \n" +" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 " +"900)'::geometry As line\n" +" ) As foo;\n" +" \n" +" \n" +" cp3d_line_pt | cp2d_line_pt\n" +"-----------------------------------------------------------+--------------\n" +" POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(50 75)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:54 +#, no-c-format +msgid "Multilinestring and polygon both 3d and 2d closest point" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:55 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DClosestPoint(poly, mline)) As cp3d,\n" +" ST_AsEWKT(ST_ClosestPoint(poly, mline)) As cp2d \n" +" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, " +"50 60 5, 100 100 5, 175 150 5))') As poly,\n" +" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 " +"-2, 125 100 1, 175 155 1),\n" +" (1 10 2, 5 20 1))') As mline ) As foo;\n" +" cp3d | cp2d\n" +"-------------------------------------------+--------------\n" +" POINT(39.993580415989 54.1889925532825 5) | POINT(20 40)" +msgstr "" + +#. Tag: title +#: reference_measure.xml:65 reference_measure.xml:113 +#: reference_measure.xml:163 reference_measure.xml:222 +#: reference_measure.xml:275 reference_measure.xml:343 +#: reference_measure.xml:390 reference_measure.xml:462 +#: reference_measure.xml:521 reference_measure.xml:596 +#: reference_measure.xml:710 reference_measure.xml:784 +#: reference_measure.xml:937 reference_measure.xml:1008 +#: reference_measure.xml:1089 reference_measure.xml:1161 +#: reference_measure.xml:1458 reference_measure.xml:1517 +#: reference_measure.xml:1586 reference_measure.xml:1700 +#: reference_measure.xml:1748 reference_measure.xml:1796 +#: reference_measure.xml:1851 reference_measure.xml:1948 +#: reference_measure.xml:1998 reference_measure.xml:2040 +#: reference_measure.xml:2121 reference_measure.xml:2172 +#: reference_measure.xml:2204 reference_measure.xml:2247 +#: reference_measure.xml:2299 reference_measure.xml:2351 +#: reference_measure.xml:2397 reference_measure.xml:2491 +#: reference_measure.xml:2536 reference_measure.xml:2623 +#: reference_measure.xml:2677 reference_measure.xml:2713 +#: reference_measure.xml:2754 reference_measure.xml:2797 +#: reference_measure.xml:2842 reference_measure.xml:2926 +#: reference_measure.xml:2966 reference_measure.xml:3043 +#: reference_measure.xml:3263 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_measure.xml:67 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:72 +#, no-c-format +msgid "ST_3DDistance" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:74 +#, no-c-format +msgid "" +"For geometry type Returns the 3-dimensional cartesian minimum distance " +"(based on spatial ref) between two geometries in projected units." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:79 +#, no-c-format +msgid "" +"float ST_3DDistance " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:94 +#, no-c-format +msgid "" +"For geometry type returns the 3-dimensional minimum cartesian distance " +"between two geometries in projected units (spatial ref units)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:100 reference_measure.xml:151 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM ?" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:108 +#, no-c-format +msgid "" +"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal " +"area) (3D point and line compared 2D point and line)\n" +"-- Note: currently no vertical datum support so Z is not transformed and " +"assumed to be same units as final.\n" +"SELECT ST_3DDistance(\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"POINT(-72.1235 42.3521 4)'),2163),\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)\n" +" ) As dist_3d,\n" +" ST_Distance(\n" +" ST_Transform(ST_GeomFromText('POINT(-72.1235 " +"42.3521)',4326),2163),\n" +" ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 " +"42.45, -72.123 42.1546)', 4326),2163)\n" +" ) As dist_2d;\n" +"\n" +" dist_3d | dist_2d\n" +"------------------+-----------------\n" +" 127.295059324629 | 126.66425605671" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:109 +#, no-c-format +msgid "" +"-- Multilinestring and polygon both 3d and 2d distance\n" +"-- Same example as 3D closest point example\n" +"SELECT ST_3DDistance(poly, mline) As dist3d,\n" +" ST_Distance(poly, mline) As dist2d \n" +" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, " +"50 60 5, 100 100 5, 175 150 5))') As poly,\n" +" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 " +"-2, 125 100 1, 175 155 1),\n" +" (1 10 2, 5 20 1))') As mline ) As foo;\n" +" dist3d | dist2d\n" +"-------------------+--------\n" +" 0.716635696066337 | 0" +msgstr "" + +#. Tag: para +#: reference_measure.xml:115 +#, no-c-format +msgid "" +", , , " +", , " +"" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:121 +#, no-c-format +msgid "ST_3DDWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:123 +#, no-c-format +msgid "" +"For 3d (z) geometry type Returns true if two geometries 3d distance is " +"within number of units." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:127 +#, no-c-format +msgid "" +"boolean ST_3DDWithin " +"geometry g1 " +"geometry g2 " +"double precision distance_of_srid" +msgstr "" + +#. Tag: para +#: reference_measure.xml:145 +#, no-c-format +msgid "" +"For geometry type returns true if the 3d distance between two objects is " +"within distance_of_srid specified projected units (spatial ref units)." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:159 +#, no-c-format +msgid "" +"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal " +"area) (3D point and line compared 2D point and line)\n" +"-- Note: currently no vertical datum support so Z is not transformed and " +"assumed to be same units as final.\n" +"SELECT ST_3DDWithin(\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"POINT(-72.1235 42.3521 4)'),2163),\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163),\n" +" 126.8\n" +" ) As within_dist_3d,\n" +"ST_DWithin(\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"POINT(-72.1235 42.3521 4)'),2163),\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163),\n" +" 126.8\n" +" ) As within_dist_2d;\n" +"\n" +" within_dist_3d | within_dist_2d\n" +"----------------+----------------\n" +" f | t" +msgstr "" + +#. Tag: para +#: reference_measure.xml:165 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:171 +#, no-c-format +msgid "ST_3DDFullyWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:173 +#, no-c-format +msgid "" +"Returns true if all of the 3D geometries are within the specified distance " +"of one another." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:179 +#, no-c-format +msgid "" +"boolean ST_3DDFullyWithin " +"geometry g1 " +"geometry g2 " +"double precision distance" +msgstr "" + +#. Tag: para +#: reference_measure.xml:197 +#, no-c-format +msgid "" +"Returns true if the 3D geometries are fully within the specified distance of " +"one another. The distance is specified in units defined by the spatial " +"reference system of the geometries. For this function to make sense, the " +"source geometries must both be of the same coordinate projection, having the " +"same SRID." +msgstr "" + +#. Tag: para +#: reference_measure.xml:204 reference_measure.xml:261 +#: reference_measure.xml:1243 reference_measure.xml:1837 +#: reference_measure.xml:1923 reference_measure.xml:2095 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:218 +#, no-c-format +msgid "" +"-- This compares the difference between fully within and distance within as " +"well\n" +" -- as the distance fully within for the 2D footprint of the " +"line/point vs. the 3d fully within\n" +" SELECT ST_3DDFullyWithin(geom_a, geom_b, 10) as " +"D3DFullyWithin10, ST_3DDWithin(geom_a, geom_b, 10) as D3DWithin10, \n" +" ST_DFullyWithin(geom_a, geom_b, 20) as D2DFullyWithin20, \n" +" ST_3DDFullyWithin(geom_a, geom_b, 20) as D3DFullyWithin20 from \n" +" (select ST_GeomFromEWKT('POINT(1 1 2)') as geom_a,\n" +" ST_GeomFromEWKT('LINESTRING(1 5 2, 2 7 20, 1 9 100, 14 12 " +"3)') as geom_b) t1;\n" +" d3dfullywithin10 | d3dwithin10 | d2dfullywithin20 | d3dfullywithin20\n" +"------------------+-------------+------------------+------------------\n" +" f | t | t | f" +msgstr "" + +#. Tag: para +#: reference_measure.xml:224 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:230 +#, no-c-format +msgid "ST_3DIntersects" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:232 +#, no-c-format +msgid "" +"Returns TRUE if the Geometries \"spatially intersect\" in 3d - only for " +"points and linestrings" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:238 +#, no-c-format +msgid "" +"boolean ST_3DIntersects " +"geometry geomA " +"geometry geomB " +msgstr "" + +#. Tag: para +#: reference_measure.xml:253 reference_measure.xml:2083 +#, no-c-format +msgid "" +"Overlaps, Touches, Within all imply spatial intersection. If any of the " +"aforementioned returns true, then the geometries also spatially intersect. " +"Disjoint implies false for spatial intersection." +msgstr "" + +#. Tag: para +#: reference_measure.xml:268 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: ?" +msgstr "" + +#. Tag: title +#: reference_measure.xml:271 reference_measure.xml:2113 +#: reference_measure.xml:2161 +#, no-c-format +msgid "Geometry Examples" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:272 +#, no-c-format +msgid "" +"SELECT ST_3DIntersects(pt, line), ST_Intersects(pt,line) \n" +" FROM (SELECT 'POINT(0 0 2)'::geometry As pt, \n" +" 'LINESTRING (0 0 1, 0 2 3 )'::geometry As line) As foo;\n" +" st_3dintersects | st_intersects\n" +"-----------------+---------------\n" +" f | t\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:282 +#, no-c-format +msgid "ST_3DLongestLine" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:284 +#, no-c-format +msgid "Returns the 3-dimensional longest line between two geometries" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:289 +#, no-c-format +msgid "" +"geometry ST_3DLongestLine " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:304 +#, no-c-format +msgid "" +"Returns the 3-dimensional longest line between two geometries. The function " +"will only return the first longest line if more than one. The line returned " +"will always start in g1 and end in g2. The 3D length of the line this " +"function returns will always be the same as returns for g1 and g2." +msgstr "" + +#. Tag: para +#: reference_measure.xml:322 +#, no-c-format +msgid "linestring and point -- both 3d and 2d longest line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:323 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt, \n" +" ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt\n" +" FROM (SELECT 'POINT(100 100 30)'::geometry As pt, \n" +" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 " +"1000)'::geometry As line\n" +" ) As foo;\n" +" \n" +" \n" +" lol3d_line_pt | lol2d_line_pt\n" +"-----------------------------------+----------------------------\n" +" LINESTRING(50 75 1000,100 100 30) | LINESTRING(98 190,100 100)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:327 +#, no-c-format +msgid "linestring and multipoint -- both 3d and 2d longest line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:328 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt, \n" +" ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt\n" +" FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt, \n" +" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 " +"900)'::geometry As line\n" +" ) As foo;\n" +" \n" +" \n" +" lol3d_line_pt | lol2d_line_pt\n" +"---------------------------------+--------------------------\n" +" LINESTRING(98 190 1,50 74 1000) | LINESTRING(98 190,50 74)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:332 +#, no-c-format +msgid "Multilinestring and polygon both 3d and 2d longest line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:333 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DLongestLine(poly, mline)) As lol3d,\n" +" ST_AsEWKT(ST_LongestLine(poly, mline)) As lol2d \n" +" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, " +"50 60 5, 100 100 5, 175 150 5))') As poly,\n" +" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 " +"-2, 125 100 1, 175 155 1),\n" +" (1 10 2, 5 20 1))') As mline ) As foo;\n" +" lol3d | lol2d\n" +"------------------------------+--------------------------\n" +" LINESTRING(175 150 5,1 10 2) | LINESTRING(175 150,1 10)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:345 +#, no-c-format +msgid "" +", , , " +", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:351 +#, no-c-format +msgid "ST_3DMaxDistance" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:353 +#, no-c-format +msgid "" +"For geometry type Returns the 3-dimensional cartesian maximum distance " +"(based on spatial ref) between two geometries in projected units." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:358 +#, no-c-format +msgid "" +"float ST_3DMaxDistance " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:373 +#, no-c-format +msgid "" +"For geometry type returns the 3-dimensional maximum cartesian distance " +"between two geometries in projected units (spatial ref units)." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:386 +#, no-c-format +msgid "" +"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal " +"area) (3D point and line compared 2D point and line)\n" +"-- Note: currently no vertical datum support so Z is not transformed and " +"assumed to be same units as final.\n" +"SELECT ST_3DMaxDistance(\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"POINT(-72.1235 42.3521 10000)'),2163),\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)\n" +" ) As dist_3d,\n" +" ST_MaxDistance(\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"POINT(-72.1235 42.3521 10000)'),2163),\n" +" ST_Transform(ST_GeomFromEWKT('SRID=4326;" +"LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)\n" +" ) As dist_2d;\n" +"\n" +" dist_3d | dist_2d\n" +"------------------+------------------\n" +" 24383.7467488441 | 22247.8472107251" +msgstr "" + +#. Tag: para +#: reference_measure.xml:392 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:397 +#, no-c-format +msgid "ST_3DShortestLine" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:399 +#, no-c-format +msgid "Returns the 3-dimensional shortest line between two geometries" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:404 +#, no-c-format +msgid "" +"geometry ST_3DShortestLine " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:419 +#, no-c-format +msgid "" +"Returns the 3-dimensional shortest line between two geometries. The function " +"will only return the first shortest line if more than one, that the function " +"finds. If g1 and g2 intersects in just one point the function will return a " +"line with both start and end in that intersection-point. If g1 and g2 are " +"intersecting with more than one point the function will return a line with " +"start and end in the same point but it can be any of the intersecting " +"points. The line returned will always start in g1 and end in g2. The 3D " +"length of the line this function returns will always be the same as returns for g1 and g2." +msgstr "" + +#. Tag: para +#: reference_measure.xml:441 +#, no-c-format +msgid "linestring and point -- both 3d and 2d shortest line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:442 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt, \n" +" ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt\n" +" FROM (SELECT 'POINT(100 100 30)'::geometry As pt, \n" +" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 " +"1000)'::geometry As line\n" +" ) As foo;\n" +" \n" +" \n" +" shl3d_line_pt " +"| shl2d_line_pt\n" +"----------------------------------------------------------------------------" +"+------------------------------------------------------\n" +" LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) " +"| LINESTRING(73.0769230769231 115.384615384615,100 100)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:446 +#, no-c-format +msgid "linestring and multipoint -- both 3d and 2d shortest line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:447 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt, \n" +" ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt\n" +" FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt, \n" +" 'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 " +"900)'::geometry As line\n" +" ) As foo;\n" +" \n" +" \n" +" shl3d_line_pt | " +"shl2d_line_pt\n" +"---------------------------------------------------------------------------" +"+------------------------\n" +" LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) | " +"LINESTRING(50 75,50 74)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:451 +#, no-c-format +msgid "Multilinestring and polygon both 3d and 2d shortest line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:452 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_3DShortestLine(poly, mline)) As shl3d,\n" +" ST_AsEWKT(ST_ShortestLine(poly, mline)) As shl2d \n" +" FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, " +"50 60 5, 100 100 5, 175 150 5))') As poly,\n" +" ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 " +"-2, 125 100 1, 175 155 1),\n" +" (1 10 2, 5 20 1))') As mline ) As foo;\n" +" shl3d " +"| shl2d\n" +"---------------------------------------------------------------------------------------------------" +"+------------------------\n" +" LINESTRING(39.993580415989 54.1889925532825 5,40.4078575708294 " +"53.6052383805529 5.03423778139177) | LINESTRING(20 40,20 40)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:464 +#, no-c-format +msgid "" +", , , " +", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:469 +#, no-c-format +msgid "ST_Area" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:471 +#, no-c-format +msgid "" +"Returns the area of the surface if it is a polygon or multi-polygon. For " +"\"geometry\" type area is in SRID units. For \"geography\" area is in square " +"meters." +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:475 +#, no-c-format +msgid "" +" float ST_Area " +"geometry g1 float ST_Area geography geog boolean use_spheroid=true " +msgstr "" + +#. Tag: para +#: reference_measure.xml:491 +#, no-c-format +msgid "" +"Returns the area of the geometry if it is a polygon or multi-polygon. Return " +"the area measurement of an ST_Surface or ST_MultiSurface value. For geometry " +"Area is in the units of the srid. For geography area is in square meters and " +"defaults to measuring about the spheroid of the geography (currently only " +"WGS84). To measure around the faster but less accurate sphere -- " +"ST_Area(geog,false)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:496 +#, no-c-format +msgid "Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced." +msgstr "" + +#. Tag: para +#: reference_measure.xml:497 reference_measure.xml:642 +#: reference_measure.xml:1572 reference_measure.xml:1937 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_measure.xml:498 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.1.2, 9.5.3" +msgstr "" + +#. Tag: para +#: reference_measure.xml:500 +#, no-c-format +msgid "" +"For polyhedral surfaces, only supports 2D polyhedral surfaces (not 2.5D). " +"For 2.5D, may give a non-zero answer, but only for the faces that sit " +"completely in XY plane." +msgstr "" + +#. Tag: para +#: reference_measure.xml:506 +#, no-c-format +msgid "" +"Return area in square feet for a plot of Massachusetts land and multiply by " +"conversion to get square meters. Note this is in square feet because 2249 is " +"Mass State Plane Feet" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:509 +#, no-c-format +msgid "" +"SELECT ST_Area(the_geom) As sqft, ST_Area(the_geom)*POWER(0.3048,2) As sqm\n" +" FROM (SELECT\n" +" ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,\n" +" 743265 2967450,743265.625 2967416,743238 " +"2967416))',2249) ) As foo(the_geom);\n" +" sqft | sqm\n" +"---------+-------------\n" +" 928.625 | 86.27208552" +msgstr "" + +#. Tag: para +#: reference_measure.xml:510 +#, no-c-format +msgid "" +"Return area square feet and transform to Massachusetts state plane meters " +"(26986) to get square meters. Note this is in square feet because 2249 is " +"Mass State Plane Feet and transformed area is in square meters since 26986 " +"is state plane mass meters" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:513 +#, no-c-format +msgid "" +"SELECT ST_Area(the_geom) As sqft, ST_Area(ST_Transform(the_geom,26986)) As " +"sqm\n" +" FROM (SELECT\n" +" ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,\n" +" 743265 2967450,743265.625 2967416,743238 " +"2967416))',2249) ) As foo(the_geom);\n" +" sqft | sqm\n" +"---------+------------------\n" +" 928.625 | 86.2724304199219" +msgstr "" + +#. Tag: para +#: reference_measure.xml:515 +#, no-c-format +msgid "" +"Return area square feet and square meters using Geography data type. Note " +"that we transform to our geometry to geography (before you can do that make " +"sure your geometry is in WGS 84 long lat 4326). Geography always measures in " +"meters. This is just for demonstration to compare. Normally your table will " +"be stored in geography data type already." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:518 +#, no-c-format +msgid "" +"SELECT ST_Area(the_geog)/POWER(0.3048,2) As sqft_spheroid, ST_Area(the_geog," +"false)/POWER(0.3048,2) As sqft_sphere, ST_Area(the_geog) As sqm_spheroid\n" +" FROM (SELECT\n" +" geography(\n" +" ST_Transform(\n" +" ST_GeomFromText('POLYGON((743238 2967416,743238 " +"2967450,743265 2967450,743265.625 2967416,743238 2967416))',\n" +" 2249\n" +" ) ,4326\n" +" )\n" +" )\n" +" ) As foo(the_geog);\n" +" sqft_spheroid | sqft_sphere | sqm_spheroid\n" +"-----------------+------------------+------------------\n" +"928.684405217197 | 927.186481558724 | 86.2776044452694\n" +"\n" +" --if your data is in geography already\n" +" SELECT ST_Area(the_geog)/POWER(0.3048,2) As sqft, ST_Area(the_geog) As " +"sqm\n" +" FROM somegeogtable;" +msgstr "" + +#. Tag: para +#: reference_measure.xml:522 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:528 +#, no-c-format +msgid "ST_Azimuth" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:530 +#, no-c-format +msgid "" +"Returns the angle in radians from the horizontal of the vector defined by " +"pointA and pointB. Angle is computed clockwise from down-to-up: on the " +"clock: 12=0; 3=PI/2; 6=PI; 9=3PI/2." +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:533 +#, no-c-format +msgid "" +" float ST_Azimuth " +"geometry pointA " +"geometry pointB float ST_Azimuth geography pointA geography pointB " +msgstr "" + +#. Tag: para +#: reference_measure.xml:549 +#, no-c-format +msgid "" +"Returns the azimuth of the segment defined by the given Point geometries, or " +"NULL if the two points are coincident. Return value is in radians. Angle is " +"computed clockwise from down-to-up: on the clock: 12=0; 3=PI/2; 6=PI; 9=3PI/2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:553 +#, no-c-format +msgid "" +"The Azimuth is mathematical concept defined as the angle, in this case " +"measured in radian, between a reference plane and a point." +msgstr "" + +#. Tag: para +#: reference_measure.xml:556 +#, no-c-format +msgid "Availability: 1.1.0" +msgstr "" + +#. Tag: para +#: reference_measure.xml:557 +#, no-c-format +msgid "Enhanced: 2.0.0 support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_measure.xml:558 +#, no-c-format +msgid "" +"Azimuth is especially useful in conjunction with ST_Translate for shifting " +"an object along its perpendicular axis. See upgis_lineshift Plpgsqlfunctions PostGIS wiki section for example of this." +msgstr "" + +#. Tag: para +#: reference_measure.xml:564 +#, no-c-format +msgid "Geometry Azimuth in degrees" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:565 +#, no-c-format +msgid "" +"SELECT ST_Azimuth(ST_Point(25,45), ST_Point(75,100))/(2*pi())*360 as degAz,\n" +" ST_Azimuth(ST_Point(75,100), ST_Point(25,45))/(2*pi())*360 As " +"degAzrev;\n" +" \n" +"-- NOTE easier to remember syntax using PostgreSQL built-in degrees function " +"--\n" +"-- Both yield same answer --\n" +"SELECT degrees( ST_Azimuth(ST_Point(25,45), ST_Point(75,100)) ) as degAz,\n" +" degrees( ST_Azimuth(ST_Point(75,100), ST_Point(25,45)) ) As " +"degAzrev;\n" +"\n" +" degaz | degazrev\n" +"------------------+------------------\n" +" 42.2736890060937 | 222.273689006094" +msgstr "" + +#. Tag: para +#: reference_measure.xml:575 +#, no-c-format +msgid "" +"degAz is path to travel (azimuth), horizontal line (which starts at the " +"start point and ends where we want the end point to fall) and points (start " +"point: 25,45 is in green)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:585 +#, no-c-format +msgid "" +"degAzrev is azimuth curve shown, horizontal line (which starts at the start " +"point and ends where we want the end point to fall) and points (start point: " +"75,100 is in green)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:597 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:604 +#, no-c-format +msgid "ST_Centroid" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:606 +#, no-c-format +msgid "Returns the geometric center of a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:611 +#, no-c-format +msgid "" +"geometry ST_Centroid " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_measure.xml:623 +#, no-c-format +msgid "" +"Computes the geometric center of a geometry, or equivalently, the center of " +"mass of the geometry as a POINT. For [MULTI]POINTs, this is computed as the arithmetric mean " +"of the input coordinates. For [MULTI]LINESTRINGs, this is computed as the weighted length of each line segment. For " +"[MULTI]POLYGONs, \"weight\" is thought " +"in terms of area. If an empty geometry is supplied, an empty " +"GEOMETRYCOLLECTION is returned. If NULL is supplied, NULL is returned." +msgstr "" + +#. Tag: para +#: reference_measure.xml:635 +#, no-c-format +msgid "" +"The centroid is equal to the centroid of the set of component Geometries of " +"highest dimension (since the lower-dimension geometries contribute zero " +"\"weight\" to the centroid)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:639 +#, no-c-format +msgid "" +"Computation will be more accurate if performed by the GEOS module (enabled " +"at compile time)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:643 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.1.4, 9.5.5" +msgstr "" + +#. Tag: para +#: reference_measure.xml:649 +#, no-c-format +msgid "" +"In each of the following illustrations, the blue dot represents the centroid " +"of the source geometry." +msgstr "" + +#. Tag: para +#: reference_measure.xml:662 +#, no-c-format +msgid "Centroid of a MULTIPOINT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:673 +#, no-c-format +msgid "Centroid of a LINESTRING" +msgstr "" + +#. Tag: para +#: reference_measure.xml:686 +#, no-c-format +msgid "Centroid of a POLYGON" +msgstr "" + +#. Tag: para +#: reference_measure.xml:697 +#, no-c-format +msgid "Centroid of a GEOMETRYCOLLECTION" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:706 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Centroid('MULTIPOINT ( -1 0, -1 2, -1 3, -1 4, -1 7, 0 " +"1, 0 3, 1 1, 2 0, 6 0, 7 8, 9 8, 10 6 )'));\n" +" st_astext\n" +"------------------------------------------\n" +" POINT(2.30769230769231 3.30769230769231)\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:718 +#, no-c-format +msgid "ST_ClosestPoint" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:720 +#, no-c-format +msgid "" +"Returns the 2-dimensional point on g1 that is closest to g2. " +"This is the first point of the shortest line." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:726 +#, no-c-format +msgid "" +"geometry ST_ClosestPoint " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:741 +#, no-c-format +msgid "" +"Returns the 2-dimensional point on g1 that is closest to g2. This is " +"the first point of the shortest line." +msgstr "" + +#. Tag: para +#: reference_measure.xml:744 +#, no-c-format +msgid "" +"If you have a 3D Geometry, you may prefer to use ." +msgstr "" + +#. Tag: para +#: reference_measure.xml:745 reference_measure.xml:1690 +#: reference_measure.xml:1842 reference_measure.xml:2433 +#: reference_measure.xml:3005 +#, no-c-format +msgid "Availability: 1.5.0" +msgstr "" + +#. Tag: para +#: reference_measure.xml:759 +#, no-c-format +msgid "" +"Closest between point and linestring is the point itself, but closest point " +"between a linestring and point is the point on line string that is closest." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:763 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_ClosestPoint(pt,line)) AS cp_pt_line, \n" +" ST_AsText(ST_ClosestPoint(line,pt)) As cp_line_pt\n" +"FROM (SELECT 'POINT(100 100)'::geometry As pt, \n" +" 'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry As " +"line\n" +" ) As foo;\n" +"\n" +" \n" +" cp_pt_line | cp_line_pt\n" +"----------------+------------------------------------------\n" +" POINT(100 100) | POINT(73.0769230769231 115.384615384615)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:771 +#, no-c-format +msgid "closest point on polygon A to polygon B" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:774 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_ClosestPoint(\n" +" ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 " +"100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" ) \n" +" ) As ptwkt;\n" +" \n" +" ptwkt\n" +"------------------------------------------\n" +" POINT(140.752120669087 125.695053378061)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:786 +#, no-c-format +msgid "" +",, , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:792 +#, no-c-format +msgid "ST_Contains" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:794 +#, no-c-format +msgid "" +"Returns true if and only if no points of B lie in the exterior of A, and at " +"least one point of the interior of B lies in the interior of A." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:799 +#, no-c-format +msgid "" +"boolean ST_Contains " +"geometry geomA " +"geometry geomB" +msgstr "" + +#. Tag: para +#: reference_measure.xml:814 +#, no-c-format +msgid "" +"Geometry A contains Geometry B if and only if no points of B lie in the " +"exterior of A, and at least one point of the interior of B lies in the " +"interior of A. An important subtlety of this definition is that A does not " +"contain its boundary, but A does contain itself. Contrast that to where geometry A does not Contain Properly " +"itself." +msgstr "" + +#. Tag: para +#: reference_measure.xml:818 +#, no-c-format +msgid "" +"Returns TRUE if geometry B is completely inside geometry A. For this " +"function to make sense, the source geometries must both be of the same " +"coordinate projection, having the same SRID. ST_Contains is the inverse of " +"ST_Within. So ST_Contains(A,B) implies ST_Within(B,A) except in the case of " +"invalid geometries where the result is always false regardless or not " +"defined." +msgstr "" + +#. Tag: para +#: reference_measure.xml:823 reference_measure.xml:1050 +#: reference_measure.xml:1132 reference_measure.xml:1497 +#: reference_measure.xml:2564 reference_measure.xml:2910 +#: reference_measure.xml:3227 +#, no-c-format +msgid "Performed by the GEOS module" +msgstr "" + +#. Tag: para +#: reference_measure.xml:826 reference_measure.xml:988 +#: reference_measure.xml:1053 reference_measure.xml:1135 +#: reference_measure.xml:1239 reference_measure.xml:1494 +#: reference_measure.xml:3108 reference_measure.xml:3230 +#, no-c-format +msgid "Do not call with a GEOMETRYCOLLECTION as an argument" +msgstr "" + +#. Tag: para +#: reference_measure.xml:830 reference_measure.xml:992 +#: reference_measure.xml:1061 reference_measure.xml:1139 +#: reference_measure.xml:3234 +#, no-c-format +msgid "" +"Do not use this function with invalid geometries. You will get unexpected " +"results." +msgstr "" + +#. Tag: para +#: reference_measure.xml:833 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"index use, use the function _ST_Contains." +msgstr "" + +#. Tag: para +#: reference_measure.xml:838 reference_measure.xml:1072 +#: reference_measure.xml:1147 reference_measure.xml:1503 +#: reference_measure.xml:2104 reference_measure.xml:2573 +#: reference_measure.xml:3242 +#, no-c-format +msgid "" +"NOTE: this is the \"allowable\" version that returns a boolean, not an " +"integer." +msgstr "" + +#. Tag: para +#: reference_measure.xml:841 +#, no-c-format +msgid "" +"&sfs_compliant; s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry " +"A)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:843 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.31" +msgstr "" + +#. Tag: para +#: reference_measure.xml:845 reference_measure.xml:1076 +#: reference_measure.xml:1151 +#, no-c-format +msgid "" +"There are certain subtleties to ST_Contains and ST_Within that are not " +"intuitively obvious. For details check out Subtleties of OGC Covers, Contains, Within" +msgstr "" + +#. Tag: para +#: reference_measure.xml:852 +#, no-c-format +msgid "" +"The ST_Contains predicate returns TRUE in all the following illustrations." +msgstr "" + +#. Tag: para +#: reference_measure.xml:864 +#, no-c-format +msgid "LINESTRING / MULTIPOINT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:874 reference_measure.xml:3186 +#, no-c-format +msgid "POLYGON / POINT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:885 reference_measure.xml:925 +#: reference_measure.xml:3155 +#, no-c-format +msgid "POLYGON / LINESTRING" +msgstr "" + +#. Tag: para +#: reference_measure.xml:895 reference_measure.xml:2610 +#: reference_measure.xml:3135 reference_measure.xml:3145 +#, no-c-format +msgid "POLYGON / POLYGON" +msgstr "" + +#. Tag: para +#: reference_measure.xml:903 +#, no-c-format +msgid "" +"The ST_Contains predicate returns FALSE in all the following illustrations." +msgstr "" + +#. Tag: para +#: reference_measure.xml:915 +#, no-c-format +msgid "POLYGON / MULTIPOINT" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:933 +#, no-c-format +msgid "" +"-- A circle within a circle\n" +"SELECT ST_Contains(smallc, bigc) As smallcontainsbig,\n" +" ST_Contains(bigc,smallc) As bigcontainssmall,\n" +" ST_Contains(bigc, ST_Union(smallc, bigc)) as bigcontainsunion,\n" +" ST_Equals(bigc, ST_Union(smallc, bigc)) as bigisunion,\n" +" ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,\n" +" ST_Contains(bigc, ST_ExteriorRing(bigc)) As bigcontainsexterior\n" +"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,\n" +" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As " +"bigc) As foo;\n" +"\n" +"-- Result\n" +" smallcontainsbig | bigcontainssmall | bigcontainsunion | bigisunion | " +"bigcoversexterior | bigcontainsexterior\n" +"------------------+------------------+------------------+------------" +"+-------------------+---------------------\n" +" f | t | t | t | " +"t | f\n" +"\n" +"-- Example demonstrating difference between contains and contains properly\n" +"SELECT ST_GeometryType(geomA) As geomtype, ST_Contains(geomA,geomA) AS " +"acontainsa, ST_ContainsProperly(geomA, geomA) AS acontainspropa,\n" +" ST_Contains(geomA, ST_Boundary(geomA)) As acontainsba, " +"ST_ContainsProperly(geomA, ST_Boundary(geomA)) As acontainspropba\n" +"FROM (VALUES ( ST_Buffer(ST_Point(1,1), 5,1) ),\n" +" ( ST_MakeLine(ST_Point(1,1), ST_Point(-1,-1) ) ),\n" +" ( ST_Point(1,1) )\n" +" ) As foo(geomA);\n" +"\n" +" geomtype | acontainsa | acontainspropa | acontainsba | acontainspropba\n" +"--------------+------------+----------------+-------------" +"+-----------------\n" +"ST_Polygon | t | f | f | f\n" +"ST_LineString | t | f | f | f\n" +"ST_Point | t | t | f | f" +msgstr "" + +#. Tag: para +#: reference_measure.xml:938 +#, no-c-format +msgid "" +", , , " +", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:944 +#, no-c-format +msgid "ST_ContainsProperly" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:946 +#, no-c-format +msgid "" +"Returns true if B intersects the interior of A but not the boundary (or " +"exterior). A does not contain properly itself, but does contain itself." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:951 +#, no-c-format +msgid "" +"boolean ST_ContainsProperly " +"geometry geomA " +"geometry geomB" +msgstr "" + +#. Tag: para +#: reference_measure.xml:966 +#, no-c-format +msgid "" +"Returns true if B intersects the interior of A but not the boundary (or " +"exterior)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:968 +#, no-c-format +msgid "A does not contain properly itself, but does contain itself." +msgstr "" + +#. Tag: para +#: reference_measure.xml:969 +#, no-c-format +msgid "" +"Every point of the other geometry is a point of this geometry's interior. " +"The DE-9IM Intersection Matrix for the two geometries matches [T**FF*FF*] " +"used in " +msgstr "" + +#. Tag: para +#: reference_measure.xml:973 +#, no-c-format +msgid "" +"From JTS docs slightly reworded: The advantage to using this predicate over " +" and is " +"that it can be computed efficiently, with no need to compute topology at " +"individual points." +msgstr "" + +#. Tag: para +#: reference_measure.xml:975 +#, no-c-format +msgid "" +"An example use case for this predicate is computing the intersections of a " +"set of geometries with a large polygonal geometry. Since intersection is a " +"fairly slow operation, it can be more efficient to use containsProperly to " +"filter out test geometries which lie wholly inside the area. In these cases " +"the intersection is known a priori to be exactly the original test geometry." +msgstr "" + +#. Tag: para +#: reference_measure.xml:985 +#, no-c-format +msgid "Availability: 1.4.0 - requires GEOS >= 3.1.0." +msgstr "" + +#. Tag: para +#: reference_measure.xml:995 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"index use, use the function _ST_ContainsProperly." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1004 +#, no-c-format +msgid "" +"--a circle within a circle\n" +" SELECT ST_ContainsProperly(smallc, bigc) As smallcontainspropbig,\n" +" ST_ContainsProperly(bigc,smallc) As bigcontainspropsmall,\n" +" ST_ContainsProperly(bigc, ST_Union(smallc, bigc)) as " +"bigcontainspropunion,\n" +" ST_Equals(bigc, ST_Union(smallc, bigc)) as bigisunion,\n" +" ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,\n" +" ST_ContainsProperly(bigc, ST_ExteriorRing(bigc)) As " +"bigcontainsexterior\n" +" FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As " +"smallc,\n" +" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;\n" +" --Result\n" +" smallcontainspropbig | bigcontainspropsmall | bigcontainspropunion | " +"bigisunion | bigcoversexterior | bigcontainsexterior\n" +"------------------+------------------+------------------+------------" +"+-------------------+---------------------\n" +" f | t | f | " +"t | t | f\n" +"\n" +" --example demonstrating difference between contains and contains properly\n" +" SELECT ST_GeometryType(geomA) As geomtype, ST_Contains(geomA,geomA) AS " +"acontainsa, ST_ContainsProperly(geomA, geomA) AS acontainspropa,\n" +" ST_Contains(geomA, ST_Boundary(geomA)) As acontainsba, " +"ST_ContainsProperly(geomA, ST_Boundary(geomA)) As acontainspropba\n" +" FROM (VALUES ( ST_Buffer(ST_Point(1,1), 5,1) ),\n" +" ( ST_MakeLine(ST_Point(1,1), ST_Point(-1,-1) ) ),\n" +" ( ST_Point(1,1) )\n" +" ) As foo(geomA);\n" +"\n" +" geomtype | acontainsa | acontainspropa | acontainsba | acontainspropba\n" +"--------------+------------+----------------+-------------" +"+-----------------\n" +"ST_Polygon | t | f | f | f\n" +"ST_LineString | t | f | f | f\n" +"ST_Point | t | t | f | f" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1009 +#, no-c-format +msgid "" +", , , , , , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1015 +#, no-c-format +msgid "ST_Covers" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1017 +#, no-c-format +msgid "Returns 1 (TRUE) if no point in Geometry B is outside Geometry A" +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:1022 +#, no-c-format +msgid "" +" boolean ST_Covers " +"geometry geomA " +"geometry geomB boolean ST_Covers geography geogpolyA geography " +"geogpointB " +msgstr "" + +#. Tag: para +#: reference_measure.xml:1047 +#, no-c-format +msgid "" +"Returns 1 (TRUE) if no point in Geometry/Geography B is outside Geometry/" +"Geography A" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1057 +#, no-c-format +msgid "For geography only Polygon covers point is supported." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1064 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"index use, use the function _ST_Covers." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1069 reference_measure.xml:1141 +#, no-c-format +msgid "Availability: 1.2.2 - requires GEOS >= 3.0" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1070 +#, no-c-format +msgid "Availability: 1.5 - support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1075 reference_measure.xml:1150 +#, no-c-format +msgid "Not an OGC standard, but Oracle has it too." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1082 +#, no-c-format +msgid "Geometry example" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1083 +#, no-c-format +msgid "" +"--a circle covering a circle\n" +"SELECT ST_Covers(smallc,smallc) As smallinsmall,\n" +" ST_Covers(smallc, bigc) As smallcoversbig,\n" +" ST_Covers(bigc, ST_ExteriorRing(bigc)) As bigcoversexterior,\n" +" ST_Contains(bigc, ST_ExteriorRing(bigc)) As bigcontainsexterior\n" +"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,\n" +" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;\n" +" --Result\n" +" smallinsmall | smallcoversbig | bigcoversexterior | bigcontainsexterior\n" +"--------------+----------------+-------------------+---------------------\n" +" t | f | t | f\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1084 +#, no-c-format +msgid "Geeography Example" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1085 +#, no-c-format +msgid "" +"-- a point with a 300 meter buffer compared to a point, a point and its 10 " +"meter buffer\n" +"SELECT ST_Covers(geog_poly, geog_pt) As poly_covers_pt, \n" +" ST_Covers(ST_Buffer(geog_pt,10), geog_pt) As buff_10m_covers_cent\n" +" FROM (SELECT ST_Buffer(ST_GeogFromText('SRID=4326;POINT(-99.327 " +"31.4821)'), 300) As geog_poly,\n" +" ST_GeogFromText('SRID=4326;POINT(-99.33 " +"31.483)') As geog_pt ) As foo;\n" +" \n" +" poly_covers_pt | buff_10m_covers_cent\n" +"----------------+------------------\n" +" f | t" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1090 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1096 +#, no-c-format +msgid "ST_CoveredBy" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1098 +#, no-c-format +msgid "" +"Returns 1 (TRUE) if no point in Geometry/Geography A is outside " +"Geometry/Geography B" +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:1103 +#, no-c-format +msgid "" +" boolean ST_CoveredBy " +"geometry geomA " +"geometry geomB boolean ST_CoveredBy geography geogA geography geogB " +msgstr "" + +#. Tag: para +#: reference_measure.xml:1129 +#, no-c-format +msgid "" +"Returns 1 (TRUE) if no point in Geometry/Geography A is outside " +"Geometry/Geography B" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1142 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"index use, use the function _ST_CoveredBy." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1157 +#, no-c-format +msgid "" +"--a circle coveredby a circle\n" +"SELECT ST_CoveredBy(smallc,smallc) As smallinsmall,\n" +" ST_CoveredBy(smallc, bigc) As smallcoveredbybig,\n" +" ST_CoveredBy(ST_ExteriorRing(bigc), bigc) As exteriorcoveredbybig,\n" +" ST_Within(ST_ExteriorRing(bigc),bigc) As exeriorwithinbig\n" +"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,\n" +" ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;\n" +" --Result\n" +" smallinsmall | smallcoveredbybig | exteriorcoveredbybig | exeriorwithinbig\n" +"--------------+-------------------+----------------------" +"+------------------\n" +" t | t | t | f\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1162 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1168 +#, no-c-format +msgid "ST_Crosses" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1170 +#, no-c-format +msgid "" +"Returns TRUE if the supplied geometries have some, but " +"not all, interior points in common." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1176 +#, no-c-format +msgid "" +"boolean ST_Crosses " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1189 +#, no-c-format +msgid "" +"ST_Crosses takes two geometry objects and returns " +"TRUE if their intersection \"spatially cross\", that is, " +"the geometries have some, but not all interior points in common. The " +"intersection of the interiors of the geometries must not be the empty set " +"and must have a dimensionality less than the the maximum dimension of the " +"two input geometries. Additionally, the intersection of the two geometries " +"must not equal either of the source geometries. Otherwise, it returns " +"FALSE." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1198 +#, no-c-format +msgid "In mathematical terms, this is expressed as:" +msgstr "" + +#. Tag: remark +#: reference_measure.xml:1200 +#, no-c-format +msgid "" +"TODO: Insert appropriate MathML markup here or use a gif. Simple HTML markup " +"does not work well in both IE and Firefox." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1211 +#, no-c-format +msgid "The DE-9IM Intersection Matrix for the two geometries is:" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1215 +#, no-c-format +msgid "" +"T*T****** (for Point/Line, Point/Area, and Line/Area " +"situations)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1220 +#, no-c-format +msgid "" +"T*****T** (for Line/Point, Area/Point, and Area/Line " +"situations)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1225 +#, no-c-format +msgid "0******** (for Line/Line situations)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1229 +#, no-c-format +msgid "For any other combination of dimensions this predicate returns false." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1232 +#, no-c-format +msgid "" +"The OpenGIS Simple Features Specification defines this predicate only for " +"Point/Line, Point/Area, Line/Line, and Line/Area situations. JTS / GEOS " +"extends the definition to apply to Line/Point, Area/Point and Area/Line " +"situations as well. This makes the relation symmetric." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1248 +#, no-c-format +msgid "&sfs_compliant; s2.1.13.3" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1249 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.29" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1255 reference_measure.xml:2582 +#, no-c-format +msgid "The following illustrations all return TRUE." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1267 +#, no-c-format +msgid "MULTIPOINT / LINESTRING" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1277 +#, no-c-format +msgid "MULTIPOINT / POLYGON" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1289 +#, no-c-format +msgid "LINESTRING / POLYGON" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1299 reference_measure.xml:2602 +#: reference_measure.xml:3166 reference_measure.xml:3176 +#, no-c-format +msgid "LINESTRING / LINESTRING" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1307 +#, no-c-format +msgid "" +"Consider a situation where a user has two tables: a table of roads and a " +"table of highways." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1315 +#, no-c-format +msgid "" +"CREATE TABLE roads (\n" +" id serial NOT NULL,\n" +" the_geom geometry,\n" +" CONSTRAINT roads_pkey PRIMARY KEY (road_id)\n" +");" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1319 +#, no-c-format +msgid "" +"CREATE TABLE highways (\n" +" id serial NOT NULL,\n" +" the_gem geometry,\n" +" CONSTRAINT roads_pkey PRIMARY KEY (road_id)\n" +");" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1326 +#, no-c-format +msgid "" +"To determine a list of roads that cross a highway, use a query similiar to:" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1330 +#, no-c-format +msgid "" +"SELECT roads.id\n" +"FROM roads, highways\n" +"WHERE ST_Crosses(roads.the_geom, highways.the_geom);" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1337 +#, no-c-format +msgid "ST_LineCrossingDirection" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1339 +#, no-c-format +msgid "" +"Given 2 linestrings, returns a number between -3 and 3 denoting what kind of " +"crossing behavior. 0 is no crossing." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1344 +#, no-c-format +msgid "" +"integer ST_LineCrossingDirection " +"geometry linestringA geometry linestringB" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1355 +#, no-c-format +msgid "" +"Given 2 linestrings, returns a number between -3 and 3 denoting what kind of " +"crossing behavior. 0 is no crossing. This is only supported for " +"LINESTRING" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1356 +#, no-c-format +msgid "Definition of integer constants is as follows:" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1359 +#, no-c-format +msgid "0: LINE NO CROSS" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1362 +#, no-c-format +msgid "-1: LINE CROSS LEFT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1365 +#, no-c-format +msgid "1: LINE CROSS RIGHT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1368 +#, no-c-format +msgid "-2: LINE MULTICROSS END LEFT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1371 +#, no-c-format +msgid "2: LINE MULTICROSS END RIGHT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1374 +#, no-c-format +msgid "-3: LINE MULTICROSS END SAME FIRST LEFT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1377 +#, no-c-format +msgid "3: LINE MULTICROSS END SAME FIRST RIGHT" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1381 +#, no-c-format +msgid "Availability: 1.4" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1399 +#, no-c-format +msgid "" +"Line 1 (green), Line 2 ball is start point, triangle are end points. Query " +"below." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1403 +#, no-c-format +msgid "" +"SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" +" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n" +"FROM (\n" +"SELECT\n" +" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n" +" ST_GeomFromText('LINESTRING(171 154,20 140,71 74,161 53)') As line2\n" +" ) As foo;\n" +"\n" +" l1_cross_l2 | l2_cross_l1\n" +"-------------+-------------\n" +" 3 | -3" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1413 reference_measure.xml:1427 +#: reference_measure.xml:1441 +#, no-c-format +msgid "" +"Line 1 (green), Line 2 (blue) ball is start point, triangle are end points. " +"Query below." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1417 +#, no-c-format +msgid "" +"SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" +" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n" +"FROM (\n" +" SELECT\n" +" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n" +" ST_GeomFromText('LINESTRING (171 154, 20 140, 71 74, 2.99 90.16)') As " +"line2\n" +") As foo;\n" +"\n" +" l1_cross_l2 | l2_cross_l1\n" +"-------------+-------------\n" +" 2 | -2" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1431 +#, no-c-format +msgid "" +"SELECT\n" +" ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" +" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n" +"FROM (\n" +" SELECT\n" +" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n" +" ST_GeomFromText('LINESTRING (20 140, 71 74, 161 53)') As line2\n" +" ) As foo;\n" +"\n" +" l1_cross_l2 | l2_cross_l1\n" +"-------------+-------------\n" +" -1 | 1" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1445 +#, no-c-format +msgid "" +"SELECT ST_LineCrossingDirection(foo.line1, foo.line2) As l1_cross_l2 ,\n" +" ST_LineCrossingDirection(foo.line2, foo.line1) As l2_cross_l1\n" +"FROM (SELECT\n" +" ST_GeomFromText('LINESTRING(25 169,89 114,40 70,86 43)') As line1,\n" +" ST_GeomFromText('LINESTRING(2.99 90.16,71 74,20 140,171 154)') As " +"line2\n" +" ) As foo;\n" +"\n" +" l1_cross_l2 | l2_cross_l1\n" +"-------------+-------------\n" +" -2 | 2" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1453 +#, no-c-format +msgid "" +"SELECT s1.gid, s2.gid, ST_LineCrossingDirection(s1.the_geom, s2.the_geom)\n" +" FROM streets s1 CROSS JOIN streets s2 ON (s1.gid != s2.gid AND s1." +"the_geom && s2.the_geom )\n" +"WHERE ST_CrossingDirection(s1.the_geom, s2.the_geom) > 0;" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1466 +#, no-c-format +msgid "ST_Disjoint" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1468 +#, no-c-format +msgid "" +"Returns TRUE if the Geometries do not \"spatially intersect\" - if they do " +"not share any space together." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1474 +#, no-c-format +msgid "" +"boolean ST_Disjoint " +"geometry A " +"geometry B " +msgstr "" + +#. Tag: para +#: reference_measure.xml:1489 +#, no-c-format +msgid "" +"Overlaps, Touches, Within all imply geometries are not spatially disjoint. " +"If any of the aforementioned returns true, then the geometries are not " +"spatially disjoint. Disjoint implies false for spatial intersection." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1499 +#, no-c-format +msgid "This function call does not use indexes" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1506 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2 //s2.1.13.3 - a.Relate(b, 'FF*FF****')" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1508 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.26" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1513 +#, no-c-format +msgid "" +"SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::" +"geometry);\n" +" st_disjoint\n" +"---------------\n" +" t\n" +"(1 row)\n" +"SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::" +"geometry);\n" +" st_disjoint\n" +"---------------\n" +" f\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1518 +#, no-c-format +msgid "ST_Intersects" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1524 +#, no-c-format +msgid "ST_Distance" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1526 +#, no-c-format +msgid "" +"For geometry type Returns the 2-dimensional cartesian minimum distance " +"(based on spatial ref) between two geometries in projected units. For " +"geography type defaults to return spheroidal minimum distance between two " +"geographies in meters." +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:1530 +#, no-c-format +msgid "" +" float ST_Distance " +"geometry g1 " +"geometry g2 float ST_Distance geography gg1 geography gg2 float " +"ST_Distance geography " +"gg1 geography " +"gg2 boolean " +"use_spheroid " +msgstr "" + +#. Tag: para +#: reference_measure.xml:1568 +#, no-c-format +msgid "" +"For geometry type returns the 2-dimensional minimum cartesian distance " +"between two geometries in projected units (spatial ref units). For geography " +"type defaults to return the minimum distance around WGS 84 spheroid between " +"two geographies in meters. Pass in false to return answer in sphere instead " +"of spheroid." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1573 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.23" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1575 +#, no-c-format +msgid "" +"Availability: 1.5.0 geography support was introduced in 1.5. Speed " +"improvements for planar to better handle large or many vertex geometries" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1576 reference_measure.xml:1939 +#, no-c-format +msgid "" +"Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1582 +#, no-c-format +msgid "" +"--Geometry example - units in planar degrees 4326 is WGS 84 long lat " +"unit=degrees\n" +"SELECT ST_Distance(\n" +" ST_GeomFromText('POINT(-72.1235 42.3521)',4326),\n" +" ST_GeomFromText('LINESTRING(-72.1260 42.45, -72.123 " +"42.1546)', 4326)\n" +" );\n" +"st_distance\n" +"-----------------\n" +"0.00150567726382282\n" +"\n" +"-- Geometry example - units in meters (SRID: 26986 Massachusetts state plane " +"meters) (most accurate for Massachusetts)\n" +"SELECT ST_Distance(\n" +" ST_Transform(ST_GeomFromText('POINT(-72.1235 " +"42.3521)',4326),26986),\n" +" ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 " +"42.45, -72.123 42.1546)', 4326),26986)\n" +" );\n" +"st_distance\n" +"-----------------\n" +"123.797937878454\n" +"\n" +"-- Geometry example - units in meters (SRID: 2163 US National Atlas Equal " +"area) (least accurate)\n" +"SELECT ST_Distance(\n" +" ST_Transform(ST_GeomFromText('POINT(-72.1235 " +"42.3521)',4326),2163),\n" +" ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 " +"42.45, -72.123 42.1546)', 4326),2163)\n" +" );\n" +"\n" +"st_distance\n" +"------------------\n" +"126.664256056812\n" +"\n" +"-- Geography example -- same but note units in meters - use sphere for " +"slightly faster less accurate\n" +"SELECT ST_Distance(gg1, gg2) As spheroid_dist, ST_Distance(gg1, gg2, false) " +"As sphere_dist \n" +"FROM (SELECT\n" +" ST_GeographyFromText('SRID=4326;POINT(-72.1235 42.3521)') As gg1,\n" +" ST_GeographyFromText('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 " +"42.1546)') As gg2\n" +" ) As foo ;\n" +"\n" +" spheroid_dist | sphere_dist\n" +"------------------+------------------\n" +" 123.802076746848 | 123.475736916397" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1588 +#, no-c-format +msgid "" +", , , " +", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1594 +#, no-c-format +msgid "ST_HausdorffDistance" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1596 +#, no-c-format +msgid "" +"Returns the Hausdorff distance between two geometries. Basically a measure " +"of how similar or dissimilar 2 geometries are. Units are in the units of the " +"spatial reference system of the geometries." +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:1601 +#, no-c-format +msgid "" +" float ST_HausdorffDistance geometry g1 geometry g2 float " +"ST_HausdorffDistance geometry " +" g1 geometry g2 float " +"densifyFrac " +msgstr "" + +#. Tag: para +#: reference_measure.xml:1629 +#, no-c-format +msgid "" +"Implements algorithm for computing a distance metric which can be thought of " +"as the \"Discrete Hausdorff Distance\". This is the Hausdorff distance " +"restricted to discrete points for one of the geometries. Wikipedia article on Hausdorff " +"distance Martin Davis note on how Hausdorff " +"Distance calculation was used to prove correctness of the " +"CascadePolygonUnion approach." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1632 +#, no-c-format +msgid "" +"When densifyFrac is specified, this function performs a segment " +"densification before computing the discrete hausdorff distance. The " +"densifyFrac parameter sets the fraction by which to densify each segment. " +"Each segment will be split into a number of equal-length subsegments, whose " +"fraction of the total length is closest to the given fraction." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1637 +#, no-c-format +msgid "" +"The current implementation supports only vertices as the discrete locations. " +"This could be extended to allow an arbitrary density of points to be used." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1642 +#, no-c-format +msgid "" +"This algorithm is NOT equivalent to the standard Hausdorff distance. " +"However, it computes an approximation that is correct for a large subset of " +"useful cases. One important part of this subset is Linestrings that are " +"roughly parallel to each other, and roughly equal in length. This is a " +"useful metric for line matching." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1647 +#, no-c-format +msgid "Availability: 1.5.0 - requires GEOS >= 3.2.0" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1654 +#, no-c-format +msgid "" +"postgis=# SELECT st_HausdorffDistance(\n" +" 'LINESTRING (0 0, 2 0)'::geometry,\n" +" 'MULTIPOINT (0 1, 1 0, 2 1)'::geometry);\n" +" st_hausdorffdistance\n" +" ----------------------\n" +" 1\n" +"(1 row)" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1655 +#, no-c-format +msgid "" +"postgis=# SELECT st_hausdorffdistance('LINESTRING (130 0, 0 0, 0 150)'::" +"geometry, 'LINESTRING (10 10, 10 150, 130 10)'::geometry, 0.5);\n" +" st_hausdorffdistance\n" +" ----------------------\n" +" 70\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1662 +#, no-c-format +msgid "ST_MaxDistance" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1664 +#, no-c-format +msgid "" +"Returns the 2-dimensional largest distance between two geometries in " +"projected units." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1670 +#, no-c-format +msgid "" +"float ST_MaxDistance " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1681 +#, no-c-format +msgid "Some useful description here." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1685 +#, no-c-format +msgid "" +"Returns the 2-dimensional maximum distance between two linestrings in " +"projected units. If g1 and g2 is the same geometry the function will return " +"the distance between the two vertices most far from each other in that " +"geometry." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1695 +#, no-c-format +msgid "" +"postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 " +"2 )'::geometry);\n" +" st_maxdistance\n" +"-----------------\n" +" 2\n" +"(1 row)\n" +"\n" +"postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 2, 2 " +"2 )'::geometry);\n" +" st_maxdistance \n" +"------------------\n" +" 2.82842712474619\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1701 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1707 +#, no-c-format +msgid "ST_Distance_Sphere" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1709 +#, no-c-format +msgid "" +"Returns minimum distance in meters between two lon/lat geometries. Uses a " +"spherical earth and radius of 6370986 meters. Faster than " +"ST_Distance_Spheroid , but less " +"accurate. PostGIS versions prior to 1.5 only implemented for points." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1717 +#, no-c-format +msgid "" +"float ST_Distance_Sphere " +"geometry geomlonlatA geometry geomlonlatB" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1728 +#, no-c-format +msgid "" +"Returns minimum distance in meters between two lon/lat points. Uses a " +"spherical earth and radius of 6370986 meters. Faster than , but less accurate. PostGIS Versions prior to 1.5 " +"only implemented for points." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1733 +#, no-c-format +msgid "" +"This function currently does not look at the SRID of a geometry and will " +"always assume its in WGS 84 long lat. Prior versions of this function only " +"support points." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1736 reference_measure.xml:1784 +#, no-c-format +msgid "" +"Availability: 1.5 - support for other geometry types besides points was " +"introduced. Prior versions only work with points." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1743 +#, no-c-format +msgid "" +"SELECT round(CAST(ST_Distance_Sphere(ST_Centroid(the_geom), " +"ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters,\n" +"round(CAST(ST_Distance(ST_Transform(ST_Centroid(the_geom),32611),\n" +" ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) " +"As numeric),2) As dist_utm11_meters,\n" +"round(CAST(ST_Distance(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 " +"38)', 4326)) As numeric),5) As dist_degrees,\n" +"round(CAST(ST_Distance(ST_Transform(the_geom,32611),\n" +" ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) " +"As numeric),2) As min_dist_line_point_meters\n" +"FROM\n" +" (SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', " +"4326) As the_geom) as foo;\n" +" dist_meters | dist_utm11_meters | dist_degrees | " +"min_dist_line_point_meters\n" +" -------------+-------------------+--------------" +"+----------------------------\n" +" 70424.47 | 70438.00 | 0.72900 " +"| 65871.18" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1750 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1756 +#, no-c-format +msgid "ST_Distance_Spheroid" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1758 +#, no-c-format +msgid "" +"Returns the minimum distance between two lon/lat geometries given a " +"particular spheroid. PostGIS versions prior to 1.5 only support points." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1765 +#, no-c-format +msgid "" +"float ST_Distance_Spheroid " +"geometry geomlonlatA geometry geomlonlatB spheroid " +"measurement_spheroid" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1777 +#, no-c-format +msgid "" +"Returns minimum distance in meters between two lon/lat geometries given a " +"particular spheroid. See the explanation of spheroids given for . PostGIS version prior to 1.5 only support " +"points." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1781 +#, no-c-format +msgid "" +"This function currently does not look at the SRID of a geometry and will " +"always assume its represented in the coordinates of the passed in spheroid. " +"Prior versions of this function only support points." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1791 +#, no-c-format +msgid "" +"SELECT round(CAST(\n" +" ST_Distance_Spheroid(ST_Centroid(the_geom), " +"ST_GeomFromText('POINT(-118 38)',4326), 'SPHEROID[\"WGS " +"84\",6378137,298.257223563]')\n" +" As numeric),2) As dist_meters_spheroid,\n" +" round(CAST(ST_Distance_Sphere(ST_Centroid(the_geom), " +"ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As " +"dist_meters_sphere,\n" +"round(CAST(ST_Distance(ST_Transform(ST_Centroid(the_geom),32611),\n" +" ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) " +"As numeric),2) As dist_utm11_meters\n" +"FROM\n" +" (SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', " +"4326) As the_geom) as foo;\n" +" dist_meters_spheroid | dist_meters_sphere | dist_utm11_meters\n" +"----------------------+--------------------+-------------------\n" +" 70454.92 | 70424.47 | 70438.00" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1798 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1804 +#, no-c-format +msgid "ST_DFullyWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1806 +#, no-c-format +msgid "" +"Returns true if all of the geometries are within the specified distance of " +"one another" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1812 +#, no-c-format +msgid "" +"boolean ST_DFullyWithin " +"geometry g1 " +"geometry g2 " +"double precision distance" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1830 +#, no-c-format +msgid "" +"Returns true if the geometries is fully within the specified distance of one " +"another. The distance is specified in units defined by the spatial reference " +"system of the geometries. For this function to make sense, the source " +"geometries must both be of the same coordinate projection, having the same " +"SRID." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1847 +#, no-c-format +msgid "" +"postgis=# SELECT ST_DFullyWithin(geom_a, geom_b, 10) as DFullyWithin10, " +"ST_DWithin(geom_a, geom_b, 10) as DWithin10, ST_DFullyWithin(geom_a, geom_b, " +"20) as DFullyWithin20 from \n" +" (select ST_GeomFromText('POINT(1 1)') as geom_a," +"ST_GeomFromText('LINESTRING(1 5, 2 7, 1 9, 14 12)') as geom_b) t1;\n" +" \n" +"-----------------\n" +" DFullyWithin10 | DWithin10 | DFullyWithin20 |\n" +"---------------+----------+---------------+\n" +" f | t | t |" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1853 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1859 +#, no-c-format +msgid "ST_DWithin" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1861 +#, no-c-format +msgid "" +"Returns true if the geometries are within the specified distance of one " +"another. For geometry units are in those of spatial reference and For " +"geography units are in meters and measurement is defaulted to " +"use_spheroid=true (measure around spheroid), for faster check, " +"use_spheroid=false to measure along sphere." +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:1867 +#, no-c-format +msgid "" +" boolean ST_DWithin " +"geometry g1 " +"geometry g2 " +"double precision distance_of_srid boolean " +"ST_DWithin geography " +"gg1 geography " +"gg2 double precision distance_meters " +" boolean ST_DWithin " +"geography gg1 " +"geography gg2 " +"double precision distance_meters boolean " +"use_spheroid " +msgstr "" + +#. Tag: para +#: reference_measure.xml:1912 +#, no-c-format +msgid "" +"Returns true if the geometries are within the specified distance of one " +"another." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1914 +#, no-c-format +msgid "" +"For Geometries: The distance is specified in units defined by the spatial " +"reference system of the geometries. For this function to make sense, the " +"source geometries must both be of the same coordinate projection, having the " +"same SRID." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1919 +#, no-c-format +msgid "" +"For geography units are in meters and measurement is defaulted to " +"use_spheroid=true (measure around WGS 84 spheroid), for faster check, " +"use_spheroid=false to measure along sphere." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1929 +#, no-c-format +msgid "" +"Prior to 1.3, ST_Expand was commonly used in conjunction with && and " +"ST_Distance to achieve the same effect and in pre-1.3.4 this function was " +"basically short-hand for that construct. From 1.3.4, ST_DWithin uses a more " +"short-circuit distance function which should make it more efficient than " +"prior versions for larger buffer regions." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1935 +#, no-c-format +msgid "Use ST_3DDWithin if you have 3D geometries." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1938 +#, no-c-format +msgid "Availability: 1.5.0 support for geography was introduced" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1944 +#, no-c-format +msgid "" +"--Find the nearest hospital to each school\n" +"--that is within 3000 units of the school.\n" +"-- We do an ST_DWithin search to utilize indexes to limit our search list\n" +"-- that the non-indexable ST_Distance needs to process\n" +"--If the units of the spatial reference is meters then units would be " +"meters\n" +"SELECT DISTINCT ON (s.gid) s.gid, s.school_name, s.the_geom, h." +"hospital_name\n" +" FROM schools s\n" +" LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.the_geom, " +"3000)\n" +" ORDER BY s.gid, ST_Distance(s.the_geom, h.the_geom);\n" +"\n" +"--The schools with no close hospitals\n" +"--Find all schools with no hospital within 3000 units\n" +"--away from the school. Units is in units of spatial ref (e.g. meters, " +"feet, degrees)\n" +"SELECT s.gid, s.school_name\n" +" FROM schools s\n" +" LEFT JOIN hospitals h ON ST_DWithin(s.the_geom, h.the_geom, " +"3000)\n" +" WHERE h.gid IS NULL;" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1950 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:1956 +#, no-c-format +msgid "ST_Equals" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:1958 +#, no-c-format +msgid "" +"Returns true if the given geometries represent the same geometry. " +"Directionality is ignored." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:1964 +#, no-c-format +msgid "" +"boolean ST_Equals " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1975 +#, no-c-format +msgid "" +"Returns TRUE if the given Geometries are \"spatially equal\". Use this for a " +"'better' answer than '='. Note by spatially equal we mean ST_Within(A,B) = " +"true and ST_Within(B,A) = true and also mean ordering of points can be " +"different but represent the same geometry structure. To verify the order of " +"points is consistent, use ST_OrderingEquals (it must be noted " +"ST_OrderingEquals is a little more stringent than simply verifying order of " +"points are the same)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1984 +#, no-c-format +msgid "" +"This function will return false if either geometry is invalid even if they " +"are binary equal." +msgstr "" + +#. Tag: para +#: reference_measure.xml:1987 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:1988 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.24" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:1994 +#, no-c-format +msgid "" +"SELECT ST_Equals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n" +" ST_GeomFromText('LINESTRING(0 0, 5 5, 10 10)'));\n" +" st_equals\n" +"-----------\n" +" t\n" +"(1 row)\n" +"\n" +"SELECT ST_Equals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 10)')),\n" +" ST_GeomFromText('LINESTRING(0 0, 5 5, 10 10)'));\n" +" st_equals\n" +"-----------\n" +" t\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2000 +#, no-c-format +msgid "" +", , , " +"" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2007 +#, no-c-format +msgid "ST_HasArc" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2009 +#, no-c-format +msgid "" +"Returns true if a geometry or geometry collection contains a " +"circular string" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2014 +#, no-c-format +msgid "" +"boolean ST_HasArc " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2024 +#, no-c-format +msgid "" +"Returns true if a geometry or geometry collection contains a circular " +"string" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2026 +#, no-c-format +msgid "Availability: 1.2.3?" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2028 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2035 +#, no-c-format +msgid "" +"SELECT ST_HasArc(ST_Collect('LINESTRING(1 2, 3 4, 5 6)', 'CIRCULARSTRING(1 " +"1, 2 3, 4 5, 6 7, 5 6)'));\n" +" st_hasarc\n" +" --------\n" +" t" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2042 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2048 +#, no-c-format +msgid "ST_Intersects" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2050 +#, no-c-format +msgid "" +"Returns TRUE if the Geometries/Geography \"spatially intersect in 2D\" - " +"(share any portion of space) and FALSE if they don't (they are Disjoint). " +"For geography -- tolerance is 0.00001 meters (so any points that close are " +"considered to intersect)" +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:2056 +#, no-c-format +msgid "" +" boolean ST_Intersects geometry geomA geometry geomB boolean " +"ST_Intersects geography geogA geography geogB " +msgstr "" + +#. Tag: para +#: reference_measure.xml:2088 +#, no-c-format +msgid "" +"Do not call with a GEOMETRYCOLLECTION as an argument for " +"geometry version. The geography version supports GEOMETRYCOLLECTION since " +"its a thin wrapper around distance implementation." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2092 +#, no-c-format +msgid "Performed by the GEOS module (for geometry), geography is native" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2093 +#, no-c-format +msgid "Availability: 1.5 support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2100 +#, no-c-format +msgid "" +"For geography, this function has a distance tolerance of about 0.00001 " +"meters and uses the sphere rather than spheroid calculation." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2107 +#, no-c-format +msgid "" +"&sfs_compliant; s2.1.1.2 //s2.1.13.3 - ST_Intersects(g1, g2 ) --> Not " +"(ST_Disjoint(g1, g2 ))" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2110 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.27" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2114 +#, no-c-format +msgid "" +"SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::" +"geometry);\n" +" st_intersects\n" +"---------------\n" +" f\n" +"(1 row)\n" +"SELECT ST_Intersects('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::" +"geometry);\n" +" st_intersects\n" +"---------------\n" +" t\n" +"(1 row)" +msgstr "" + +#. Tag: title +#: reference_measure.xml:2117 reference_measure.xml:2167 +#, no-c-format +msgid "Geography Examples" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2118 +#, no-c-format +msgid "" +"SELECT ST_Intersects(\n" +" ST_GeographyFromText('SRID=4326;LINESTRING(-43.23456 " +"72.4567,-43.23456 72.4568)'),\n" +" ST_GeographyFromText('SRID=4326;POINT(-43.23456 " +"72.4567772)')\n" +" );\n" +"\n" +" st_intersects\n" +"---------------\n" +"t" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2122 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2127 +#, no-c-format +msgid "ST_Length" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2129 +#, no-c-format +msgid "" +"Returns the 2d length of the geometry if it is a linestring or " +"multilinestring. geometry are in units of spatial reference and geography " +"are in meters (default spheroid)" +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:2132 +#, no-c-format +msgid "" +" float ST_Length " +"geometry a_2dlinestring float " +"ST_Length geography geog boolean use_spheroid=true " +"" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2147 +#, no-c-format +msgid "" +"For geometry: Returns the cartesian 2D length of the geometry if it is a " +"linestring, multilinestring, ST_Curve, ST_MultiCurve. 0 is returned for " +"areal geometries. For areal geometries use ST_Perimeter. Geometry: " +"Measurements are in the units of the spatial reference system of the " +"geometry. Geography: Units are in meters and also acts as a Perimeter " +"function for areal geogs." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2151 +#, no-c-format +msgid "" +"Currently for geometry this is an alias for ST_Length2D, but this may change " +"to support higher dimensions." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2152 +#, no-c-format +msgid "" +"Changed: 2.0.0 Breaking change -- in prior versions applying this to a MULTI/" +"POLYGON of type geography would give you the perimeter of the POLYGON/" +"MULTIPOLYGON. In 2.0.0 this was changed to return 0 to be in line with " +"geometry behavior. Please use ST_Perimeter if you want the perimeter of a " +"polygon" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2154 +#, no-c-format +msgid "" +"For geography measurement defaults spheroid measurement. To use the faster " +"less accurate sphere use ST_Length(gg,false);" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2155 reference_measure.xml:2660 +#, no-c-format +msgid "&sfs_compliant; s2.1.5.1" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2156 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.2, 9.3.4" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2157 +#, no-c-format +msgid "Availability: 1.5.0 geography support was introduced in 1.5." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2162 +#, no-c-format +msgid "" +"Return length in feet for line string. Note this is in feet because 2249 is " +"Mass State Plane Feet" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2164 +#, no-c-format +msgid "" +"SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 " +"2967450,743265 2967450,\n" +"743265.625 2967416,743238 2967416)',2249));\n" +"st_length\n" +"---------\n" +" 122.630744000095\n" +"\n" +"\n" +"--Transforming WGS 84 linestring to Massachusetts state plane meters\n" +"SELECT ST_Length(\n" +" ST_Transform(\n" +" ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45, " +"-72.1240 42.45666, -72.123 42.1546)'),\n" +" 26986\n" +" )\n" +");\n" +"st_length\n" +"---------\n" +"34309.4563576191" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2168 +#, no-c-format +msgid "Return length of WGS 84 geography line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2169 +#, no-c-format +msgid "" +"-- default calculation is using a sphere rather than spheroid\n" +"SELECT ST_Length(the_geog) As length_spheroid, ST_Length(the_geog,false) As " +"length_sphere\n" +"FROM (SELECT ST_GeographyFromText(\n" +"'SRID=4326;LINESTRING(-72.1260 42.45, -72.1240 42.45666, -72.123 42.1546)') " +"As the_geog)\n" +" As foo;\n" +" length_spheroid | length_sphere\n" +"------------------+------------------\n" +" 34310.5703627305 | 34346.2060960742\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2173 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2179 +#, no-c-format +msgid "ST_Length2D" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2181 +#, no-c-format +msgid "" +"Returns the 2-dimensional length of the geometry if it is a " +"linestring or multi-linestring. This is an alias for ST_Length" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2187 +#, no-c-format +msgid "" +"float ST_Length2D " +"geometry a_2dlinestring" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2197 +#, no-c-format +msgid "" +"Returns the 2-dimensional length of the geometry if it is a linestring " +"or multi-linestring. This is an alias for ST_Length" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2206 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2212 +#, no-c-format +msgid "ST_3DLength" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2214 +#, no-c-format +msgid "" +"Returns the 3-dimensional or 2-dimensional length of the geometry if it is a " +"linestring or multi-linestring." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2220 +#, no-c-format +msgid "" +"float ST_3DLength " +"geometry a_3dlinestring" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2230 +#, no-c-format +msgid "" +"Returns the 3-dimensional or 2-dimensional length of the geometry if it is a " +"linestring or multi-linestring. For 2-d lines it will just return the 2-d " +"length (same as ST_Length and ST_Length2D)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2233 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_Length3D" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2240 +#, no-c-format +msgid "" +"Return length in feet for a 3D cable. Note this is in feet because 2249 is " +"Mass State Plane Feet" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2242 +#, no-c-format +msgid "" +"SELECT ST_3DLength(ST_GeomFromText('LINESTRING(743238 2967416 1,743238 " +"2967450 1,743265 2967450 3,\n" +"743265.625 2967416 3,743238 2967416 3)',2249));\n" +"ST_3DLength\n" +"-----------\n" +"122.704716741457" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2249 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2255 +#, no-c-format +msgid "ST_Length_Spheroid" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2257 +#, no-c-format +msgid "" +"Calculates the 2D or 3D length of a linestring/multilinestring on an " +"ellipsoid. This is useful if the coordinates of the geometry are in " +"longitude/latitude and a length is desired without reprojection." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2264 +#, no-c-format +msgid "" +"float ST_Length_Spheroid " +"geometry a_linestring spheroid a_spheroid" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2275 +#, no-c-format +msgid "" +"Calculates the length of a geometry on an ellipsoid. This is useful if the " +"coordinates of the geometry are in longitude/latitude and a length is " +"desired without reprojection. The ellipsoid is a separate database type and " +"can be constructed as follows:" +msgstr "" + +#. Tag: literallayout +#: reference_measure.xml:2281 reference_measure.xml:2333 +#, no-c-format +msgid "" +"SPHEROID[<NAME>,<SEMI-MAJOR\n" +" AXIS>,<INVERSE FLATTENING>]" +msgstr "" + +#. Tag: literallayout +#: reference_measure.xml:2284 reference_measure.xml:2336 +#, no-c-format +msgid "SPHEROID[\"GRS_1980\",6378137,298.257222101]" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2285 reference_measure.xml:2337 +#, no-c-format +msgid "Will return 0 for anything that is not a MULTILINESTRING or LINESTRING" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2294 +#, no-c-format +msgid "" +"SELECT ST_Length_Spheroid( geometry_column,\n" +" 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n" +" FROM geometry_table;\n" +"\n" +"SELECT ST_Length_Spheroid( the_geom, sph_m ) As tot_len,\n" +"ST_Length_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" +"ST_Length_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n" +" FROM (SELECT " +"ST_GeomFromText('MULTILINESTRING((-118.584 38.374,-118.583 38.5),\n" +" (-71.05957 42.3589 , -71.061 43))') As the_geom,\n" +"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) " +"as foo;\n" +" tot_len | len_line1 | len_line2\n" +"------------------+------------------+------------------\n" +" 85204.5207562955 | 13986.8725229309 | 71217.6482333646\n" +"\n" +" --3D\n" +"SELECT ST_Length_Spheroid( the_geom, sph_m ) As tot_len,\n" +"ST_Length_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" +"ST_Length_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n" +" FROM (SELECT " +"ST_GeomFromEWKT('MULTILINESTRING((-118.584 38.374 20,-118.583 38.5 30),\n" +" (-71.05957 42.3589 75, -71.061 43 90))') As the_geom,\n" +"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) " +"as foo;\n" +"\n" +" tot_len | len_line1 | len_line2\n" +"------------------+-----------------+------------------\n" +" 85204.5259107402 | 13986.876097711 | 71217.6498130292" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2301 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2307 +#, no-c-format +msgid "ST_Length2D_Spheroid" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2309 +#, no-c-format +msgid "" +"Calculates the 2D length of a linestring/multilinestring on an ellipsoid. " +"This is useful if the coordinates of the geometry are in longitude/latitude " +"and a length is desired without reprojection." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2316 +#, no-c-format +msgid "" +"float ST_Length2D_Spheroid " +"geometry a_linestring spheroid a_spheroid" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2327 +#, no-c-format +msgid "" +"Calculates the 2D length of a geometry on an ellipsoid. This is useful if " +"the coordinates of the geometry are in longitude/latitude and a length is " +"desired without reprojection. The ellipsoid is a separate database type and " +"can be constructed as follows:" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2338 +#, no-c-format +msgid "" +"This is much like and except it will throw away the Z coordinate in " +"calculations." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2346 +#, no-c-format +msgid "" +"SELECT ST_Length2D_Spheroid( geometry_column,\n" +" 'SPHEROID[\"GRS_1980\",6378137,298.257222101]' )\n" +" FROM geometry_table;\n" +"\n" +"SELECT ST_Length2D_Spheroid( the_geom, sph_m ) As tot_len,\n" +"ST_Length2D_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" +"ST_Length2D_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n" +" FROM (SELECT " +"ST_GeomFromText('MULTILINESTRING((-118.584 38.374,-118.583 38.5),\n" +" (-71.05957 42.3589 , -71.061 43))') As the_geom,\n" +"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) " +"as foo;\n" +" tot_len | len_line1 | len_line2\n" +"------------------+------------------+------------------\n" +" 85204.5207562955 | 13986.8725229309 | 71217.6482333646\n" +"\n" +" --3D Observe same answer\n" +"SELECT ST_Length2D_Spheroid( the_geom, sph_m ) As tot_len,\n" +"ST_Length2D_Spheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,\n" +"ST_Length2D_Spheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2\n" +" FROM (SELECT " +"ST_GeomFromEWKT('MULTILINESTRING((-118.584 38.374 20,-118.583 38.5 30),\n" +" (-71.05957 42.3589 75, -71.061 43 90))') As the_geom,\n" +"CAST('SPHEROID[\"GRS_1980\",6378137,298.257222101]' As spheroid) As sph_m) " +"as foo;\n" +"\n" +" tot_len | len_line1 | len_line2\n" +"------------------+------------------+------------------\n" +" 85204.5207562955 | 13986.8725229309 | 71217.6482333646" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2353 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2359 +#, no-c-format +msgid "ST_3DLength_Spheroid" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2361 +#, no-c-format +msgid "" +"Calculates the length of a geometry on an ellipsoid, taking the " +"elevation into account. This is just an alias for ST_Length_Spheroid." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2367 +#, no-c-format +msgid "" +"float ST_3DLength_Spheroid " +"geometry a_linestring spheroid a_spheroid" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2378 +#, no-c-format +msgid "" +"Calculates the length of a geometry on an ellipsoid, taking the " +"elevation into account. This is just an alias for ST_Length_Spheroid." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2382 +#, no-c-format +msgid "" +"Changed: 2.0.0 In prior versions this used to return 0 for anything that is " +"not a MULTILINESTRING or LINESTRING and in 2.0.0 on returns the perimeter of " +"if given a polgon." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2383 +#, no-c-format +msgid "This function is just an alias for ST_Length_Spheroid." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2385 +#, no-c-format +msgid "" +"Changed: 2.0.0 In prior versions this used to be called ST_Length3d_Spheroid" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2392 +#, no-c-format +msgid "See ST_Length_Spheroid" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2399 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2405 +#, no-c-format +msgid "ST_LongestLine" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2407 +#, no-c-format +msgid "" +"Returns the 2-dimensional longest line points of two geometries. The " +"function will only return the first longest line if more than one, that the " +"function finds. The line returned will always start in g1 and end in g2. The " +"length of the line this function returns will always be the same as " +"st_maxdistance returns for g1 and g2." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2415 +#, no-c-format +msgid "" +"geometry ST_LongestLine " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2430 +#, no-c-format +msgid "" +"Returns the 2-dimensional longest line between the points of two geometries." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2448 +#, no-c-format +msgid "Longest line between point and line" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2451 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_LongestLine('POINT(100 100)'::geometry, \n" +" 'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)\n" +" ) As lline;\n" +"\n" +" \n" +" lline\n" +"-----------------\n" +"LINESTRING(100 100,98 190)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2459 +#, no-c-format +msgid "longest line between polygon and polygon" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2462 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_LongestLine(\n" +" ST_GeomFromText('POLYGON((175 150, 20 40, \n" +" 50 60, 125 100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" ) \n" +" ) As llinewkt;\n" +" \n" +" lline\n" +"-----------------\n" +"LINESTRING(20 40,121.111404660392 186.629392246051)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2478 +#, no-c-format +msgid "" +"longest straight distance to travel from one part of an elegant city to the " +"other Note the max distance = to the length of the line." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2482 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_LongestLine(c.the_geom, c.the_geom)) As llinewkt, \n" +" ST_MaxDistance(c.the_geom,c.the_geom) As max_dist, \n" +" ST_Length(ST_LongestLine(c.the_geom, c.the_geom)) As lenll \n" +"FROM (SELECT ST_BuildArea(ST_Collect(the_geom)) As the_geom\n" +" FROM (SELECT ST_Translate(ST_SnapToGrid(ST_Buffer(ST_Point(50 ," +"generate_series(50,190, 50) \n" +" ),40, 'quad_segs=2'),1), x, 0) As the_geom \n" +" FROM generate_series(1,100,50) As x) AS foo\n" +") As c;\n" +" \n" +" llinewkt | max_dist | lenll\n" +"---------------------------+------------------+------------------\n" +" LINESTRING(23 22,129 178) | 188.605408193933 | 188.605408193933" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2493 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2499 +#, no-c-format +msgid "ST_OrderingEquals" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2501 +#, no-c-format +msgid "" +"Returns true if the given geometries represent the same geometry and points " +"are in the same directional order." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2507 +#, no-c-format +msgid "" +"boolean ST_OrderingEquals " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2518 +#, no-c-format +msgid "" +"ST_OrderingEquals compares two geometries and returns t (TRUE) if the " +"geometries are equal and the coordinates are in the same order; otherwise it " +"returns f (FALSE)." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2523 +#, no-c-format +msgid "" +"This function is implemented as per the ArcSDE SQL specification rather than " +"SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3." +"htm#ST_OrderingEquals" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2527 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.43" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2533 +#, no-c-format +msgid "" +"SELECT ST_OrderingEquals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n" +" ST_GeomFromText('LINESTRING(0 0, 5 5, 10 10)'));\n" +" st_orderingequals\n" +"-----------\n" +" f\n" +"(1 row)\n" +"\n" +"SELECT ST_OrderingEquals(ST_GeomFromText('LINESTRING(0 0, 10 10)'),\n" +" ST_GeomFromText('LINESTRING(0 0, 0 0, 10 10)'));\n" +" st_orderingequals\n" +"-----------\n" +" t\n" +"(1 row)\n" +"\n" +"SELECT ST_OrderingEquals(ST_Reverse(ST_GeomFromText('LINESTRING(0 0, 10 " +"10)')),\n" +" ST_GeomFromText('LINESTRING(0 0, 0 0, 10 10)'));\n" +" st_orderingequals\n" +"-----------\n" +" f\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2537 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2543 +#, no-c-format +msgid "ST_Overlaps" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2545 +#, no-c-format +msgid "" +"Returns TRUE if the Geometries share space, are of the same dimension, but " +"are not completely contained by each other." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2550 +#, no-c-format +msgid "" +"boolean ST_Overlaps " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2561 +#, no-c-format +msgid "" +"Returns TRUE if the Geometries \"spatially overlap\". By that we mean they " +"intersect, but one does not completely contain another." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2566 reference_measure.xml:2892 +#: reference_measure.xml:2906 +#, no-c-format +msgid "Do not call with a GeometryCollection as an argument" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2568 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"index use, use the function _ST_Overlaps." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2576 reference_measure.xml:2912 +#: reference_measure.xml:3117 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2577 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.32" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2593 +#, no-c-format +msgid "MULTIPOINT / MULTIPOINT" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2617 +#, no-c-format +msgid "" +"--a point on a line is contained by the line and is of a lower dimension, " +"and therefore does not overlap the line\n" +" nor crosses\n" +"\n" +"SELECT ST_Overlaps(a,b) As a_overlap_b,\n" +" ST_Crosses(a,b) As a_crosses_b,\n" +" ST_Intersects(a, b) As a_intersects_b, ST_Contains(b,a) As " +"b_contains_a\n" +"FROM (SELECT ST_GeomFromText('POINT(1 0.5)') As a, " +"ST_GeomFromText('LINESTRING(1 0, 1 1, 3 5)') As b)\n" +" As foo\n" +"\n" +"a_overlap_b | a_crosses_b | a_intersects_b | b_contains_a\n" +"------------+-------------+----------------+--------------\n" +"f | f | t | t\n" +"\n" +"--a line that is partly contained by circle, but not fully is defined as " +"intersecting and crossing,\n" +"-- but since of different dimension it does not overlap\n" +"SELECT ST_Overlaps(a,b) As a_overlap_b, ST_Crosses(a,b) As a_crosses_b,\n" +" ST_Intersects(a, b) As a_intersects_b,\n" +" ST_Contains(a,b) As a_contains_b\n" +"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 0.5)'), 3) As a, " +"ST_GeomFromText('LINESTRING(1 0, 1 1, 3 5)') As b)\n" +" As foo;\n" +"\n" +" a_overlap_b | a_crosses_b | a_intersects_b | a_contains_b\n" +"-------------+-------------+----------------+--------------\n" +" f | t | t | f\n" +"\n" +" -- a 2-dimensional bent hot dog (aka buffered line string) that intersects " +"a circle,\n" +" -- but is not fully contained by the circle is defined as " +"overlapping since they are of the same dimension,\n" +"-- but it does not cross, because the intersection of the 2 is of the " +"same dimension\n" +"-- as the maximum dimension of the 2\n" +"\n" +"SELECT ST_Overlaps(a,b) As a_overlap_b, ST_Crosses(a,b) As a_crosses_b, " +"ST_Intersects(a, b) As a_intersects_b,\n" +"ST_Contains(b,a) As b_contains_a,\n" +"ST_Dimension(a) As dim_a, ST_Dimension(b) as dim_b, " +"ST_Dimension(ST_Intersection(a,b)) As dima_intersection_b\n" +"FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 0.5)'), 3) As a,\n" +" ST_Buffer(ST_GeomFromText('LINESTRING(1 0, 1 1, 3 5)'),0.5) As b)\n" +" As foo;\n" +"\n" +" a_overlap_b | a_crosses_b | a_intersects_b | b_contains_a | dim_a | dim_b | " +"dima_intersection_b\n" +"-------------+-------------+----------------+--------------+-------+-------" +"+---------------------\n" +" t | f | t | f | 2 | 2 " +"| 2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2625 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2630 +#, no-c-format +msgid "ST_Perimeter" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2632 +#, no-c-format +msgid "" +"Return the length measurement of the boundary of an ST_Surface or " +"ST_MultiSurface geometry or geography. (Polygon, Multipolygon). geometry " +"measurement is in units of spatial reference and geography is in meters." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2637 +#, no-c-format +msgid "" +"float ST_Perimeter " +"geometry g1" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2643 +#, no-c-format +msgid "" +"float ST_Perimeter " +"geography geog " +"boolean use_spheroid=true" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2653 +#, no-c-format +msgid "" +"Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, " +"ST_MultiSurface (Polygon, Multipolygon). 0 is returned for non-areal " +"geometries. For linestrings use ST_Length. Measurements for geometry are in " +"the units of the spatial reference system of the geometry. Measurements for " +"geography are in meters. If use_spheroid is set to false, " +"then will model earth as a sphere instead of a spheroid." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2658 +#, no-c-format +msgid "" +"Currently this is an alias for ST_Perimeter2D, but this may change to " +"support higher dimensions." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2661 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 8.1.3, 9.5.4" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2662 +#, no-c-format +msgid "Availability 2.0.0: Support for geography was introduced" +msgstr "" + +#. Tag: title +#: reference_measure.xml:2666 +#, no-c-format +msgid "Examples: Geometry" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2667 +#, no-c-format +msgid "" +"Return perimeter in feet for polygon and multipolygon. Note this is in feet " +"because 2249 is Mass State Plane Feet" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2669 +#, no-c-format +msgid "" +"SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 " +"2967450,743265 2967450,\n" +"743265.625 2967416,743238 2967416))', 2249));\n" +"st_perimeter\n" +"---------\n" +" 122.630744000095\n" +"(1 row)\n" +"\n" +"SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((763104.471273676 " +"2949418.44119003,\n" +"763104.477769673 2949418.42538203,\n" +"763104.189609677 2949418.22343004,763104.471273676 2949418.44119003)),\n" +"((763104.471273676 2949418.44119003,763095.804579742 2949436.33850239,\n" +"763086.132105649 2949451.46730207,763078.452329651 2949462.11549407,\n" +"763075.354136904 2949466.17407812,763064.362142565 2949477.64291974,\n" +"763059.953961626 2949481.28983009,762994.637609571 2949532.04103014,\n" +"762990.568508415 2949535.06640477,762986.710889563 2949539.61421415,\n" +"763117.237897679 2949709.50493431,763235.236617789 2949617.95619822,\n" +"763287.718121842 2949562.20592617,763111.553321674 2949423.91664605,\n" +"763104.471273676 2949418.44119003)))', 2249));\n" +"st_perimeter\n" +"---------\n" +" 845.227713366825\n" +"(1 row)" +msgstr "" + +#. Tag: title +#: reference_measure.xml:2672 +#, no-c-format +msgid "Examples: Geography" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2673 +#, no-c-format +msgid "" +"Return perimeter in meters and feet for polygon and multipolygon. Note this " +"is geography (WGS 84 long lat)" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2674 +#, no-c-format +msgid "" +"SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog)/0.3048 As " +"per_ft \n" +"FROM ST_GeogFromText('POLYGON((-71.1776848522251 " +"42.3902896512902,-71.1776843766326 42.3903829478009,\n" +"-71.1775844305465 42.3903826677917,-71.1775825927231 " +"42.3902893647987,-71.1776848522251 42.3902896512902))') As geog;\n" +"\n" +" per_meters | per_ft\n" +"-----------------+------------------\n" +"37.3790462565251 | 122.634666195949\n" +"\n" +"\n" +"-- Multipolygon example --\n" +"SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog,false) As " +"per_sphere_meters, ST_Perimeter(geog)/0.3048 As per_ft \n" +"FROM ST_GeogFromText('MULTIPOLYGON(((-71.1044543107478 " +"42.340674480411,-71.1044542869917 42.3406744369506,\n" +"-71.1044553562977 42.340673886454,-71.1044543107478 42.340674480411)),\n" +"((-71.1044543107478 42.340674480411,-71.1044860600303 " +"42.3407237015564,-71.1045215770124 42.3407653385914,\n" +"-71.1045498002983 42.3407946553165,-71.1045611902745 " +"42.3408058316308,-71.1046016507427 42.340837442371,\n" +"-71.104617893173 42.3408475056957,-71.1048586153981 " +"42.3409875993595,-71.1048736143677 42.3409959528211,\n" +"-71.1048878050242 42.3410084812078,-71.1044020965803 42.3414730072048,\n" +"-71.1039672113619 42.3412202916693,-71.1037740497748 42.3410666421308,\n" +"-71.1044280218456 42.3406894151355,-71.1044543107478 42.340674480411)))') As " +"geog;\n" +"\n" +" per_meters | per_sphere_meters | per_ft\n" +"------------------+-------------------+------------------\n" +" 257.634283683311 | 257.412311446337 | 845.256836231335" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2678 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2684 +#, no-c-format +msgid "ST_Perimeter2D" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2686 +#, no-c-format +msgid "" +"Returns the 2-dimensional perimeter of the geometry, if it is a polygon or " +"multi-polygon. This is currently an alias for ST_Perimeter." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2692 +#, no-c-format +msgid "" +"float ST_Perimeter2D " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2702 +#, no-c-format +msgid "" +"Returns the 2-dimensional perimeter of the geometry, if it is a polygon or " +"multi-polygon." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2707 +#, no-c-format +msgid "" +"This is currently an alias for ST_Perimeter. In future versions ST_Perimeter " +"may return the highest dimension perimeter for a geometry. This is still " +"under consideration" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2721 +#, no-c-format +msgid "ST_3DPerimeter" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2723 +#, no-c-format +msgid "" +"Returns the 3-dimensional perimeter of the geometry, if it is a polygon or " +"multi-polygon." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2729 +#, no-c-format +msgid "" +"float ST_3DPerimeter " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2739 +#, no-c-format +msgid "" +"Returns the 3-dimensional perimeter of the geometry, if it is a polygon or " +"multi-polygon. If the geometry is 2-dimensional, then the 2-dimensional " +"perimeter is returned." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2742 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2748 +#, no-c-format +msgid "" +"Perimeter of a slightly elevated polygon in the air in Massachusetts state " +"plane feet" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2749 +#, no-c-format +msgid "" +"SELECT ST_3DPerimeter(the_geom), ST_Perimeter2d(the_geom), " +"ST_Perimeter(the_geom) FROM\n" +" (SELECT ST_GeomFromEWKT('SRID=2249;POLYGON((743238 " +"2967416 2,743238 2967450 1,\n" +"743265.625 2967416 1,743238 2967416 2))') As the_geom) As foo;\n" +"\n" +" ST_3DPerimeter | st_perimeter2d | st_perimeter\n" +"------------------+------------------+------------------\n" +" 105.465793597674 | 105.432997272188 | 105.432997272188" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2756 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2762 +#, no-c-format +msgid "ST_PointOnSurface" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2764 +#, no-c-format +msgid "Returns a POINT guaranteed to lie on the surface." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2769 +#, no-c-format +msgid "" +"geometry ST_PointOnSurface " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2781 +#, no-c-format +msgid "Returns a POINT guaranteed to intersect a surface." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2783 +#, no-c-format +msgid "&sfs_compliant; s3.2.14.2 // s3.2.18.2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2784 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6. According to the specs, " +"ST_PointOnSurface works for surface geometries (POLYGONs, MULTIPOLYGONS, " +"CURVED POLYGONS). So PostGIS seems to be extending what the spec allows " +"here. Most databases Oracle,DB II, ESRI SDE seem to only support this " +"function for surfaces. SQL Server 2008 like PostGIS supports for all common " +"geometries." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2793 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_PointOnSurface('POINT(0 5)'::geometry));\n" +" st_astext\n" +"------------\n" +" POINT(0 5)\n" +"(1 row)\n" +"\n" +"SELECT ST_AsText(ST_PointOnSurface('LINESTRING(0 5, 0 10)'::geometry));\n" +" st_astext\n" +"------------\n" +" POINT(0 5)\n" +"(1 row)\n" +"\n" +"SELECT ST_AsText(ST_PointOnSurface('POLYGON((0 0, 0 5, 5 5, 5 0, 0 0))'::" +"geometry));\n" +" st_astext\n" +"----------------\n" +" POINT(2.5 2.5)\n" +"(1 row)\n" +"\n" +"SELECT ST_AsEWKT(ST_PointOnSurface(ST_GeomFromEWKT('LINESTRING(0 5 1, 0 0 1, " +"0 10 2)')));\n" +" st_asewkt\n" +"----------------\n" +" POINT(0 0 1)\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2799 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2805 +#, no-c-format +msgid "ST_Project" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2807 +#, no-c-format +msgid "" +"Returns a POINT projected from a start point using a " +"bearing and distance." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2812 +#, no-c-format +msgid "" +"geography ST_Project " +"geography g1 " +"float distance " +"float azimuth" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2828 +#, no-c-format +msgid "" +"Returns a POINT projected from a start point using an " +"azimuth (bearing) and distance." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2829 +#, no-c-format +msgid "" +"Distance, azimuth and projection are all aspects of the same operation, " +"describing (or in the case of projection, constructing) the relationship " +"between two points on the world." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2830 +#, no-c-format +msgid "" +"The azimuth is sometimes called the heading or the bearing in navigation. It " +"is measured relative to true north (azimuth zero). East is azimuth 90, south " +"is azimuth 180, west is azimuth 270." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2831 +#, no-c-format +msgid "The distance is given in meters." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2838 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, 45));\n" +" st_astext\n" +" ------------------------------------------\n" +" POINT(0.63523102912532 0.63947233472882)\n" +" (1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2844 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2850 +#, no-c-format +msgid "ST_Relate" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2852 +#, no-c-format +msgid "" +"Returns true if this Geometry is spatially related to anotherGeometry, by " +"testing for intersections between the Interior, Boundary and Exterior of the " +"two geometries as specified by the values in the intersectionMatrixPattern. " +"If no intersectionMatrixPattern is passed in, then returns the maximum " +"intersectionMatrixPattern that relates the 2 geometries." +msgstr "" + +#. Tag: funcsynopsis +#: reference_measure.xml:2860 +#, no-c-format +msgid "" +" boolean ST_Relate " +"geometry geomA " +"geometry geomB " +"text intersectionMatrixPattern text " +"ST_Relate geometry " +"geomA geometry " +"geomB " +"text ST_Relate " +"geometry geomA " +"geometry geomB " +"int BoundaryNodeRule " +msgstr "" + +#. Tag: para +#: reference_measure.xml:2886 +#, no-c-format +msgid "" +"Version 1: Takes geomA, geomB, intersectionMatrix and Returns 1 (TRUE) if " +"this Geometry is spatially related to anotherGeometry, by testing for " +"intersections between the Interior, Boundary and Exterior of the two " +"geometries as specified by the values in the DE-9IM matrix pattern." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2891 +#, no-c-format +msgid "" +"This is especially useful for testing compound checks of intersection, " +"crosses, etc in one step." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2894 +#, no-c-format +msgid "" +"This is the \"allowable\" version that returns a boolean, not an integer. " +"This is defined in OGC spec" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2897 +#, no-c-format +msgid "" +"This DOES NOT automagically include an index call. The reason for that is " +"some relationships are anti e.g. Disjoint. If you are using a relationship " +"pattern that requires intersection, then include the && index call." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2902 +#, no-c-format +msgid "" +"Version 2: Takes geomA and geomB and returns the " +msgstr "" + +#. Tag: para +#: reference_measure.xml:2904 +#, no-c-format +msgid "" +"Version 3: same as version 2 bu allows to specify a boundary node rule (1:" +"OGC/MOD2, 2:Endpoint, 3:MultivalentEndpoint, 4:MonovalentEndpoint)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2908 +#, no-c-format +msgid "not in OGC spec, but implied. see s2.1.13.2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2913 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2914 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 - added support for specifying boundary node rule (requires " +"GEOS >= 3.0)." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2921 +#, no-c-format +msgid "" +"--Find all compounds that intersect and not touch a poly (interior " +"intersects)\n" +"SELECT l.* , b.name As poly_name\n" +" FROM polys As b\n" +"INNER JOIN compounds As l\n" +"ON (p.the_geom && b.the_geom\n" +"AND ST_Relate(l.the_geom, b.the_geom,'T********'));\n" +"\n" +"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), " +"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2));\n" +"st_relate\n" +"-----------\n" +"0FFFFF212\n" +"\n" +"SELECT ST_Relate(ST_GeometryFromText('LINESTRING(1 2, 3 4)'), " +"ST_GeometryFromText('LINESTRING(5 6, 7 8)'));\n" +"st_relate\n" +"-----------\n" +"FF1FF0102\n" +"\n" +"\n" +"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), " +"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2), '0FFFFF212');\n" +"st_relate\n" +"-----------\n" +"t\n" +"\n" +"SELECT ST_Relate(ST_GeometryFromText('POINT(1 2)'), " +"ST_Buffer(ST_GeometryFromText('POINT(1 2)'),2), '*FF*FF212');\n" +"st_relate\n" +"-----------\n" +"t" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2928 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2934 +#, no-c-format +msgid "ST_RelateMatch" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2936 +#, no-c-format +msgid "" +"Returns true if intersectionMattrixPattern1 implies " +"intersectionMatrixPattern2" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2941 +#, no-c-format +msgid "" +"boolean ST_RelateMatch " +"text intersectionMatrix text intersectionMatrixPattern" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2952 +#, no-c-format +msgid "" +"Takes intersectionMatrix and intersectionMatrixPattern and Returns true if " +"the intersectionMatrix satisfies the intersectionMatrixPattern. For more " +"information refer to ." +msgstr "" + +#. Tag: para +#: reference_measure.xml:2955 +#, no-c-format +msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:2961 +#, no-c-format +msgid "" +"SELECT ST_RelateMatch('101202FFF', 'TTTTTTFFF') ;\n" +"-- result --\n" +"t\n" +"--example of common intersection matrix patterns and example matrices\n" +"-- comparing relationships of involving one invalid geometry and ( a line " +"and polygon that intersect at interior and boundary)\n" +"SELECT mat.name, pat.name, ST_RelateMatch(mat.val, pat.val) As satisfied\n" +" FROM \n" +" ( VALUES ('Equality', 'T1FF1FFF1'),\n" +" ('Overlaps', 'T*T***T**'),\n" +" ('Within', 'T*F**F***'),\n" +" ('Disjoint', 'FF*FF****') As pat(name,val)\n" +" CROSS JOIN \n" +" ( VALUES ('Self intersections (invalid)', '111111111'),\n" +" ('IE2_BI1_BB0_BE1_EI1_EE2', 'FF2101102'),\n" +" ('IB1_IE1_BB0_BE0_EI2_EI1_EE2', 'F11F00212')\n" +" ) As mat(name,val);" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2967 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:2973 +#, no-c-format +msgid "ST_ShortestLine" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:2975 +#, no-c-format +msgid "Returns the 2-dimensional shortest line between two geometries" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:2980 +#, no-c-format +msgid "" +"geometry ST_ShortestLine " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:2995 +#, no-c-format +msgid "" +"Returns the 2-dimensional shortest line between two geometries. The function " +"will only return the first shortest line if more than one, that the function " +"finds. If g1 and g2 intersects in just one point the function will return a " +"line with both start and end in that intersection-point. If g1 and g2 are " +"intersecting with more than one point the function will return a line with " +"start and end in the same point but it can be any of the intersecting " +"points. The line returned will always start in g1 and end in g2. The length " +"of the line this function returns will always be the same as st_distance " +"returns for g1 and g2." +msgstr "" + +#. Tag: para +#: reference_measure.xml:3019 +#, no-c-format +msgid "Shortest line between point and linestring" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:3022 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_ShortestLine('POINT(100 100)'::geometry, \n" +" 'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)\n" +" ) As sline;\n" +"\n" +" \n" +" sline\n" +"-----------------\n" +"LINESTRING(100 100,73.0769230769231 115.384615384615)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3030 +#, no-c-format +msgid "shortest line between polygon and polygon" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:3033 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_ShortestLine(\n" +" ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 " +"100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" ) \n" +" ) As slinewkt;\n" +" \n" +" LINESTRING(140.752120669087 125.695053378061,121.111404660392 " +"153.370607753949)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3045 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_measure.xml:3051 +#, no-c-format +msgid "ST_Touches" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:3053 +#, no-c-format +msgid "" +"Returns TRUE if the geometries have at least one point in " +"common, but their interiors do not intersect." +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:3059 +#, no-c-format +msgid "" +"boolean ST_Touches " +"geometry g1 " +"geometry g2" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3074 +#, no-c-format +msgid "" +"Returns TRUE if the only points in common between " +"g1 and g2 lie in the union of " +"the boundaries of g1 and g2. " +"The ST_Touches relation applies to all Area/Area, Line/" +"Line, Line/Area, Point/Area and Point/Line pairs of relationships, but " +"not to the Point/Point pair." +msgstr "" + +#. Tag: para +#: reference_measure.xml:3081 +#, no-c-format +msgid "In mathematical terms, this predicate is expressed as:" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3091 +#, no-c-format +msgid "The allowable DE-9IM Intersection Matrices for the two geometries are:" +msgstr "" + +#. Tag: markup +#: reference_measure.xml:3095 +#, no-c-format +msgid "FT*******" +msgstr "" + +#. Tag: markup +#: reference_measure.xml:3099 +#, no-c-format +msgid "F**T*****" +msgstr "" + +#. Tag: markup +#: reference_measure.xml:3103 +#, no-c-format +msgid "F***T****" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3112 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"using an index, use _ST_Touches instead." +msgstr "" + +#. Tag: para +#: reference_measure.xml:3118 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.28" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3124 +#, no-c-format +msgid "" +"The ST_Touches predicate returns TRUE in all the following illustrations." +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:3194 +#, no-c-format +msgid "" +"SELECT ST_Touches('LINESTRING(0 0, 1 1, 0 2)'::geometry, 'POINT(1 1)'::" +"geometry);\n" +" st_touches\n" +"------------\n" +" f\n" +"(1 row)\n" +"\n" +"SELECT ST_Touches('LINESTRING(0 0, 1 1, 0 2)'::geometry, 'POINT(0 2)'::" +"geometry);\n" +" st_touches\n" +"------------\n" +" t\n" +"(1 row)" +msgstr "" + +#. Tag: refname +#: reference_measure.xml:3200 +#, no-c-format +msgid "ST_Within" +msgstr "" + +#. Tag: refpurpose +#: reference_measure.xml:3202 +#, no-c-format +msgid "Returns true if the geometry A is completely inside geometry B" +msgstr "" + +#. Tag: funcprototype +#: reference_measure.xml:3207 +#, no-c-format +msgid "" +"boolean ST_Within " +"geometry A " +"geometry B" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3222 +#, no-c-format +msgid "" +"Returns TRUE if geometry A is completely inside geometry B. For this " +"function to make sense, the source geometries must both be of the same " +"coordinate projection, having the same SRID. It is a given that if " +"ST_Within(A,B) is true and ST_Within(B,A) is true, then the two geometries " +"are considered spatially equal." +msgstr "" + +#. Tag: para +#: reference_measure.xml:3237 +#, no-c-format +msgid "" +"This function call will automatically include a bounding box comparison that " +"will make use of any indexes that are available on the geometries. To avoid " +"index use, use the function _ST_Within." +msgstr "" + +#. Tag: para +#: reference_measure.xml:3245 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***')" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3248 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.30" +msgstr "" + +#. Tag: programlisting +#: reference_measure.xml:3253 +#, no-c-format +msgid "" +"--a circle within a circle\n" +"SELECT ST_Within(smallc,smallc) As smallinsmall,\n" +" ST_Within(smallc, bigc) As smallinbig,\n" +" ST_Within(bigc,smallc) As biginsmall,\n" +" ST_Within(ST_Union(smallc, bigc), bigc) as unioninbig,\n" +" ST_Within(bigc, ST_Union(smallc, bigc)) as biginunion,\n" +" ST_Equals(bigc, ST_Union(smallc, bigc)) as bigisunion\n" +"FROM\n" +"(\n" +"SELECT ST_Buffer(ST_GeomFromText('POINT(50 50)'), 20) As smallc,\n" +" ST_Buffer(ST_GeomFromText('POINT(50 50)'), 40) As bigc) As foo;\n" +"--Result\n" +" smallinsmall | smallinbig | biginsmall | unioninbig | biginunion | " +"bigisunion\n" +"--------------+------------+------------+------------+------------" +"+------------\n" +" t | t | f | t | t | t\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_measure.xml:3264 +#, no-c-format +msgid ", , " +msgstr "" diff --git a/doc/po/pl/reference_misc.xml.po b/doc/po/pl/reference_misc.xml.po new file mode 100644 index 000000000..31c5dc896 --- /dev/null +++ b/doc/po/pl/reference_misc.xml.po @@ -0,0 +1,858 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_misc.xml:3 +#, no-c-format +msgid "Miscellaneous Functions" +msgstr "" + +#. Tag: refname +#: reference_misc.xml:7 +#, no-c-format +msgid "ST_Accum" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:9 +#, no-c-format +msgid "Aggregate. Constructs an array of geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:14 +#, no-c-format +msgid "" +"geometry[] ST_Accum " +"geometry set geomfield" +msgstr "" + +#. Tag: title +#: reference_misc.xml:22 reference_misc.xml:64 reference_misc.xml:106 +#: reference_misc.xml:158 reference_misc.xml:229 reference_misc.xml:289 +#: reference_misc.xml:343 reference_misc.xml:396 reference_misc.xml:438 +#: reference_misc.xml:488 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_misc.xml:24 +#, no-c-format +msgid "Aggregate. Constructs an array of geometries." +msgstr "" + +#. Tag: para +#: reference_misc.xml:25 reference_misc.xml:68 reference_misc.xml:109 +#: reference_misc.xml:255 reference_misc.xml:309 reference_misc.xml:355 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_misc.xml:26 reference_misc.xml:113 reference_misc.xml:357 +#: reference_misc.xml:447 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_misc.xml:27 reference_misc.xml:69 reference_misc.xml:110 +#: reference_misc.xml:183 reference_misc.xml:358 reference_misc.xml:448 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_misc.xml:28 reference_misc.xml:70 reference_misc.xml:111 +#: reference_misc.xml:256 reference_misc.xml:310 reference_misc.xml:359 +#: reference_misc.xml:449 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_misc.xml:29 reference_misc.xml:71 reference_misc.xml:112 +#: reference_misc.xml:257 reference_misc.xml:311 reference_misc.xml:360 +#: reference_misc.xml:450 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: title +#: reference_misc.xml:34 reference_misc.xml:76 reference_misc.xml:118 +#: reference_misc.xml:188 reference_misc.xml:262 reference_misc.xml:316 +#: reference_misc.xml:364 reference_misc.xml:408 reference_misc.xml:455 +#: reference_misc.xml:499 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:36 +#, no-c-format +msgid "" +"SELECT (ST_Accum(the_geom)) As all_em, ST_AsText((ST_Accum(the_geom))[1]) As " +"grabone,\n" +"(ST_Accum(the_geom))[2:4] as grab_rest\n" +" FROM (SELECT ST_MakePoint(a*CAST(random()*10 As " +"integer), a*CAST(random()*10 As integer), a*CAST(random()*10 As integer)) As " +"the_geom\n" +" FROM generate_series(1,4) a) As foo;\n" +"\n" +"all_em|grabone | grab_rest\n" +"\n" +"-------------------------------------------------------------------------------" +"+\n" +"\n" +" {0101000080000000000000144000000000000024400000000000001040:\n" +" 0101000080000000000\n" +"00018400000000000002C400000000000003040:\n" +"0101000080000000000000354000000000000038400000000000001840:\n" +"010100008000000000000040400000000000003C400000000000003040} |\n" +" POINT(5 10) | {010100008000000000000018400000000000002C400000000000003040:\n" +" 0101000080000000000000354000000000000038400000000000001840:\n" +" 010100008000000000000040400000000000003C400000000000003040}\n" +"(1 row)" +msgstr "" + +#. Tag: title +#: reference_misc.xml:41 reference_misc.xml:83 reference_misc.xml:125 +#: reference_misc.xml:195 reference_misc.xml:268 reference_misc.xml:322 +#: reference_misc.xml:369 reference_misc.xml:415 reference_misc.xml:462 +#: reference_misc.xml:506 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: reference_misc.xml:49 +#, no-c-format +msgid "Box2D" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:51 +#, no-c-format +msgid "" +"Returns a BOX2D representing the maximum extents of the geometry." +"" +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:56 +#, no-c-format +msgid "" +"box2d Box2D geometry " +" geomA" +msgstr "" + +#. Tag: para +#: reference_misc.xml:66 +#, no-c-format +msgid "" +"Returns a BOX2D representing the maximum extents of the geometry." +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:78 +#, no-c-format +msgid "" +"SELECT Box2D(ST_GeomFromText('LINESTRING(1 2, 3 4, 5 6)'));\n" +" box2d\n" +" ---------\n" +" BOX(1 2,5 6)\n" +"\n" +" SELECT Box2D(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 " +"150505,220227 150406)'));\n" +" box2d\n" +" --------\n" +" BOX(220186.984375 150406,220288.25 150506.140625)" +msgstr "" + +#. Tag: para +#: reference_misc.xml:85 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_misc.xml:91 +#, no-c-format +msgid "Box3D" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:93 +#, no-c-format +msgid "" +"Returns a BOX3D representing the maximum extents of the geometry." +"" +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:98 +#, no-c-format +msgid "" +"box3d Box3D geometry " +" geomA" +msgstr "" + +#. Tag: para +#: reference_misc.xml:108 +#, no-c-format +msgid "" +"Returns a BOX3D representing the maximum extents of the geometry." +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:120 +#, no-c-format +msgid "" +"SELECT Box3D(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 5, 5 6 5)'));\n" +" Box3d\n" +" ---------\n" +" BOX3D(1 2 3,5 6 5)\n" +"\n" +" SELECT Box3D(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 " +"150505 1,220227 150406 1)'));\n" +" Box3d\n" +" --------\n" +" BOX3D(220227 150406 1,220268 150415 1)" +msgstr "" + +#. Tag: para +#: reference_misc.xml:127 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_misc.xml:133 +#, no-c-format +msgid "ST_EstimatedExtent" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:135 +#, no-c-format +msgid "" +"Return the 'estimated' extent of the given spatial table. The " +"estimated is taken from the geometry column's statistics. The current schema " +"will be used if not specified." +msgstr "" + +#. Tag: funcsynopsis +#: reference_misc.xml:141 +#, no-c-format +msgid "" +" box2d ST_EstimatedExtent text schema_name text table_name text geocolumn_name box2d " +"ST_EstimatedExtent text table_name text geocolumn_name " +msgstr "" + +#. Tag: para +#: reference_misc.xml:160 +#, no-c-format +msgid "" +"Return the 'estimated' extent of the given spatial table. The " +"estimated is taken from the geometry column's statistics. The current schema " +"will be used if not specified." +msgstr "" + +#. Tag: para +#: reference_misc.xml:164 +#, no-c-format +msgid "" +"For PostgreSQL>=8.0.0 statistics are gathered by VACUUM ANALYZE and " +"resulting extent will be about 95% of the real one." +msgstr "" + +#. Tag: para +#: reference_misc.xml:169 +#, no-c-format +msgid "" +"In absence of statistics (empty table or no ANALYZE called) this function " +"returns NULL. Prior to version 1.5.4 an exception was thrown instead." +msgstr "" + +#. Tag: para +#: reference_misc.xml:177 +#, no-c-format +msgid "" +"For PostgreSQL<8.0.0 statistics are gathered by update_geometry_stats() " +"and resulting extent will be exact." +msgstr "" + +#. Tag: para +#: reference_misc.xml:180 +#, no-c-format +msgid "Availability: 1.0.0" +msgstr "" + +#. Tag: para +#: reference_misc.xml:181 +#, no-c-format +msgid "Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent." +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:190 +#, no-c-format +msgid "" +"SELECT ST_EstimatedExtent('ny', 'edges', 'the_geom');\n" +"--result--\n" +"BOX(-8877653 4912316,-8010225.5 5589284)\n" +"\n" +"SELECT ST_EstimatedExtent('feature_poly', 'the_geom');\n" +"--result--\n" +"BOX(-124.659652709961 24.6830825805664,-67.7798080444336 49.0012092590332)" +msgstr "" + +#. Tag: refname +#: reference_misc.xml:202 +#, no-c-format +msgid "ST_Expand" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:203 +#, no-c-format +msgid "" +"Returns bounding box expanded in all directions from the bounding box of the " +"input geometry. Uses double-precision" +msgstr "" + +#. Tag: funcsynopsis +#: reference_misc.xml:207 +#, no-c-format +msgid "" +" geometry ST_Expand " +"geometry g1 " +"float units_to_expand box2d " +"ST_Expand box2d " +"g1 float " +"units_to_expand " +" box3d ST_Expand " +"box3d g1 " +"float units_to_expand " +msgstr "" + +#. Tag: para +#: reference_misc.xml:231 +#, no-c-format +msgid "" +"This function returns a bounding box expanded in all directions from the " +"bounding box of the input geometry, by an amount specified in the second " +"argument. Uses double-precision. Very useful for distance() queries, or " +"bounding box queries to add an index filter to the query." +msgstr "" + +#. Tag: para +#: reference_misc.xml:235 +#, no-c-format +msgid "" +"There are 3 variants of this. The one that takes a geometry will return a " +"POLYGON geometry representation of the bounding box and is the most commonly " +"used variant." +msgstr "" + +#. Tag: para +#: reference_misc.xml:237 +#, no-c-format +msgid "" +"ST_Expand is similar in concept to ST_Buffer except while buffer expands the " +"geometry in all directions, ST_Expand expands the bounding box an x,y,z unit " +"amount." +msgstr "" + +#. Tag: para +#: reference_misc.xml:239 +#, no-c-format +msgid "" +"Units are in the units of the spatial reference system in use denoted by the " +"SRID" +msgstr "" + +#. Tag: para +#: reference_misc.xml:242 +#, no-c-format +msgid "" +"Pre 1.3, ST_Expand was used in conjunction with distance to do indexable " +"queries. Something of the form the_geom && ST_Expand('POINT(10 " +"20)', 10) AND ST_Distance(the_geom, 'POINT(10 20)') < 10 Post 1.2, " +"this was replaced with the easier ST_DWithin construct." +msgstr "" + +#. Tag: para +#: reference_misc.xml:248 +#, no-c-format +msgid "" +"Bounding boxes of all geometries are currently 2-d even if they are 3-" +"dimensional geometries." +msgstr "" + +#. Tag: para +#: reference_misc.xml:252 +#, no-c-format +msgid "" +"Availability: 1.5.0 behavior changed to output double precision instead of " +"float4 coordinates." +msgstr "" + +#. Tag: para +#: reference_misc.xml:263 +#, no-c-format +msgid "" +"Examples below use US National Atlas Equal Area (SRID=2163) which is a meter " +"projection" +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:264 +#, no-c-format +msgid "" +"\n" +"--10 meter expanded box around bbox of a linestring\n" +"SELECT CAST(ST_Expand(ST_GeomFromText('LINESTRING(2312980 110676,2312923 " +"110701,2312892 110714)', 2163),10) As box2d);\n" +" st_expand\n" +"------------------------------------\n" +" BOX(2312882 110666,2312990 110724)\n" +"\n" +"--10 meter expanded 3d box of a 3d box\n" +"SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' " +"As box3d),10)\n" +" st_expand\n" +"-----------------------------------------------------\n" +" BOX3D(778773 2951731 -9,794885 2970052.61545891 20)\n" +"\n" +" --10 meter geometry astext rep of a expand box around a point geometry\n" +" SELECT ST_AsEWKT(ST_Expand(ST_GeomFromEWKT('SRID=2163;POINT(2312980 " +"110676)'),10));\n" +" st_asewkt\n" +"-------------------------------------------------------------------------------------------------\n" +" SRID=2163;POLYGON((2312970 110666,2312970 110686,2312990 110686,2312990 " +"110666,2312970 110666))" +msgstr "" + +#. Tag: para +#: reference_misc.xml:269 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_misc.xml:275 +#, no-c-format +msgid "ST_Extent" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:276 +#, no-c-format +msgid "" +"an aggregate function that returns the bounding box that bounds rows of " +"geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:281 +#, no-c-format +msgid "" +"box2d ST_Extent " +"geometry set geomfield" +msgstr "" + +#. Tag: para +#: reference_misc.xml:291 +#, no-c-format +msgid "" +"ST_Extent returns a bounding box that encloses a set of geometries. The " +"ST_Extent function is an \"aggregate\" function in the terminology of SQL. " +"That means that it operates on lists of data, in the same way the SUM() and " +"AVG() functions do." +msgstr "" + +#. Tag: para +#: reference_misc.xml:294 reference_misc.xml:348 +#, no-c-format +msgid "" +"Since it returns a bounding box, the spatial Units are in the units of the " +"spatial reference system in use denoted by the SRID" +msgstr "" + +#. Tag: para +#: reference_misc.xml:295 +#, no-c-format +msgid "" +"ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR" +msgstr "" + +#. Tag: para +#: reference_misc.xml:297 +#, no-c-format +msgid "" +"Since ST_Extent returns a bounding box, the SRID meta-data is lost. Use " +"ST_SetSRID to force it back into a geometry with SRID meta data. The " +"coordinates are in the units of the spatial ref of the orginal geometries." +msgstr "" + +#. Tag: para +#: reference_misc.xml:302 +#, no-c-format +msgid "" +"ST_Extent will return boxes with only an x and y component even with (x,y,z) " +"coordinate geometries. To maintain x,y,z use ST_3DExtent instead." +msgstr "" + +#. Tag: para +#: reference_misc.xml:306 +#, no-c-format +msgid "Availability: 1.4.0" +msgstr "" + +#. Tag: para +#: reference_misc.xml:317 +#, no-c-format +msgid "Examples below use Massachusetts State Plane ft (SRID=2249)" +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:318 +#, no-c-format +msgid "" +"SELECT ST_Extent(the_geom) as bextent FROM sometable;\n" +" st_bextent\n" +"------------------------------------\n" +"BOX(739651.875 2908247.25,794875.8125 2970042.75)\n" +"\n" +"\n" +"--Return extent of each category of geometries\n" +"SELECT ST_Extent(the_geom) as bextent\n" +"FROM sometable\n" +"GROUP BY category ORDER BY category;\n" +"\n" +" bextent " +"| name\n" +"----------------------------------------------------+----------------\n" +" BOX(778783.5625 2951741.25,794875.8125 2970042.75) | A\n" +" BOX(751315.8125 2919164.75,765202.6875 2935417.25) | B\n" +" BOX(739651.875 2917394.75,756688.375 2935866) | C\n" +"\n" +" --Force back into a geometry\n" +" -- and render the extended text representation of that geometry\n" +"SELECT ST_SetSRID(ST_Extent(the_geom),2249) as bextent FROM sometable;\n" +"\n" +" bextent\n" +"--------------------------------------------------------------------------------\n" +" SRID=2249;POLYGON((739651.875 2908247.25,739651.875 2970042.75,794875.8125 " +"2970042.75,\n" +" 794875.8125 2908247.25,739651.875 2908247.25))" +msgstr "" + +#. Tag: para +#: reference_misc.xml:323 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_misc.xml:329 +#, no-c-format +msgid "ST_3DExtent" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:330 +#, no-c-format +msgid "" +"an aggregate function that returns the box3D bounding box that bounds rows " +"of geometries." +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:335 +#, no-c-format +msgid "" +"box3d ST_3DExtent " +"geometry set geomfield" +msgstr "" + +#. Tag: para +#: reference_misc.xml:345 +#, no-c-format +msgid "" +"ST_3DExtent returns a box3d (includes Z coordinate) bounding box that " +"encloses a set of geometries. The ST_3DExtent function is an \"aggregate\" " +"function in the terminology of SQL. That means that it operates on lists of " +"data, in the same way the SUM() and AVG() functions do." +msgstr "" + +#. Tag: para +#: reference_misc.xml:351 +#, no-c-format +msgid "" +"Since ST_3DExtent returns a bounding box, the SRID meta-data is lost. Use " +"ST_SetSRID to force it back into a geometry with SRID meta data. The " +"coordinates are in the units of the spatial ref of the orginal geometries." +msgstr "" + +#. Tag: para +#: reference_misc.xml:356 +#, no-c-format +msgid "Changed: 2.0.0 In prior versions this used to be called ST_Extent3D" +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:365 +#, no-c-format +msgid "" +"SELECT ST_3DExtent(foo.the_geom) As b3extent\n" +"FROM (SELECT ST_MakePoint(x,y,z) As the_geom\n" +" FROM generate_series(1,3) As x\n" +" CROSS JOIN generate_series(1,2) As y\n" +" CROSS JOIN generate_series(0,2) As Z) As foo;\n" +" b3extent\n" +"--------------------\n" +" BOX3D(1 1 0,3 2 2)\n" +"\n" +"--Get the extent of various elevated circular strings\n" +"SELECT ST_3DExtent(foo.the_geom) As b3extent\n" +"FROM (SELECT " +"ST_Translate(ST_Force_3DZ(ST_LineToCurve(ST_Buffer(ST_MakePoint(x," +"y),1))),0,0,z) As the_geom\n" +" FROM generate_series(1,3) As x\n" +" CROSS JOIN generate_series(1,2) As y\n" +" CROSS JOIN generate_series(0,2) As Z) As foo;\n" +"\n" +" b3extent\n" +"--------------------\n" +" BOX3D(1 0 0,4 2 2)" +msgstr "" + +#. Tag: para +#: reference_misc.xml:370 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_misc.xml:377 +#, no-c-format +msgid "Find_SRID" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:379 +#, no-c-format +msgid "" +"The syntax is find_srid(<db/schema>, <table>, <column>) " +"and the function returns the integer SRID of the specified column by " +"searching through the GEOMETRY_COLUMNS table." +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:386 +#, no-c-format +msgid "" +"integer Find_SRID " +"varchar a_schema_name varchar a_table_name varchar " +"a_geomfield_name" +msgstr "" + +#. Tag: para +#: reference_misc.xml:398 +#, no-c-format +msgid "" +"The syntax is find_srid(<db/schema>, <table>, <column>) " +"and the function returns the integer SRID of the specified column by " +"searching through the GEOMETRY_COLUMNS table. If the geometry column has not " +"been properly added with the AddGeometryColumns() function, this function " +"will not work either." +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:410 +#, no-c-format +msgid "" +"SELECT Find_SRID('public', 'tiger_us_state_2007', 'the_geom_4269');\n" +"find_srid\n" +"----------\n" +"4269" +msgstr "" + +#. Tag: refname +#: reference_misc.xml:423 +#, no-c-format +msgid "ST_Mem_Size" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:425 +#, no-c-format +msgid "" +"Returns the amount of space (in bytes) the geometry takes." +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:430 +#, no-c-format +msgid "" +"integer ST_Mem_Size " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_misc.xml:440 +#, no-c-format +msgid "Returns the amount of space (in bytes) the geometry takes." +msgstr "" + +#. Tag: para +#: reference_misc.xml:441 +#, no-c-format +msgid "" +"This is a nice compliment to PostgreSQL built in functions pg_size_pretty, " +"pg_relation_size, pg_total_relation_size." +msgstr "" + +#. Tag: para +#: reference_misc.xml:442 +#, no-c-format +msgid "" +"pg_relation_size which gives the byte size of a table may return byte size " +"lower than ST_Mem_Size. This is because pg_relation_size does not add " +"toasted table contribution and large geometries are stored in TOAST tables." +msgstr "" + +#. Tag: para +#: reference_misc.xml:444 +#, no-c-format +msgid "" +"pg_total_relation_size - includes, the table, the toasted tables, and the " +"indexes." +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:457 +#, no-c-format +msgid "" +"--Return how much byte space Boston takes up in our Mass data set\n" +"SELECT pg_size_pretty(SUM(ST_Mem_Size(the_geom))) as totgeomsum,\n" +"pg_size_pretty(SUM(CASE WHEN town = 'BOSTON' THEN st_mem_size(the_geom) ELSE " +"0 END)) As bossum,\n" +"CAST(SUM(CASE WHEN town = 'BOSTON' THEN st_mem_size(the_geom) ELSE 0 " +"END)*1.00 /\n" +" SUM(st_mem_size(the_geom))*100 As numeric(10,2)) As perbos\n" +"FROM towns;\n" +"\n" +"totgeomsum bossum perbos\n" +"---------- ------ ------\n" +"1522 kB 30 kB 1.99\n" +"\n" +"\n" +"SELECT ST_Mem_Size(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 " +"150505,220227 150406)'));\n" +"\n" +"---\n" +"73\n" +"\n" +"--What percentage of our table is taken up by just the geometry\n" +"SELECT pg_total_relation_size('public.neighborhoods') As fulltable_size, " +"sum(ST_Mem_Size(the_geom)) As geomsize,\n" +"sum(ST_Mem_Size(the_geom))*1.00/pg_total_relation_size('public." +"neighborhoods')*100 As pergeom\n" +"FROM neighborhoods;\n" +"fulltable_size geomsize pergeom\n" +"------------------------------------------------\n" +"262144 96238 36.71188354492187500000" +msgstr "" + +#. Tag: refname +#: reference_misc.xml:470 +#, no-c-format +msgid "ST_Point_Inside_Circle" +msgstr "" + +#. Tag: refpurpose +#: reference_misc.xml:472 +#, no-c-format +msgid "" +"Is the point geometry insert circle defined by center_x, center_y, radius" +msgstr "" + +#. Tag: funcprototype +#: reference_misc.xml:477 +#, no-c-format +msgid "" +"boolean ST_Point_Inside_Circle " +"geometry a_point " +"float center_x " +"float center_y " +"float radius" +msgstr "" + +#. Tag: para +#: reference_misc.xml:490 +#, no-c-format +msgid "" +"The syntax for this functions is point_inside_circle(<geometry>,<" +"circle_center_x>,<circle_center_y>,<radius>). Returns the " +"true if the geometry is a point and is inside the circle. Returns false " +"otherwise." +msgstr "" + +#. Tag: para +#: reference_misc.xml:494 +#, no-c-format +msgid "This only works for points as the name suggests" +msgstr "" + +#. Tag: programlisting +#: reference_misc.xml:501 +#, no-c-format +msgid "" +"SELECT ST_Point_Inside_Circle(ST_Point(1,2), 0.5, 2, 3);\n" +" st_point_inside_circle\n" +"------------------------\n" +" t" +msgstr "" diff --git a/doc/po/pl/reference_operator.xml.po b/doc/po/pl/reference_operator.xml.po new file mode 100644 index 000000000..2ed05b8c2 --- /dev/null +++ b/doc/po/pl/reference_operator.xml.po @@ -0,0 +1,1630 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +# Jakub Bobrowski , 2014 +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2014-01-04 22:00+0000\n" +"Last-Translator: Jakub Bobrowski \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_operator.xml:3 +#, no-c-format +msgid "Operators" +msgstr "Operatory" + +#. Tag: refname +#: reference_operator.xml:6 +#, no-c-format +msgid "&&" +msgstr "&&" + +#. Tag: refpurpose +#: reference_operator.xml:8 +#, no-c-format +msgid "" +"Returns TRUE if A's 2D bounding box intersects B's 2D " +"bounding box." +msgstr "" +"Zwraca TRUE jeśli dwuwymiarowe (2D) pole ograniczające " +"obiektu A przecina dwuwymiarowe (2D) pole ograniczające obiektu B." + +#. Tag: funcsynopsis +#: reference_operator.xml:12 +#, no-c-format +msgid "" +" boolean && " +" geometry A " +" geometry B boolean && geography A geography B " +msgstr "" +" boolean && " +" geometry A " +" geometry B boolean && geography A geography B " + +#. Tag: title +#: reference_operator.xml:50 reference_operator.xml:111 +#: reference_operator.xml:176 reference_operator.xml:234 +#: reference_operator.xml:295 reference_operator.xml:353 +#: reference_operator.xml:406 reference_operator.xml:475 +#: reference_operator.xml:546 reference_operator.xml:599 +#: reference_operator.xml:654 reference_operator.xml:712 +#: reference_operator.xml:765 reference_operator.xml:818 +#: reference_operator.xml:883 reference_operator.xml:949 +#, no-c-format +msgid "Description" +msgstr "Opis" + +#. Tag: para +#: reference_operator.xml:52 +#, no-c-format +msgid "" +"The && operator returns TRUE " +"if the 2D bounding box of geometry A intersects the 2D bounding box of " +"geometry B." +msgstr "" +"Operator && zwraca TRUE jeśli " +"dwuwymiarowe (2D) pole ograniczające geometrii A przecina dwuwymiarowe (2D) " +"pole ograniczające geometrii B." + +#. Tag: para +#: reference_operator.xml:54 reference_operator.xml:115 +#: reference_operator.xml:182 reference_operator.xml:243 +#: reference_operator.xml:301 reference_operator.xml:358 +#: reference_operator.xml:411 reference_operator.xml:551 +#: reference_operator.xml:605 reference_operator.xml:660 +#: reference_operator.xml:717 reference_operator.xml:770 +#: reference_operator.xml:823 +#, no-c-format +msgid "" +"This operand will make use of any indexes that may be available on the " +"geometries." +msgstr "" + +#. Tag: para +#: reference_operator.xml:57 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces was introduced." +msgstr "" + +#. Tag: para +#: reference_operator.xml:58 +#, no-c-format +msgid "Availability: 1.5.0 support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_operator.xml:59 reference_operator.xml:119 +#: reference_operator.xml:240 reference_operator.xml:492 +#, no-c-format +msgid "&curve_support;" +msgstr "&curve_support;" + +#. Tag: para +#: reference_operator.xml:60 reference_operator.xml:120 +#: reference_operator.xml:241 reference_operator.xml:493 +#: reference_operator.xml:827 +#, no-c-format +msgid "&P_support;" +msgstr "&P_support;" + +#. Tag: title +#: reference_operator.xml:64 reference_operator.xml:187 +#: reference_operator.xml:248 reference_operator.xml:306 +#: reference_operator.xml:363 reference_operator.xml:416 +#: reference_operator.xml:502 reference_operator.xml:556 +#: reference_operator.xml:611 reference_operator.xml:665 +#: reference_operator.xml:722 reference_operator.xml:775 +#: reference_operator.xml:843 reference_operator.xml:899 +#: reference_operator.xml:963 +#, no-c-format +msgid "Examples" +msgstr "Przykłady" + +#. Tag: programlisting +#: reference_operator.xml:66 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 && tbl2.column2 AS " +"overlaps\n" +"FROM ( VALUES\n" +" (1, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (2, 'LINESTRING(0 1, 0 5)'::geometry)) AS tbl1,\n" +"( VALUES\n" +" (3, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overlaps\n" +"---------+---------+----------\n" +" 1 | 3 | t\n" +" 2 | 3 | f\n" +"(2 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 && tbl2.column2 AS " +"overlaps\n" +"FROM ( VALUES\n" +" (1, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (2, 'LINESTRING(0 1, 0 5)'::geometry)) AS tbl1,\n" +"( VALUES\n" +" (3, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overlaps\n" +"---------+---------+----------\n" +" 1 | 3 | t\n" +" 2 | 3 | f\n" +"(2 rows)" + +#. Tag: title +#: reference_operator.xml:71 reference_operator.xml:139 +#: reference_operator.xml:193 reference_operator.xml:254 +#: reference_operator.xml:312 reference_operator.xml:369 +#: reference_operator.xml:422 reference_operator.xml:508 +#: reference_operator.xml:562 reference_operator.xml:617 +#: reference_operator.xml:671 reference_operator.xml:728 +#: reference_operator.xml:781 reference_operator.xml:848 +#: reference_operator.xml:915 reference_operator.xml:967 +#, no-c-format +msgid "See Also" +msgstr "Zobacz także" + +#. Tag: para +#: reference_operator.xml:73 +#, no-c-format +msgid "" +", , , , , " +msgstr "" +", , , , , " + +#. Tag: refname +#: reference_operator.xml:85 +#, no-c-format +msgid "&&&" +msgstr "&&&" + +#. Tag: refpurpose +#: reference_operator.xml:87 +#, no-c-format +msgid "" +"Returns TRUE if A's 3D bounding box intersects B's 3D " +"bounding box." +msgstr "" +"Zwraca TRUE jeśli trójwymiarowe (3D) pole ograniczające " +"obiektu A przecina trójwymiarowe (3D) pole ograniczające obiektu B." + +#. Tag: funcprototype +#: reference_operator.xml:92 +#, no-c-format +msgid "" +"boolean &&& " +"geometry A " +"geometry B " +msgstr "" +"boolean &&& " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:113 +#, no-c-format +msgid "" +"The &&& operator returns TRUE if the n-D bounding box of geometry A intersects the n-D bounding " +"box of geometry B." +msgstr "" +"Operator &&& zwraca TRUEjesli n-wymiarowe (n-D) pole ograniczające geometrii A przecina n-" +"wymiarowe (n-D) pole ograniczające geometrii B." + +#. Tag: para +#: reference_operator.xml:118 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "Dostępność: 2.0.0" + +#. Tag: para +#: reference_operator.xml:121 +#, no-c-format +msgid "&T_support;" +msgstr "&T_support;" + +#. Tag: para +#: reference_operator.xml:122 +#, no-c-format +msgid "&Z_support;" +msgstr "&Z_support;" + +#. Tag: title +#: reference_operator.xml:126 +#, no-c-format +msgid "Examples: 3D LineStrings" +msgstr "Przykłady: 3D LineStrings" + +#. Tag: programlisting +#: reference_operator.xml:128 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 " +"AS overlaps_3d, \n" +" tbl1.column2 && tbl2.column2 AS " +"overlaps_2d\n" +"FROM ( VALUES\n" +" (1, 'LINESTRING Z(0 0 1, 3 3 2)'::geometry),\n" +" (2, 'LINESTRING Z(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n" +"( VALUES\n" +" (3, 'LINESTRING Z(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overlaps_3d | overlaps_2d\n" +"---------+---------+-------------+-------------\n" +" 1 | 3 | t | t\n" +" 2 | 3 | f | t" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 " +"AS overlaps_3d, \n" +" tbl1.column2 && tbl2.column2 AS " +"overlaps_2d\n" +"FROM ( VALUES\n" +" (1, 'LINESTRING Z(0 0 1, 3 3 2)'::geometry),\n" +" (2, 'LINESTRING Z(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n" +"( VALUES\n" +" (3, 'LINESTRING Z(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overlaps_3d | overlaps_2d\n" +"---------+---------+-------------+-------------\n" +" 1 | 3 | t | t\n" +" 2 | 3 | f | t" + +#. Tag: title +#: reference_operator.xml:132 +#, no-c-format +msgid "Examples: 3M LineStrings" +msgstr "Przykłady: 3M LineStrings" + +#. Tag: programlisting +#: reference_operator.xml:134 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 " +"AS overlaps_3zm, \n" +" tbl1.column2 && tbl2.column2 AS " +"overlaps_2d\n" +"FROM ( VALUES\n" +" (1, 'LINESTRING M(0 0 1, 3 3 2)'::geometry),\n" +" (2, 'LINESTRING M(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n" +"( VALUES\n" +" (3, 'LINESTRING M(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overlaps_3zm | overlaps_2d\n" +"---------+---------+-------------+-------------\n" +" 1 | 3 | t | t\n" +" 2 | 3 | f | t" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 " +"AS overlaps_3zm, \n" +" tbl1.column2 && tbl2.column2 AS " +"overlaps_2d\n" +"FROM ( VALUES\n" +" (1, 'LINESTRING M(0 0 1, 3 3 2)'::geometry),\n" +" (2, 'LINESTRING M(1 2 0, 0 5 -1)'::geometry)) AS tbl1,\n" +"( VALUES\n" +" (3, 'LINESTRING M(1 2 1, 4 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overlaps_3zm | overlaps_2d\n" +"---------+---------+-------------+-------------\n" +" 1 | 3 | t | t\n" +" 2 | 3 | f | t" + +#. Tag: refname +#: reference_operator.xml:147 +#, no-c-format +msgid "&<" +msgstr "&<" + +#. Tag: refpurpose +#: reference_operator.xml:149 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box overlaps or is to the " +"left of B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:154 +#, no-c-format +msgid "" +"boolean &< " +"geometry A " +"geometry B " +msgstr "" +"boolean &< " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:178 +#, no-c-format +msgid "" +"The &< operator returns TRUE if " +"the bounding box of geometry A overlaps or is to the left of the bounding " +"box of geometry B, or more accurately, overlaps or is NOT to the right of " +"the bounding box of geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:189 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &< tbl2.column2 AS " +"overleft\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overleft\n" +"---------+---------+----------\n" +" 1 | 2 | f\n" +" 1 | 3 | f\n" +" 1 | 4 | t\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &< tbl2.column2 AS " +"overleft\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overleft\n" +"---------+---------+----------\n" +" 1 | 2 | f\n" +" 1 | 3 | f\n" +" 1 | 4 | t\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:195 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_operator.xml:205 +#, no-c-format +msgid "&<|" +msgstr "&<|" + +#. Tag: refpurpose +#: reference_operator.xml:207 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box overlaps or is below B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:212 +#, no-c-format +msgid "" +"boolean &<| " +"geometry A " +"geometry B " +msgstr "" +"boolean &<| " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:236 +#, no-c-format +msgid "" +"The &<| operator returns TRUE " +"if the bounding box of geometry A overlaps or is below of the bounding box " +"of geometry B, or more accurately, overlaps or is NOT above the bounding box " +"of geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:250 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &<| tbl2.column2 AS " +"overbelow\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overbelow\n" +"---------+---------+-----------\n" +" 1 | 2 | f\n" +" 1 | 3 | t\n" +" 1 | 4 | t\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &<| tbl2.column2 AS " +"overbelow\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overbelow\n" +"---------+---------+-----------\n" +" 1 | 2 | f\n" +" 1 | 3 | t\n" +" 1 | 4 | t\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:256 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_operator.xml:266 +#, no-c-format +msgid "&>" +msgstr "&>" + +#. Tag: refpurpose +#: reference_operator.xml:268 +#, no-c-format +msgid "" +"Returns TRUE if A' bounding box overlaps or is to the " +"right of B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:273 +#, no-c-format +msgid "" +"boolean &> " +"geometry A " +"geometry B " +msgstr "" +"boolean &> " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:297 +#, no-c-format +msgid "" +"The &> operator returns TRUE if " +"the bounding box of geometry A overlaps or is to the right of the bounding " +"box of geometry B, or more accurately, overlaps or is NOT to the left of the " +"bounding box of geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:308 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &> tbl2.column2 AS " +"overright\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overright\n" +"---------+---------+-----------\n" +" 1 | 2 | t\n" +" 1 | 3 | t\n" +" 1 | 4 | f\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 &> tbl2.column2 AS " +"overright\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overright\n" +"---------+---------+-----------\n" +" 1 | 2 | t\n" +" 1 | 3 | t\n" +" 1 | 4 | f\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:314 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_operator.xml:324 +#, no-c-format +msgid "<<" +msgstr "<<" + +#. Tag: refpurpose +#: reference_operator.xml:326 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box is strictly to the left " +"of B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:331 +#, no-c-format +msgid "" +"boolean << " +"geometry A " +"geometry B " +msgstr "" +"boolean << " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:355 +#, no-c-format +msgid "" +"The << operator returns TRUE if " +"the bounding box of geometry A is strictly to the left of the bounding box " +"of geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:365 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 << tbl2.column2 AS " +"left\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (1 2, 1 5)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 3)'::geometry),\n" +" (3, 'LINESTRING (6 0, 6 5)'::geometry),\n" +" (4, 'LINESTRING (2 2, 5 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | left\n" +"---------+---------+------\n" +" 1 | 2 | f\n" +" 1 | 3 | t\n" +" 1 | 4 | t\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 << tbl2.column2 AS " +"left\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (1 2, 1 5)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 3)'::geometry),\n" +" (3, 'LINESTRING (6 0, 6 5)'::geometry),\n" +" (4, 'LINESTRING (2 2, 5 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | left\n" +"---------+---------+------\n" +" 1 | 2 | f\n" +" 1 | 3 | t\n" +" 1 | 4 | t\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:371 reference_operator.xml:564 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_operator.xml:377 +#, no-c-format +msgid "<<|" +msgstr "<<|" + +#. Tag: refpurpose +#: reference_operator.xml:379 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box is strictly below B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:384 +#, no-c-format +msgid "" +"boolean <<| " +"geometry A " +"geometry B " +msgstr "" +"boolean <<| " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:408 +#, no-c-format +msgid "" +"The <<| operator returns TRUE if " +"the bounding box of geometry A is strictly below the bounding box of " +"geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:418 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 <<| tbl2.column2 AS " +"below\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n" +" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n" +" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | below\n" +"---------+---------+-------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 <<| tbl2.column2 AS " +"below\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n" +" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n" +" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | below\n" +"---------+---------+-------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:424 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_operator.xml:430 +#, no-c-format +msgid "=" +msgstr "=" + +#. Tag: refpurpose +#: reference_operator.xml:432 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box is the same as B's. Uses " +"double precision bounding box." +msgstr "" + +#. Tag: funcsynopsis +#: reference_operator.xml:436 +#, no-c-format +msgid "" +" boolean = " +" geometry A " +" geometry B boolean = geography A geography B " +msgstr "" +" boolean = " +" geometry A " +" geometry B boolean = geography A geography B " + +#. Tag: para +#: reference_operator.xml:477 +#, no-c-format +msgid "" +"The = operator returns TRUE if the " +"bounding box of geometry/geography A is the same as the bounding box of " +"geometry/geography B. PostgreSQL uses the =, <, and > operators " +"defined for geometries to perform internal orderings and comparison of " +"geometries (ie. in a GROUP BY or ORDER BY clause)." +msgstr "" + +#. Tag: para +#: reference_operator.xml:482 +#, no-c-format +msgid "" +"This is cause for a lot of confusion. When you compare geometryA = geometryB " +"it will return true even when the geometries are clearly different IF their " +"bounding boxes are the same. To check for true equality use or " +msgstr "" + +#. Tag: para +#: reference_operator.xml:489 +#, no-c-format +msgid "" +"This operand will NOT make use of any indexes that may be available on the " +"geometries." +msgstr "" + +#. Tag: para +#: reference_operator.xml:494 +#, no-c-format +msgid "" +"Changed: 2.0.0 , the bounding box of geometries was changed to use double " +"precision instead of float4 precision of prior. The side effect of this is " +"that in particular points in prior versions that were a little different may " +"have returned true in prior versions and false in 2.0+ since their float4 " +"boxes would be the same but there float8 (double precision), would be " +"different." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:504 +#, no-c-format +msgid "" +"SELECT 'LINESTRING(0 0, 0 1, 1 0)'::geometry = 'LINESTRING(1 1, 0 0)'::" +"geometry;\n" +" ?column?\n" +"----------\n" +" t\n" +"(1 row)\n" +"\n" +"SELECT ST_AsText(column1)\n" +"FROM ( VALUES\n" +" ('LINESTRING(0 0, 1 1)'::geometry),\n" +" ('LINESTRING(1 1, 0 0)'::geometry)) AS foo;\n" +" st_astext\n" +"---------------------\n" +" LINESTRING(0 0,1 1)\n" +" LINESTRING(1 1,0 0)\n" +"(2 rows)\n" +"\n" +"-- Note: the GROUP BY uses the \"=\" to compare for geometry equivalency.\n" +"SELECT ST_AsText(column1)\n" +"FROM ( VALUES\n" +" ('LINESTRING(0 0, 1 1)'::geometry),\n" +" ('LINESTRING(1 1, 0 0)'::geometry)) AS foo\n" +"GROUP BY column1;\n" +" st_astext\n" +"---------------------\n" +" LINESTRING(0 0,1 1)\n" +"(1 row)\n" +"\n" +"-- In versions prior to 2.0, this used to return true --\n" +" SELECT ST_GeomFromText('POINT(1707296.37 4820536.77)') =\n" +" ST_GeomFromText('POINT(1707296.27 4820536.87)') As pt_intersect;\n" +" \n" +"--pt_intersect --\n" +"f" +msgstr "" + +#. Tag: para +#: reference_operator.xml:510 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_operator.xml:517 +#, no-c-format +msgid ">>" +msgstr ">>" + +#. Tag: refpurpose +#: reference_operator.xml:519 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box is strictly to the right " +"of B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:524 +#, no-c-format +msgid "" +"boolean >> " +"geometry A " +"geometry B " +msgstr "" +"boolean >> " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:548 +#, no-c-format +msgid "" +"The >> operator returns TRUE if " +"the bounding box of geometry A is strictly to the right of the bounding box " +"of geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:558 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 >> tbl2.column2 AS " +"right\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n" +" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n" +" (4, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | right\n" +"---------+---------+-------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 >> tbl2.column2 AS " +"right\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (1 4, 1 7)'::geometry),\n" +" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n" +" (4, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | right\n" +"---------+---------+-------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" + +#. Tag: refname +#: reference_operator.xml:570 +#, no-c-format +msgid "@" +msgstr "@" + +#. Tag: refpurpose +#: reference_operator.xml:572 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box is contained by B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:577 +#, no-c-format +msgid "" +"boolean @ geometry " +" A geometry B " +msgstr "" +"boolean @ geometry " +" A geometry B " + +#. Tag: para +#: reference_operator.xml:601 +#, no-c-format +msgid "" +"The @ operator returns TRUE if the " +"bounding box of geometry A is completely contained by the bounding box of " +"geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:613 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 @ tbl2.column2 AS contained\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n" +" (3, 'LINESTRING (2 2, 4 4)'::geometry),\n" +" (4, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | contained\n" +"---------+---------+-----------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | t\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 @ tbl2.column2 AS contained\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n" +" (3, 'LINESTRING (2 2, 4 4)'::geometry),\n" +" (4, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | contained\n" +"---------+---------+-----------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | t\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:619 reference_operator.xml:783 +#, no-c-format +msgid ", " +msgstr ", " + +#. Tag: refname +#: reference_operator.xml:625 +#, no-c-format +msgid "|&>" +msgstr "|&>" + +#. Tag: refpurpose +#: reference_operator.xml:627 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box overlaps or is above B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:632 +#, no-c-format +msgid "" +"boolean |&> " +"geometry A " +"geometry B " +msgstr "" +"boolean |&> " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:656 +#, no-c-format +msgid "" +"The |&> operator returns TRUE " +"if the bounding box of geometry A overlaps or is above the bounding box of " +"geometry B, or more accurately, overlaps or is NOT below the bounding box of " +"geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:667 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |&> tbl2.column2 AS " +"overabove\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overabove\n" +"---------+---------+-----------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |&> tbl2.column2 AS " +"overabove\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING(0 0, 3 3)'::geometry),\n" +" (3, 'LINESTRING(0 1, 0 5)'::geometry),\n" +" (4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | overabove\n" +"---------+---------+-----------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:673 +#, no-c-format +msgid "" +", , , " +msgstr "" +", , , " + +#. Tag: refname +#: reference_operator.xml:683 +#, no-c-format +msgid "|>>" +msgstr "|>>" + +#. Tag: refpurpose +#: reference_operator.xml:685 +#, no-c-format +msgid "" +"Returns TRUE if A's bounding box is strictly above B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:690 +#, no-c-format +msgid "" +"boolean |>> " +"geometry A " +"geometry B " +msgstr "" +"boolean |>> " +"geometry A " +"geometry B " + +#. Tag: para +#: reference_operator.xml:714 +#, no-c-format +msgid "" +"The |>> operator returns TRUE if " +"the bounding box of geometry A is strictly to the right of the bounding box " +"of geometry B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:724 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |>> tbl2.column2 AS " +"above\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (1 4, 1 7)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 2)'::geometry),\n" +" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n" +" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | above\n" +"---------+---------+-------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 |>> tbl2.column2 AS " +"above\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (1 4, 1 7)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 2)'::geometry),\n" +" (3, 'LINESTRING (6 1, 6 5)'::geometry),\n" +" (4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | above\n" +"---------+---------+-------\n" +" 1 | 2 | t\n" +" 1 | 3 | f\n" +" 1 | 4 | f\n" +"(3 rows)" + +#. Tag: para +#: reference_operator.xml:730 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_operator.xml:736 +#, no-c-format +msgid "~" +msgstr "~" + +#. Tag: refpurpose +#: reference_operator.xml:738 +#, no-c-format +msgid "Returns TRUE if A's bounding box contains B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:743 +#, no-c-format +msgid "" +"boolean ~ geometry " +" A geometry B " +msgstr "" +"boolean ~ geometry " +" A geometry B " + +#. Tag: para +#: reference_operator.xml:767 +#, no-c-format +msgid "" +"The ~ operator returns TRUE if the " +"bounding box of geometry A completely contains the bounding box of geometry " +"B." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:777 +#, no-c-format +msgid "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 ~ tbl2.column2 AS contains\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n" +" (3, 'LINESTRING (1 1, 2 2)'::geometry),\n" +" (4, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | contains\n" +"---------+---------+----------\n" +" 1 | 2 | f\n" +" 1 | 3 | t\n" +" 1 | 4 | t\n" +"(3 rows)" +msgstr "" +"SELECT tbl1.column1, tbl2.column1, tbl1.column2 ~ tbl2.column2 AS contains\n" +"FROM\n" +" ( VALUES\n" +" (1, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl1,\n" +" ( VALUES\n" +" (2, 'LINESTRING (0 0, 4 4)'::geometry),\n" +" (3, 'LINESTRING (1 1, 2 2)'::geometry),\n" +" (4, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl2;\n" +"\n" +" column1 | column1 | contains\n" +"---------+---------+----------\n" +" 1 | 2 | f\n" +" 1 | 3 | t\n" +" 1 | 4 | t\n" +"(3 rows)" + +#. Tag: refname +#: reference_operator.xml:789 +#, no-c-format +msgid "~=" +msgstr "~=" + +#. Tag: refpurpose +#: reference_operator.xml:791 +#, no-c-format +msgid "Returns TRUE if A's bounding box is the same as B's." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:796 +#, no-c-format +msgid "" +"boolean ~= geometry " +" A geometry B " +msgstr "" +"boolean ~= geometry " +" A geometry B " + +#. Tag: para +#: reference_operator.xml:820 +#, no-c-format +msgid "" +"The ~= operator returns TRUE if the " +"bounding box of geometry/geography A is the same as the bounding box of " +"geometry/geography B." +msgstr "" + +#. Tag: para +#: reference_operator.xml:826 +#, no-c-format +msgid "Availability: 1.5.0 changed behavior" +msgstr "" + +#. Tag: para +#: reference_operator.xml:830 +#, no-c-format +msgid "" +"This operator has changed behavior in PostGIS 1.5 from testing for actual " +"geometric equality to only checking for bounding box equality. To complicate " +"things it also depends on if you have done a hard or soft upgrade which " +"behavior your database has. To find out which behavior your database has you " +"can run the query below. To check for true equality use or and to check for " +"bounding box equality ; operator is a " +"safer option." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:844 +#, no-c-format +msgid "" +"select 'LINESTRING(0 0, 1 1)'::geometry ~= 'LINESTRING(0 1, 1 0)'::geometry " +"as equality;\n" +" equality |\n" +"-----------------+\n" +" t |" +msgstr "" +"select 'LINESTRING(0 0, 1 1)'::geometry ~= 'LINESTRING(0 1, 1 0)'::geometry " +"as equality;\n" +" equality |\n" +"-----------------+\n" +" t |" + +#. Tag: para +#: reference_operator.xml:845 +#, no-c-format +msgid "" +"The above can be used to test if you have the new or old behavior of ~= " +"operator." +msgstr "" + +#. Tag: para +#: reference_operator.xml:849 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_operator.xml:855 +#, no-c-format +msgid "<->" +msgstr "<->" + +#. Tag: refpurpose +#: reference_operator.xml:857 +#, no-c-format +msgid "" +"Returns the distance between two points. For point / point checks it uses " +"floating point accuracy (as opposed to the double precision accuracy of the " +"underlying point geometry). For other geometry types the distance between " +"the floating point bounding box centroids is returned. Useful for doing " +"distance ordering and nearest neighbor limits using KNN gist functionality." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:864 +#, no-c-format +msgid "" +"double precision <-> " +" geometry A " +" geometry B " +msgstr "" +"double precision <-> " +" geometry A " +" geometry B " + +#. Tag: para +#: reference_operator.xml:885 +#, no-c-format +msgid "" +"The <-> operator returns distance between two " +"points read from the spatial index for points (float precision). For other " +"geometries it returns the distance from centroid of bounding box of " +"geometries. Useful for doing nearest neighbor approximate distance ordering." +msgstr "" + +#. Tag: para +#: reference_operator.xml:888 reference_operator.xml:953 +#, no-c-format +msgid "" +"This operand will make use of any indexes that may be available on the " +"geometries. It is different from other operators that use spatial indexes in " +"that the spatial index is only used when the operator is in the ORDER BY " +"clause." +msgstr "" + +#. Tag: para +#: reference_operator.xml:891 +#, no-c-format +msgid "" +"Index only kicks in if one of the geometries is a constant (not in a " +"subquery/cte). e.g. 'SRID=3005;POINT(1011102 450541)'::geometry instead of a." +"geom" +msgstr "" + +#. Tag: para +#: reference_operator.xml:893 reference_operator.xml:958 +#, no-c-format +msgid "Availability: 2.0.0 only available for PostgreSQL 9.1+" +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:900 +#, no-c-format +msgid "" +"\n" +"\n" +" d | edabbr | vaabbr\n" +"------------------+--------+--------\n" +" 0 | ALQ | 128\n" +" 5541.57712511724 | ALQ | 129A\n" +" 5579.67450712005 | ALQ | 001\n" +" 6083.4207708641 | ALQ | 131\n" +" 7691.2205404848 | ALQ | 003\n" +" 7900.75451037313 | ALQ | 122\n" +" 8694.20710669982 | ALQ | 129B\n" +" 9564.24289057111 | ALQ | 130\n" +" 12089.665931705 | ALQ | 127\n" +" 18472.5531479404 | ALQ | 002\n" +"(10 rows)" +msgstr "" + +#. Tag: para +#: reference_operator.xml:901 +#, no-c-format +msgid "Then the KNN raw answer:" +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:904 +#, no-c-format +msgid "" +" 'SRID=3005;POINT(1011102 450541)'::geometry limit 10;]]>\n" +"\n" +" d | edabbr | vaabbr\n" +"------------------+--------+--------\n" +" 0 | ALQ | 128\n" +" 5579.67450712005 | ALQ | 001\n" +" 5541.57712511724 | ALQ | 129A\n" +" 8694.20710669982 | ALQ | 129B\n" +" 9564.24289057111 | ALQ | 130\n" +" 6083.4207708641 | ALQ | 131\n" +" 12089.665931705 | ALQ | 127\n" +" 24795.264503022 | ALQ | 124\n" +" 24587.6584922302 | ALQ | 123\n" +" 26764.2555463114 | ALQ | 125\n" +"(10 rows)" +msgstr "" + +#. Tag: para +#: reference_operator.xml:905 +#, no-c-format +msgid "" +"Note the misordering in the actual distances and the different entries that " +"actually show up in the top 10." +msgstr "" + +#. Tag: para +#: reference_operator.xml:909 +#, no-c-format +msgid "Finally the hybrid:" +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:912 +#, no-c-format +msgid "" +" 'SRID=3005;POINT(1011102 450541)'::geometry LIMIT 100) \n" +" SELECT * \n" +" FROM index_query \n" +" ORDER BY d limit 10;]]>\n" +"\n" +" d | edabbr | vaabbr\n" +"------------------+--------+--------\n" +" 0 | ALQ | 128\n" +" 5541.57712511724 | ALQ | 129A\n" +" 5579.67450712005 | ALQ | 001\n" +" 6083.4207708641 | ALQ | 131\n" +" 7691.2205404848 | ALQ | 003\n" +" 7900.75451037313 | ALQ | 122\n" +" 8694.20710669982 | ALQ | 129B\n" +" 9564.24289057111 | ALQ | 130\n" +" 12089.665931705 | ALQ | 127\n" +" 18472.5531479404 | ALQ | 002\n" +"(10 rows)" +msgstr "" + +#. Tag: para +#: reference_operator.xml:916 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " + +#. Tag: refname +#: reference_operator.xml:922 +#, no-c-format +msgid "<#>" +msgstr "<#>" + +#. Tag: refpurpose +#: reference_operator.xml:924 +#, no-c-format +msgid "" +"Returns the distance between bounding box of 2 geometries. For point / point " +"checks it's almost the same as distance (though may be different since the " +"bounding box is at floating point accuracy and geometries are double " +"precision). Useful for doing distance ordering and nearest neighbor limits " +"using KNN gist functionality." +msgstr "" + +#. Tag: funcprototype +#: reference_operator.xml:930 +#, no-c-format +msgid "" +"double precision <#> " +" geometry A " +" geometry B " +msgstr "" +"double precision <#> " +" geometry A " +" geometry B " + +#. Tag: para +#: reference_operator.xml:951 +#, no-c-format +msgid "" +"The <#> KNN GIST operator returns distance between " +"two floating point bounding boxes read from the spatial index if available. " +"Useful for doing nearest neighbor approximate distance ordering." +msgstr "" + +#. Tag: para +#: reference_operator.xml:956 +#, no-c-format +msgid "" +"Index only kicks in if one of the geometries is a constant e.g. ORDER BY " +"(ST_GeomFromText('POINT(1 2)') <#> geom) instead of g1.geom <#>." +msgstr "" + +#. Tag: programlisting +#: reference_operator.xml:964 +#, no-c-format +msgid "" +" ST_GeomFromText('LINESTRING(746149 2948672,745954 " +"2948576,\n" +" 745787 2948499,745740 2948468,745712 2948438,\n" +" 745690 2948384,745677 2948319)',2249) As b_dist, \n" +" ST_Distance(b.geom, ST_GeomFromText('LINESTRING(746149 " +"2948672,745954 2948576,\n" +" 745787 2948499,745740 2948468,745712 2948438,\n" +" 745690 2948384,745677 2948319)',2249)) As act_dist\n" +" FROM bos_roads As b \n" +" ORDER BY b_dist, b.tlid\n" +" LIMIT 100) As foo\n" +" ORDER BY act_dist, tlid LIMIT 10;]]>\n" +"\n" +" tlid | mtfcc | b_dist | act_dist\n" +"-----------+-------+------------------+------------------\n" +" 85732027 | S1400 | 0 | 0\n" +" 85732029 | S1400 | 0 | 0\n" +" 85732031 | S1400 | 0 | 0\n" +" 85734335 | S1400 | 0 | 0\n" +" 85736037 | S1400 | 0 | 0\n" +" 624683742 | S1400 | 0 | 128.528874268666\n" +" 85719343 | S1400 | 260.839270432962 | 260.839270432962\n" +" 85741826 | S1400 | 164.759294123275 | 260.839270432962\n" +" 85732032 | S1400 | 277.75 | 311.830282365264\n" +" 85735592 | S1400 | 222.25 | 311.830282365264\n" +"(10 rows)" +msgstr "" +" ST_GeomFromText('LINESTRING(746149 2948672,745954 " +"2948576,\n" +" 745787 2948499,745740 2948468,745712 2948438,\n" +" 745690 2948384,745677 2948319)',2249) As b_dist, \n" +" ST_Distance(b.geom, ST_GeomFromText('LINESTRING(746149 " +"2948672,745954 2948576,\n" +" 745787 2948499,745740 2948468,745712 2948438,\n" +" 745690 2948384,745677 2948319)',2249)) As act_dist\n" +" FROM bos_roads As b \n" +" ORDER BY b_dist, b.tlid\n" +" LIMIT 100) As foo\n" +" ORDER BY act_dist, tlid LIMIT 10;]]>\n" +"\n" +" tlid | mtfcc | b_dist | act_dist\n" +"-----------+-------+------------------+------------------\n" +" 85732027 | S1400 | 0 | 0\n" +" 85732029 | S1400 | 0 | 0\n" +" 85732031 | S1400 | 0 | 0\n" +" 85734335 | S1400 | 0 | 0\n" +" 85736037 | S1400 | 0 | 0\n" +" 624683742 | S1400 | 0 | 128.528874268666\n" +" 85719343 | S1400 | 260.839270432962 | 260.839270432962\n" +" 85741826 | S1400 | 164.759294123275 | 260.839270432962\n" +" 85732032 | S1400 | 277.75 | 311.830282365264\n" +" 85735592 | S1400 | 222.25 | 311.830282365264\n" +"(10 rows)" + +#. Tag: para +#: reference_operator.xml:968 +#, no-c-format +msgid "" +", , " +msgstr "" +", , " diff --git a/doc/po/pl/reference_output.xml.po b/doc/po/pl/reference_output.xml.po new file mode 100644 index 000000000..137bc2c82 --- /dev/null +++ b/doc/po/pl/reference_output.xml.po @@ -0,0 +1,2081 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2014-10-14 21:54+0000\n" +"PO-Revision-Date: 2014-10-14 22:36+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_output.xml:4 +#, no-c-format +msgid "Geometry Outputs" +msgstr "" + +#. Tag: refname +#: reference_output.xml:7 +#, no-c-format +msgid "ST_AsBinary" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:8 +#, no-c-format +msgid "" +"Return the Well-Known Binary (WKB) representation of the geometry/geography " +"without SRID meta data." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:12 +#, no-c-format +msgid "" +" bytea ST_AsBinary " +"geometry g1 bytea ST_AsBinary geometry g1 text NDR_or_XDR bytea " +"ST_AsBinary geography " +"g1 " +"bytea ST_AsBinary " +"geography g1 " +"text NDR_or_XDR " +msgstr "" + +#. Tag: title +#: reference_output.xml:35 reference_output.xml:109 reference_output.xml:162 +#: reference_output.xml:238 reference_output.xml:339 reference_output.xml:440 +#: reference_output.xml:496 reference_output.xml:561 reference_output.xml:604 +#: reference_output.xml:707 reference_output.xml:755 reference_output.xml:813 +#: reference_output.xml:879 reference_output.xml:944 reference_output.xml:988 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_output.xml:37 +#, no-c-format +msgid "" +"Returns the Well-Known Binary representation of the geometry. There are 2 " +"variants of the function. The first variant takes no endian encoding " +"parameter and defaults to server machine endian. The second variant takes a " +"second argument denoting the encoding - using little-endian ('NDR') or big-" +"endian ('XDR') encoding." +msgstr "" + +#. Tag: para +#: reference_output.xml:40 reference_output.xml:113 +#, no-c-format +msgid "" +"This is useful in binary cursors to pull data out of the database without " +"converting it to a string representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:44 +#, no-c-format +msgid "" +"The WKB spec does not include the SRID. To get the WKB with SRID format use " +"ST_AsEWKB" +msgstr "" + +#. Tag: para +#: reference_output.xml:47 +#, no-c-format +msgid "" +"ST_AsBinary is the reverse of for " +"geometry. Use to convert to a postgis " +"geometry from ST_AsBinary representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:51 +#, no-c-format +msgid "" +"The default behavior in PostgreSQL 9.0 has been changed to output bytea in " +"hex encoding. ST_AsBinary is the reverse of for geometry. If your GUI tools require the old behavior, then SET " +"bytea_output='escape' in your database." +msgstr "" + +#. Tag: para +#: reference_output.xml:55 reference_output.xml:121 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:56 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for higher coordinate dimensions was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:57 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for specifying endian with geography was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:58 reference_output.xml:279 reference_output.xml:383 +#, no-c-format +msgid "Availability: 1.5.0 geography support was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:59 +#, no-c-format +msgid "" +"Changed: 2.0.0 Inputs to this function can not be unknown -- must be " +"geometry. Constructs such as ST_AsBinary('POINT(1 2)') are no " +"longer valid and you will get an n st_asbinary(unknown) is not unique " +"error. Code like that needs to be changed to " +"ST_AsBinary('POINT(1 2)'::geometry);. If that is not possible, " +"then install legacy.sql." +msgstr "" + +#. Tag: para +#: reference_output.xml:61 reference_output.xml:771 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.1" +msgstr "" + +#. Tag: para +#: reference_output.xml:62 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.37" +msgstr "" + +#. Tag: para +#: reference_output.xml:63 reference_output.xml:123 reference_output.xml:177 +#: reference_output.xml:449 reference_output.xml:721 reference_output.xml:773 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: para +#: reference_output.xml:64 reference_output.xml:124 reference_output.xml:178 +#: reference_output.xml:390 reference_output.xml:664 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_output.xml:65 reference_output.xml:125 reference_output.xml:179 +#: reference_output.xml:391 reference_output.xml:667 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: para +#: reference_output.xml:66 reference_output.xml:122 reference_output.xml:176 +#: reference_output.xml:281 reference_output.xml:389 reference_output.xml:448 +#: reference_output.xml:523 reference_output.xml:662 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: title +#: reference_output.xml:71 reference_output.xml:130 reference_output.xml:184 +#: reference_output.xml:285 reference_output.xml:453 reference_output.xml:527 +#: reference_output.xml:580 reference_output.xml:725 reference_output.xml:778 +#: reference_output.xml:842 reference_output.xml:896 reference_output.xml:961 +#: reference_output.xml:997 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:73 +#, no-c-format +msgid "" +"SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n" +"\n" +" st_asbinary\n" +"--------------------------------\n" +"\\001\\003\\000\\000\\000\\001\\000\\000\\000\\005\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\360?\\000\\000\\000\\000\\000\\000\n" +"\\360?\\000\\000\\000\\000\\000\\000\\360?\\000\\000\n" +"\\000\\000\\000\\000\\360?\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\n" +"(1 row)" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:74 +#, no-c-format +msgid "" +"SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), " +"'XDR');\n" +" st_asbinary\n" +"--------------------------------\n" +"\\000\\000\\000\\000\\003\\000\\000\\000\\001\\000\\000\\000\\005\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000?\\360\\000\\000\\000\\000\\000\\000?" +"\\360\\000\\000\\000\\000\\000\\000?\\360\\000\\000\n" +"\\000\\000\\000\\000?" +"\\360\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"(1 row)" +msgstr "" + +#. Tag: title +#: reference_output.xml:79 reference_output.xml:138 reference_output.xml:191 +#: reference_output.xml:409 reference_output.xml:531 reference_output.xml:729 +#: reference_output.xml:785 reference_output.xml:901 reference_output.xml:966 +#: reference_output.xml:1002 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_output.xml:80 +#, no-c-format +msgid "" +", , , ," +msgstr "" + +#. Tag: refname +#: reference_output.xml:90 +#, no-c-format +msgid "ST_AsEWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:91 +#, no-c-format +msgid "" +"Return the Well-Known Binary (WKB) representation of the geometry with SRID " +"meta data." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:95 +#, no-c-format +msgid "" +" bytea ST_AsEWKB " +"geometry g1 bytea ST_AsEWKB geometry g1 text NDR_or_XDR " +msgstr "" + +#. Tag: para +#: reference_output.xml:110 +#, no-c-format +msgid "" +"Returns the Well-Known Binary representation of the geometry with SRID " +"metadata. There are 2 variants of the function. The first variant takes no " +"endian encoding parameter and defaults to little endian. The second variant " +"takes a second argument denoting the encoding - using little-endian ('NDR') " +"or big-endian ('XDR') encoding." +msgstr "" + +#. Tag: para +#: reference_output.xml:116 +#, no-c-format +msgid "" +"The WKB spec does not include the SRID. To get the OGC WKB format use " +"ST_AsBinary" +msgstr "" + +#. Tag: para +#: reference_output.xml:119 +#, no-c-format +msgid "" +"ST_AsEWKB is the reverse of ST_GeomFromEWKB. Use ST_GeomFromEWKB to convert " +"to a postgis geometry from ST_AsEWKB representation." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:132 +#, no-c-format +msgid "" +"SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n" +"\n" +" st_asewkb\n" +"--------------------------------\n" +"\\001\\003\\000\\000 \\346\\020\\000\\000\\001\\000\n" +"\\000\\000\\005\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\360?\\000\\000\\000\\000\\000\\000\\360?\n" +"\\000\\000\\000\\000\\000\\000\\360?\\000\\000\\000\\000\\000\n" +"\\000\\360?\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"(1 row)" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:133 +#, no-c-format +msgid "" +"SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), " +"'XDR');\n" +" st_asewkb\n" +"--------------------------------\n" +"\\000 " +"\\000\\000\\003\\000\\000\\020\\346\\000\\000\\000\\001\\000\\000\\000\\005\\000\\000\\000\\000\\\n" +"000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000?\n" +"\\360\\000\\000\\000\\000\\000\\000?\\360\\000\\000\\000\\000\\000\\000?" +"\\360\\000\\000\\000\\000\n" +"\\000\\000?" +"\\360\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\n" +"\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000\\000" +msgstr "" + +#. Tag: para +#: reference_output.xml:139 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_output.xml:144 +#, no-c-format +msgid "ST_AsEWKT" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:145 +#, no-c-format +msgid "" +"Return the Well-Known Text (WKT) representation of the geometry with SRID " +"meta data." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:149 +#, no-c-format +msgid "" +" text ST_AsEWKT " +"geometry g1 text ST_AsEWKT geography g1 " +msgstr "" + +#. Tag: para +#: reference_output.xml:164 +#, no-c-format +msgid "" +"Returns the Well-Known Text representation of the geometry prefixed with the " +"SRID." +msgstr "" + +#. Tag: para +#: reference_output.xml:167 +#, no-c-format +msgid "" +"The WKT spec does not include the SRID. To get the OGC WKT format use " +"ST_AsText" +msgstr "" + +#. Tag: para +#: reference_output.xml:169 reference_output.xml:763 +#, no-c-format +msgid "" +"WKT format does not maintain precision so to prevent floating truncation, " +"use ST_AsBinary or ST_AsEWKB format for transport." +msgstr "" + +#. Tag: para +#: reference_output.xml:173 +#, no-c-format +msgid "" +"ST_AsEWKT is the reverse of . Use to convert to a postgis geometry from " +"ST_AsEWKT representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:175 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and " +"TIN was introduced." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:186 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT('0103000020E61000000100000005000000000000\n" +" 000000000000000000000000000000000000000000000000000000\n" +" F03F000000000000F03F000000000000F03F000000000000F03\n" +" F000000000000000000000000000000000000000000000000'::" +"geometry);\n" +"\n" +" st_asewkt\n" +"--------------------------------\n" +"SRID=4326;POLYGON((0 0,0 1,1 1,1 0,0 0))\n" +"(1 row)\n" +"\n" +"SELECT " +"ST_AsEWKT('0108000080030000000000000060E30A4100000000785C0241000000000000F03F0000000018\n" +"E20A4100000000485F024100000000000000400000000018\n" +"E20A4100000000305C02410000000000000840')\n" +"\n" +"--st_asewkt---\n" +"CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)" +msgstr "" + +#. Tag: para +#: reference_output.xml:192 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_output.xml:201 +#, no-c-format +msgid "ST_AsGeoJSON" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:203 +#, no-c-format +msgid "Return the geometry as a GeoJSON element." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:207 +#, no-c-format +msgid "" +" text ST_AsGeoJSON " +"geometry geom " +"integer " +"maxdecimaldigits=15 integer options=0 text ST_AsGeoJSON geography geog integer " +"maxdecimaldigits=15 integer options=0 text ST_AsGeoJSON integer gj_version geometry geom integer " +"maxdecimaldigits=15 integer options=0 text ST_AsGeoJSON integer gj_version geography geog integer " +"maxdecimaldigits=15 integer options=0 " +msgstr "" + +#. Tag: para +#: reference_output.xml:240 +#, no-c-format +msgid "" +"Return the geometry as a Geometry Javascript Object Notation (GeoJSON) " +"element. (Cf GeoJSON " +"specifications 1.0). 2D and 3D Geometries are both supported. " +"GeoJSON only support SFS 1.1 geometry type (no curve support for example)." +msgstr "" + +#. Tag: para +#: reference_output.xml:246 +#, no-c-format +msgid "" +"The gj_version parameter is the major version of the GeoJSON spec. If " +"specified, must be 1. This represents the spec version of GeoJSON." +msgstr "" + +#. Tag: para +#: reference_output.xml:248 +#, no-c-format +msgid "" +"The third argument may be used to reduce the maximum number of decimal " +"places used in output (defaults to 15)." +msgstr "" + +#. Tag: para +#: reference_output.xml:251 +#, no-c-format +msgid "" +"The last 'options' argument could be used to add Bbox or Crs in GeoJSON " +"output:" +msgstr "" + +#. Tag: para +#: reference_output.xml:255 +#, no-c-format +msgid "0: means no option (default value)" +msgstr "" + +#. Tag: para +#: reference_output.xml:259 +#, no-c-format +msgid "1: GeoJSON Bbox" +msgstr "" + +#. Tag: para +#: reference_output.xml:263 +#, no-c-format +msgid "2: GeoJSON Short CRS (e.g EPSG:4326)" +msgstr "" + +#. Tag: para +#: reference_output.xml:267 +#, no-c-format +msgid "4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)" +msgstr "" + +#. Tag: para +#: reference_output.xml:271 +#, no-c-format +msgid "Version 1: ST_AsGeoJSON(geom) / precision=15 version=1 options=0" +msgstr "" + +#. Tag: para +#: reference_output.xml:272 +#, no-c-format +msgid "Version 2: ST_AsGeoJSON(geom, precision) / version=1 options=0" +msgstr "" + +#. Tag: para +#: reference_output.xml:273 +#, no-c-format +msgid "Version 3: ST_AsGeoJSON(geom, precision, options) / version=1" +msgstr "" + +#. Tag: para +#: reference_output.xml:274 +#, no-c-format +msgid "Version 4: ST_AsGeoJSON(gj_version, geom) / precision=15 options=0" +msgstr "" + +#. Tag: para +#: reference_output.xml:275 +#, no-c-format +msgid "Version 5: ST_AsGeoJSON(gj_version, geom, precision) /options=0" +msgstr "" + +#. Tag: para +#: reference_output.xml:276 +#, no-c-format +msgid "Version 6: ST_AsGeoJSON(gj_version, geom, precision,options)" +msgstr "" + +#. Tag: para +#: reference_output.xml:278 +#, no-c-format +msgid "Availability: 1.3.4" +msgstr "" + +#. Tag: para +#: reference_output.xml:280 +#, no-c-format +msgid "Changed: 2.0.0 support default args and named args." +msgstr "" + +#. Tag: para +#: reference_output.xml:286 +#, no-c-format +msgid "" +"GeoJSON format is generally more efficient than other formats for use in " +"ajax mapping. One popular javascript client that supports this is Open " +"Layers. Example of its use is OpenLayers GeoJSON Example" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:291 +#, no-c-format +msgid "" +"SELECT ST_AsGeoJSON(the_geom) from fe_edges limit 1;\n" +" st_asgeojson\n" +"-----------------------------------------------------------------------------------------------------------\n" +"\n" +"{\"type\":\"MultiLineString\",\"coordinates\":" +"[[[-89.734634999999997,31.492072000000000],\n" +"[-89.734955999999997,31.492237999999997]]]}\n" +"(1 row)\n" +"--3d point\n" +"SELECT ST_AsGeoJSON('LINESTRING(1 2 3, 4 5 6)');\n" +"\n" +"st_asgeojson\n" +"-----------------------------------------------------------------------------------------\n" +" {\"type\":\"LineString\",\"coordinates\":[[1,2,3],[4,5,6]]}" +msgstr "" + +#. Tag: refname +#: reference_output.xml:296 +#, no-c-format +msgid "ST_AsGML" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:297 +#, no-c-format +msgid "Return the geometry as a GML version 2 or 3 element." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:301 +#, no-c-format +msgid "" +" text ST_AsGML " +"geometry geom " +"integer " +"maxdecimaldigits=15 integer options=0 text ST_AsGML geography geog integer " +"maxdecimaldigits=15 integer options=0 text ST_AsGML integer version geometry geom integer " +"maxdecimaldigits=15 integer options=0 " +"text nprefix=null text " +"id=null " +"text ST_AsGML " +"integer version " +"geography geog " +"integer " +"maxdecimaldigits=15 integer options=0 " +"text nprefix=null text " +"id=null " +msgstr "" + +#. Tag: para +#: reference_output.xml:341 +#, no-c-format +msgid "" +"Return the geometry as a Geography Markup Language (GML) element. The " +"version parameter, if specified, may be either 2 or 3. If no version " +"parameter is specified then the default is assumed to be 2. The precision " +"argument may be used to reduce the maximum number of decimal places " +"(maxdecimaldigits) used in output (defaults to 15)." +msgstr "" + +#. Tag: para +#: reference_output.xml:346 +#, no-c-format +msgid "GML 2 refer to 2.1.2 version, GML 3 to 3.1.1 version" +msgstr "" + +#. Tag: para +#: reference_output.xml:347 +#, no-c-format +msgid "" +"The 'options' argument is a bitfield. It could be used to define CRS output " +"type in GML output, and to declare data as lat/lon:" +msgstr "" + +#. Tag: para +#: reference_output.xml:351 +#, no-c-format +msgid "0: GML Short CRS (e.g EPSG:4326), default value" +msgstr "" + +#. Tag: para +#: reference_output.xml:355 +#, no-c-format +msgid "1: GML Long CRS (e.g urn:ogc:def:crs:EPSG::4326)" +msgstr "" + +#. Tag: para +#: reference_output.xml:359 +#, no-c-format +msgid "2: For GML 3 only, remove srsDimension attribute from output." +msgstr "" + +#. Tag: para +#: reference_output.xml:363 +#, no-c-format +msgid "" +"4: For GML 3 only, use <LineString> rather than <Curve> tag for " +"lines." +msgstr "" + +#. Tag: para +#: reference_output.xml:367 +#, no-c-format +msgid "" +"16: Declare that datas are lat/lon (e.g srid=4326). Default is to assume " +"that data are planars. This option is useful for GML 3.1.1 output only, " +"related to axis order. So if you set it, it will swap the coordinates so " +"order is lat lon instead of database lon lat." +msgstr "" + +#. Tag: para +#: reference_output.xml:373 +#, no-c-format +msgid "32: Output the box of the geometry (envelope)." +msgstr "" + +#. Tag: para +#: reference_output.xml:378 +#, no-c-format +msgid "" +"The 'namespace prefix' argument may be used to specify a custom namespace " +"prefix or no prefix (if empty). If null or omitted 'gml' prefix is used" +msgstr "" + +#. Tag: para +#: reference_output.xml:382 +#, no-c-format +msgid "Availability: 1.3.2" +msgstr "" + +#. Tag: para +#: reference_output.xml:384 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 prefix support was introduced. Option 4 for GML3 was " +"introduced to allow using LineString instead of Curve tag for lines. GML3 " +"Support for Polyhedral surfaces and TINS was introduced. Option 32 was " +"introduced to output the box." +msgstr "" + +#. Tag: para +#: reference_output.xml:385 +#, no-c-format +msgid "Changed: 2.0.0 use default named args" +msgstr "" + +#. Tag: para +#: reference_output.xml:386 +#, no-c-format +msgid "Enhanced: 2.1.0 id support was introduced, for GML 3." +msgstr "" + +#. Tag: para +#: reference_output.xml:388 +#, no-c-format +msgid "Only version 3+ of ST_AsGML supports Polyhedral Surfaces and TINS." +msgstr "" + +#. Tag: title +#: reference_output.xml:395 +#, no-c-format +msgid "Examples: Version 2" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:396 +#, no-c-format +msgid "" +"0,0 0,1 1,1 1,0 0,0]]>" +msgstr "" + +#. Tag: title +#: reference_output.xml:399 +#, no-c-format +msgid "Examples: Version 3" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:400 +#, no-c-format +msgid "" +"-- Flip coordinates and output extended EPSG (16 | 1)--\n" +"6.34535 5.23423]]>" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:401 +#, no-c-format +msgid "" +"-- Output the envelope (32) --\n" +"\n" +" 1 2\n" +" 10 20\n" +" ]]>" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:403 +#, no-c-format +msgid "" +"-- Output the envelope (32) , reverse (lat lon instead of lon lat) (16), " +"long srs (1)= 32 | 16 | 1 = 49 --\n" +"\n" +" 2 1\n" +" 20 10\n" +"]]>" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:405 +#, no-c-format +msgid "" +"-- Polyhedral Example --\n" +"SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 " +"1, 0 1 0, 0 0 0)), \n" +"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 " +"0)), \n" +"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 " +"1)) )'));\n" +" st_asgml\n" +" --------\n" +"\n" +"\n" +" \n" +" \n" +" \n" +" 0 0 0 0 0 " +"1 0 1 1 0 1 0 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 0 0 0 0 1 " +"0 1 1 0 1 0 0 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 0 0 0 1 0 " +"0 1 0 1 0 0 1 0 0 0\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 1 1 0 1 1 " +"1 1 0 1 1 0 0 1 1 0\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 0 1 0 0 1 " +"1 1 1 1 1 1 0 0 1 0\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" 0 0 1 1 0 " +"1 1 1 1 0 1 1 0 0 1\n" +" \n" +" \n" +" \n" +"\n" +"]]>" +msgstr "" + +#. Tag: refname +#: reference_output.xml:418 +#, no-c-format +msgid "ST_AsHEXEWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:420 +#, no-c-format +msgid "" +"Returns a Geometry in HEXEWKB format (as text) using either little-endian " +"(NDR) or big-endian (XDR) encoding." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:425 +#, no-c-format +msgid "" +" text ST_AsHEXEWKB " +"geometry g1 " +"text NDRorXDR text ST_AsHEXEWKB geometry g1 " +msgstr "" + +#. Tag: para +#: reference_output.xml:442 +#, no-c-format +msgid "" +"Returns a Geometry in HEXEWKB format (as text) using either little-endian " +"(NDR) or big-endian (XDR) encoding. If no encoding is specified, then NDR is " +"used." +msgstr "" + +#. Tag: para +#: reference_output.xml:446 +#, no-c-format +msgid "Availability: 1.2.2" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:454 +#, no-c-format +msgid "" +"SELECT ST_AsHEXEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 " +"0))',4326));\n" +" which gives same answer as\n" +"\n" +" SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 " +"0))',4326)::text;\n" +"\n" +" st_ashexewkb\n" +" --------\n" +" 0103000020E6100000010000000500\n" +" 00000000000000000000000000000000\n" +" 00000000000000000000000000000000F03F\n" +" 000000000000F03F000000000000F03F000000000000F03\n" +" F000000000000000000000000000000000000000000000000" +msgstr "" + +#. Tag: refname +#: reference_output.xml:460 +#, no-c-format +msgid "ST_AsKML" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:462 +#, no-c-format +msgid "" +"Return the geometry as a KML element. Several variants. Default version=2, " +"default precision=15" +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:466 +#, no-c-format +msgid "" +" text ST_AsKML " +"geometry geom " +"integer " +"maxdecimaldigits=15 " +" text ST_AsKML " +"geography geog " +"integer " +"maxdecimaldigits=15 " +" text ST_AsKML " +"integer version " +"geometry geom " +"integer " +"maxdecimaldigits=15 text nprefix=NULL text ST_AsKML integer version geography geog integer " +"maxdecimaldigits=15 text nprefix=NULL " +msgstr "" + +#. Tag: para +#: reference_output.xml:498 +#, no-c-format +msgid "" +"Return the geometry as a Keyhole Markup Language (KML) element. There are " +"several variants of this function. maximum number of decimal places used in " +"output (defaults to 15), version default to 2 and default namespace is no " +"prefix." +msgstr "" + +#. Tag: para +#: reference_output.xml:502 +#, no-c-format +msgid "" +"Version 1: ST_AsKML(geom_or_geog, maxdecimaldigits) / version=2 / " +"maxdecimaldigits=15" +msgstr "" + +#. Tag: para +#: reference_output.xml:503 +#, no-c-format +msgid "" +"Version 2: ST_AsKML(version, geom_or_geog, maxdecimaldigits, nprefix) " +"maxdecimaldigits=15 / nprefix=NULL" +msgstr "" + +#. Tag: para +#: reference_output.xml:506 +#, no-c-format +msgid "" +"Requires PostGIS be compiled with Proj support. Use to confirm you have proj support compiled in." +msgstr "" + +#. Tag: para +#: reference_output.xml:510 +#, no-c-format +msgid "" +"Availability: 1.2.2 - later variants that include version param came in 1.3.2" +msgstr "" + +#. Tag: para +#: reference_output.xml:513 +#, no-c-format +msgid "Enhanced: 2.0.0 - Add prefix namespace. Default is no prefix" +msgstr "" + +#. Tag: para +#: reference_output.xml:516 +#, no-c-format +msgid "Changed: 2.0.0 - uses default args and supports named args" +msgstr "" + +#. Tag: para +#: reference_output.xml:520 +#, no-c-format +msgid "AsKML output will not work with geometries that do not have an SRID" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:528 +#, no-c-format +msgid "" +"0,0 0,1 " +"1,1 1,0 0,0\n" +"\n" +" --3d linestring\n" +" SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');\n" +" 1,2,3 4,5,6\n" +" ]]>" +msgstr "" + +#. Tag: para +#: reference_output.xml:533 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_output.xml:538 +#, no-c-format +msgid "ST_AsSVG" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:540 +#, no-c-format +msgid "" +"Returns a Geometry in SVG path data given a geometry or geography object." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:544 +#, no-c-format +msgid "" +" text ST_AsSVG " +"geometry geom " +"integer rel=0 integer " +"maxdecimaldigits=15 " +" text ST_AsSVG " +"geography geog " +"integer rel=0 integer " +"maxdecimaldigits=15 " +msgstr "" + +#. Tag: para +#: reference_output.xml:563 +#, no-c-format +msgid "" +"Return the geometry as Scalar Vector Graphics (SVG) path data. Use 1 as " +"second argument to have the path data implemented in terms of relative " +"moves, the default (or 0) uses absolute moves. Third argument may be used to " +"reduce the maximum number of decimal digits used in output (defaults to 15). " +"Point geometries will be rendered as cx/cy when 'rel' arg is 0, x/y when " +"'rel' is 1. Multipoint geometries are delimited by commas (\",\"), " +"GeometryCollection geometries are delimited by semicolons (\";\")." +msgstr "" + +#. Tag: para +#: reference_output.xml:573 +#, no-c-format +msgid "" +"Availability: 1.2.2. Availability: 1.4.0 Changed in PostGIS 1.4.0 to include " +"L command in absolute path to conform to http://www.w3.org/TR/SVG/paths." +"html#PathDataBNF" +msgstr "" + +#. Tag: para +#: reference_output.xml:576 +#, no-c-format +msgid "Changed: 2.0.0 to use default args and support named args" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:581 +#, no-c-format +msgid "" +"SELECT ST_AsSVG(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));\n" +"\n" +" st_assvg\n" +" --------\n" +" M 0 0 L 0 -1 1 -1 1 0 Z" +msgstr "" + +#. Tag: refname +#: reference_output.xml:587 +#, no-c-format +msgid "ST_AsX3D" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:589 +#, no-c-format +msgid "" +"Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-" +"X3DEncodings-XML" +msgstr "" + +#. Tag: funcprototype +#: reference_output.xml:594 +#, no-c-format +msgid "" +"text ST_AsX3D " +"geometry g1 " +"integer " +"maxdecimaldigits=15 integer options=0" +msgstr "" + +#. Tag: para +#: reference_output.xml:606 +#, no-c-format +msgid "" +"Returns a geometry as an X3D xml formatted node element http://www.web3d.org/standards/" +"number/19776-1. If maxdecimaldigits (precision) " +"is not specified then defaults to 15." +msgstr "" + +#. Tag: para +#: reference_output.xml:608 +#, no-c-format +msgid "" +"There are various options for translating PostGIS geometries to X3D since " +"X3D geometry types don't map directly to PostGIS geometry types and some " +"newer X3D types that might be better mappings we ahve avoided since most " +"rendering tools don't currently support them. These are the mappings we have " +"settled on. Feel free to post a bug ticket if you have thoughts on the idea " +"or ways we can allow people to denote their preferred mappings." +msgstr "" + +#. Tag: para +#: reference_output.xml:610 +#, no-c-format +msgid "Below is how we currently map PostGIS 2D/3D types to X3D types" +msgstr "" + +#. Tag: entry +#: reference_output.xml:617 +#, no-c-format +msgid "PostGIS Type" +msgstr "" + +#. Tag: entry +#: reference_output.xml:618 +#, no-c-format +msgid "2D X3D Type" +msgstr "" + +#. Tag: entry +#: reference_output.xml:619 +#, no-c-format +msgid "3D X3D Type" +msgstr "" + +#. Tag: entry +#: reference_output.xml:624 +#, no-c-format +msgid "LINESTRING" +msgstr "" + +#. Tag: entry +#: reference_output.xml:625 reference_output.xml:630 +#, no-c-format +msgid "not yet implemented - will be PolyLine2D" +msgstr "" + +#. Tag: entry +#: reference_output.xml:626 +#, no-c-format +msgid "LineSet" +msgstr "" + +#. Tag: entry +#: reference_output.xml:629 +#, no-c-format +msgid "MULTILINESTRING" +msgstr "" + +#. Tag: entry +#: reference_output.xml:631 +#, no-c-format +msgid "IndexedLineSet" +msgstr "" + +#. Tag: entry +#: reference_output.xml:634 +#, no-c-format +msgid "MULTIPOINT" +msgstr "" + +#. Tag: entry +#: reference_output.xml:635 +#, no-c-format +msgid "Polypoint2D" +msgstr "" + +#. Tag: entry +#: reference_output.xml:636 +#, no-c-format +msgid "PointSet" +msgstr "" + +#. Tag: entry +#: reference_output.xml:639 +#, no-c-format +msgid "POINT" +msgstr "" + +#. Tag: entry +#: reference_output.xml:640 reference_output.xml:641 +#, no-c-format +msgid "outputs the space delimited coordinates" +msgstr "" + +#. Tag: entry +#: reference_output.xml:644 +#, no-c-format +msgid "(MULTI) POLYGON, POLYHEDRALSURFACE" +msgstr "" + +#. Tag: entry +#: reference_output.xml:645 +#, no-c-format +msgid "Invalid X3D markup" +msgstr "" + +#. Tag: entry +#: reference_output.xml:646 +#, no-c-format +msgid "IndexedFaceSet (inner rings currently output as another faceset)" +msgstr "" + +#. Tag: entry +#: reference_output.xml:649 +#, no-c-format +msgid "TIN" +msgstr "" + +#. Tag: entry +#: reference_output.xml:650 +#, no-c-format +msgid "TriangleSet2D (Not Yet Implemented)" +msgstr "" + +#. Tag: entry +#: reference_output.xml:651 +#, no-c-format +msgid "IndexedTriangleSet" +msgstr "" + +#. Tag: para +#: reference_output.xml:656 +#, no-c-format +msgid "" +"2D geometry support not yet complete. Inner rings currently just drawn as " +"separate polygons. We are working on these." +msgstr "" + +#. Tag: para +#: reference_output.xml:657 +#, no-c-format +msgid "" +"Lots of advancements happening in 3D space particularly with X3D Integration with HTML5" +msgstr "" + +#. Tag: para +#: reference_output.xml:658 +#, no-c-format +msgid "" +"There is also a nice open source X3D viewer you can use to view rendered " +"geometries. Free Wrl http://" +"freewrl.sourceforge.net/ binaries available for Mac, Linux, and " +"Windows. Use the FreeWRL_Launcher packaged to view the geometries." +msgstr "" + +#. Tag: para +#: reference_output.xml:659 +#, no-c-format +msgid "" +"Also check out PostGIS minimalist X3D viewer that utilizes this function and " +"x3dDom html/js open source toolkit." +msgstr "" + +#. Tag: para +#: reference_output.xml:660 +#, no-c-format +msgid "Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML" +msgstr "" + +#. Tag: title +#: reference_output.xml:672 +#, no-c-format +msgid "" +"Example: Create a fully functional X3D document - This will generate a cube " +"that is viewable in FreeWrl and other X3D viewers." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:673 +#, no-c-format +msgid "" +"\n" +"\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" ' || \n" +" ST_AsX3D( ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, " +"0 1 0, 0 0 0)), \n" +"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 " +"0)), \n" +"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 " +"1)) )')) ||\n" +" '\n" +" \n" +" \n" +"' As x3ddoc;]]>\n" +"\n" +" x3ddoc\n" +" --------\n" +"\n" +"\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +"]]>" +msgstr "" + +#. Tag: title +#: reference_output.xml:676 +#, no-c-format +msgid "Example: An Octagon elevated 3 Units and decimal precision of 6" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:677 +#, no-c-format +msgid "" +"SELECT ST_AsX3D(\n" +"ST_Translate(\n" +" ST_Force_3d(\n" +" ST_Buffer(ST_Point(10,10),5, 'quad_segs=2')), 0,0,\n" +" 3)\n" +" ,6) As x3dfrag;\n" +"\n" +"x3dfrag\n" +"--------\n" +"\n" +" \n" +"]]>" +msgstr "" + +#. Tag: title +#: reference_output.xml:680 +#, no-c-format +msgid "Example: TIN" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:681 +#, no-c-format +msgid "" +"\n" +"\n" +" x3dfrag\n" +" --------\n" +"]]>" +msgstr "" + +#. Tag: title +#: reference_output.xml:684 +#, no-c-format +msgid "Example: Closed multilinestring (the boundary of a polygon with holes)" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:685 +#, no-c-format +msgid "" +"\n" +"\n" +" x3dfrag\n" +" --------\n" +"\n" +" \n" +" ]]>" +msgstr "" + +#. Tag: refname +#: reference_output.xml:691 +#, no-c-format +msgid "ST_GeoHash" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:693 +#, no-c-format +msgid "Return a GeoHash representation of the geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_output.xml:698 +#, no-c-format +msgid "" +"text ST_GeoHash " +"geometry geom " +"integer " +"maxchars=full_precision_of_point" +msgstr "" + +#. Tag: para +#: reference_output.xml:709 +#, no-c-format +msgid "" +"Return a GeoHash representation (http://en.wikipedia.org/wiki/Geohash) of the geometry. A " +"GeoHash encodes a point into a text form that is sortable and searchable " +"based on prefixing. A shorter GeoHash is a less precise representation of a " +"point. It can also be thought of as a box, that contains the actual point." +msgstr "" + +#. Tag: para +#: reference_output.xml:711 +#, no-c-format +msgid "" +"If no maxchars is specficified ST_GeoHash returns a " +"GeoHash based on full precision of the input geometry type. Points return a " +"GeoHash with 20 characters of precision (about enough to hold the full " +"double precision of the input). Other types return a GeoHash with a variable " +"amount of precision, based on the size of the feature. Larger features are " +"represented with less precision, smaller features with more precision. The " +"idea is that the box implied by the GeoHash will always contain the input " +"feature." +msgstr "" + +#. Tag: para +#: reference_output.xml:713 +#, no-c-format +msgid "" +"If maxchars is specified ST_GeoHash returns a GeoHash " +"with at most that many characters so a possibly lower precision " +"representation of the input geometry. For non-points, the starting point of " +"the calculation is the center of the bounding box of the geometry." +msgstr "" + +#. Tag: para +#: reference_output.xml:715 +#, no-c-format +msgid "Availability: 1.4.0" +msgstr "" + +#. Tag: para +#: reference_output.xml:718 +#, no-c-format +msgid "" +"ST_GeoHash will not work with geometries that are not in geographic (lon/" +"lat) coordinates." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:726 +#, no-c-format +msgid "" +"" +msgstr "" + +#. Tag: refname +#: reference_output.xml:737 +#, no-c-format +msgid "ST_AsText" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:738 +#, no-c-format +msgid "" +"Return the Well-Known Text (WKT) representation of the geometry/geography " +"without SRID metadata." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:742 +#, no-c-format +msgid "" +" text ST_AsText " +"geometry g1 text ST_AsText geography g1 " +msgstr "" + +#. Tag: para +#: reference_output.xml:757 +#, no-c-format +msgid "Returns the Well-Known Text representation of the geometry/geography." +msgstr "" + +#. Tag: para +#: reference_output.xml:760 +#, no-c-format +msgid "" +"The WKT spec does not include the SRID. To get the SRID as part of the data, " +"use the non-standard PostGIS " +msgstr "" + +#. Tag: para +#: reference_output.xml:767 +#, no-c-format +msgid "" +"ST_AsText is the reverse of . Use to convert to a postgis geometry from " +"ST_AsText representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:770 +#, no-c-format +msgid "Availability: 1.5 - support for geography was introduced." +msgstr "" + +#. Tag: para +#: reference_output.xml:772 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.25" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:780 +#, no-c-format +msgid "" +"SELECT ST_AsText('01030000000100000005000000000000000000\n" +"000000000000000000000000000000000000000000000000\n" +"F03F000000000000F03F000000000000F03F000000000000F03\n" +"F000000000000000000000000000000000000000000000000');\n" +"\n" +" st_astext\n" +"--------------------------------\n" +" POLYGON((0 0,0 1,1 1,1 0,0 0))\n" +"(1 row)" +msgstr "" + +#. Tag: para +#: reference_output.xml:787 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_output.xml:794 +#, no-c-format +msgid "ST_AsLatLonText" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:795 +#, no-c-format +msgid "Return the Degrees, Minutes, Seconds representation of the given point." +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:799 +#, no-c-format +msgid "" +" text ST_AsLatLonText " +"geometry pt text ST_AsLatLonText geometry pt text format " +msgstr "" + +#. Tag: para +#: reference_output.xml:815 +#, no-c-format +msgid "Returns the Degrees, Minutes, Seconds representation of the point." +msgstr "" + +#. Tag: para +#: reference_output.xml:818 +#, no-c-format +msgid "" +"It is assumed the point is in a lat/lon projection. The X (lon) and Y (lat) " +"coordinates are normalized in the output to the \"normal\" range (-180 to " +"+180 for lon, -90 to +90 for lat)." +msgstr "" + +#. Tag: para +#: reference_output.xml:821 +#, no-c-format +msgid "" +"The text parameter is a format string containing the format for the " +"resulting text, similar to a date format string. Valid tokens are \"D\" for " +"degrees, \"M\" for minutes, \"S\" for seconds, and \"C\" for cardinal " +"direction (NSEW). DMS tokens may be repeated to indicate desired width and " +"precision (\"SSS.SSSS\" means \" 1.0023\")." +msgstr "" + +#. Tag: para +#: reference_output.xml:826 +#, no-c-format +msgid "" +"\"M\", \"S\", and \"C\" are optional. If \"C\" is omitted, degrees are shown " +"with a \"-\" sign if south or west. If \"S\" is omitted, minutes will be " +"shown as decimal with as many digits of precision as you specify. If \"M\" " +"is also omitted, degrees are shown as decimal with as many digits precision " +"as you specify." +msgstr "" + +#. Tag: para +#: reference_output.xml:831 +#, no-c-format +msgid "" +"If the format string is omitted (or zero-length) a default format will be " +"used." +msgstr "" + +#. Tag: para +#: reference_output.xml:837 +#, no-c-format +msgid "Availability: 2.0" +msgstr "" + +#. Tag: para +#: reference_output.xml:843 +#, no-c-format +msgid "Default format." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:844 +#, no-c-format +msgid "" +"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)'));\n" +" st_aslatlontext \n" +"----------------------------\n" +" 2°19'29.928\"S 3°14'3.243\"W" +msgstr "" + +#. Tag: para +#: reference_output.xml:845 +#, no-c-format +msgid "Providing a format (same as the default)." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:846 +#, no-c-format +msgid "" +"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"C'));\n" +" st_aslatlontext \n" +"----------------------------\n" +" 2°19'29.928\"S 3°14'3.243\"W" +msgstr "" + +#. Tag: para +#: reference_output.xml:847 +#, no-c-format +msgid "Characters other than D, M, S, C and . are just passed through." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:848 +#, no-c-format +msgid "" +"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D degrees, M " +"minutes, S seconds to the C'));\n" +" st_aslatlontext \n" +"--------------------------------------------------------------------------------------\n" +" 2 degrees, 19 minutes, 30 seconds to the S 3 degrees, 14 minutes, 3 seconds " +"to the W" +msgstr "" + +#. Tag: para +#: reference_output.xml:849 +#, no-c-format +msgid "Signed degrees instead of cardinal directions." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:850 +#, no-c-format +msgid "" +"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS\"'));\n" +" st_aslatlontext \n" +"----------------------------\n" +" -2°19'29.928\" -3°14'3.243\"" +msgstr "" + +#. Tag: para +#: reference_output.xml:851 +#, no-c-format +msgid "Decimal degrees." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:852 +#, no-c-format +msgid "" +"SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D.DDDD degrees " +"C'));\n" +" st_aslatlontext \n" +"-----------------------------------\n" +" 2.3250 degrees S 3.2342 degrees W" +msgstr "" + +#. Tag: para +#: reference_output.xml:853 +#, no-c-format +msgid "Excessively large values are normalized." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:854 +#, no-c-format +msgid "" +"SELECT (ST_AsLatLonText('POINT (-302.2342342 -792.32498)'));\n" +" st_aslatlontext \n" +"-------------------------------\n" +" 72°19'29.928\"S 57°45'56.757\"E" +msgstr "" + +#. Tag: refname +#: reference_output.xml:862 +#, no-c-format +msgid "ST_AsTWKB" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:863 +#, no-c-format +msgid "Returns the geometry as TWKB, Tiny WKB" +msgstr "" + +#. Tag: funcprototype +#: reference_output.xml:868 +#, no-c-format +msgid "" +"bytea ST_AsTWKB " +"geometry g1 " +"integer decimaldigits int8 geometryID=null boolean include " +"sizes=false boolean " +"include bounding boxes=false" +msgstr "" + +#. Tag: para +#: reference_output.xml:880 reference_output.xml:946 +#, no-c-format +msgid "" +"Returns the geometry in TWKB format. TWKB is a new compressed binary format." +msgstr "" + +#. Tag: para +#: reference_output.xml:881 reference_output.xml:948 +#, no-c-format +msgid "" +"The second parameter is an integer used to define the number of coordinate " +"decimals in the output." +msgstr "" + +#. Tag: para +#: reference_output.xml:882 reference_output.xml:949 +#, no-c-format +msgid "" +"The third parameter is optional. It is used to give each TWKB-geometry an " +"unique ID" +msgstr "" + +#. Tag: para +#: reference_output.xml:883 reference_output.xml:950 +#, no-c-format +msgid "" +"The fourth parameter is optional. If it is set to true, the size of the " +"geometry is included" +msgstr "" + +#. Tag: para +#: reference_output.xml:885 +#, no-c-format +msgid "" +"TWKB is still a moving target. The format is described https://github.com/TWKB/Specification , and code for building a client can be found https://github.com/TWKB/twkb.js" +msgstr "" + +#. Tag: para +#: reference_output.xml:888 +#, no-c-format +msgid "" +"TWKB doesn't make any difference of Z and M. So PointM and PointZ will give " +"the same twkb representation." +msgstr "" + +#. Tag: para +#: reference_output.xml:891 reference_output.xml:956 reference_output.xml:993 +#, no-c-format +msgid "Availability: 2.2.0" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:897 +#, no-c-format +msgid "" +"SELECT ST_AsTWKB('LINESTRING(1 1,5 5)'::geometry,0,1);\n" +" st_astwkb \n" +"--------------------------------------------\n" +"\\x0142020202020808" +msgstr "" + +#. Tag: para +#: reference_output.xml:902 reference_output.xml:967 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_output.xml:908 +#, no-c-format +msgid "ST_AsTWKBAgg" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:909 +#, no-c-format +msgid "Aggregates the geometries and returns as TWKB" +msgstr "" + +#. Tag: funcsynopsis +#: reference_output.xml:913 +#, no-c-format +msgid "" +" bytea ST_AsTWKBAgg " +"geometry set g1 " +"integer decimaldigits bytea " +"ST_AsTWKBAgg geometry set g1 integer " +"decimaldigits int8 " +"geometryID " +" bytea ST_AsTWKBAgg " +"geometry set g1 " +"integer decimaldigits int8 geometryID boolean include sizes bytea " +"ST_AsTWKBAgg geometry set g1 integer " +"decimaldigits int8 " +"geometryID boolean " +"include sizes boolean include bounding boxes " +msgstr "" + +#. Tag: para +#: reference_output.xml:947 +#, no-c-format +msgid "" +"This is the aggregate version of ST_AsTWKB. It aggregates and returns the " +"geometry in TWKB-format. In the resulting TWKB-geometry each individual ID " +"of the input geometries is stored." +msgstr "" + +#. Tag: para +#: reference_output.xml:952 +#, no-c-format +msgid "" +"TWKB is still a moving target. The format is described https://github.com/nicklasaven/TWKB , " +"and code for building a client can be found https://github.com/nicklasaven/twkb_web" +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:962 +#, no-c-format +msgid "" +"SELECT ST_AsTWKBAgg(geom,0,id) FROM\n" +"(SELECT 'LINESTRING(1 1,5 5)'::geometry geom, 1 AS id\n" +"UNION ALL\n" +"SELECT 'LINESTRING(6 5, 1 7)'::geometry AS geom, 2 AS id) foo;\n" +" st_astwkbagg \n" +"----------------------------------------------------------------------------\n" +"\\x015602020202020808040202000904" +msgstr "" + +#. Tag: refname +#: reference_output.xml:973 +#, no-c-format +msgid "ST_AsEncodedPolyline" +msgstr "" + +#. Tag: refpurpose +#: reference_output.xml:974 +#, no-c-format +msgid "Returns an Encoded Polyline from a LineString geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_output.xml:979 +#, no-c-format +msgid "" +"text ST_AsEncodedPolyline " +"geometry geom " +"integer precision=5" +msgstr "" + +#. Tag: para +#: reference_output.xml:990 +#, no-c-format +msgid "Returns the geometry as an Encoded Polyline." +msgstr "" + +#. Tag: programlisting +#: reference_output.xml:998 +#, no-c-format +msgid "" +"ST_AsEncodedPolyline(GeomFromEWKT('SRID=4326;LINESTRING(-120.2 38.5,-120.95 " +"40.7,-126.453 43.252)'));\n" +"--result--\n" +"|_p~iF~ps|U_ulLnnqC_mqNvxq`@" +msgstr "" diff --git a/doc/po/pl/reference_processing.xml.po b/doc/po/pl/reference_processing.xml.po new file mode 100644 index 000000000..0cdc5da0a --- /dev/null +++ b/doc/po/pl/reference_processing.xml.po @@ -0,0 +1,3817 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-09-14 17:50+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_processing.xml:3 +#, no-c-format +msgid "Geometry Processing" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:6 +#, no-c-format +msgid "ST_Buffer" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:8 +#, no-c-format +msgid "" +"(T) For geometry: Returns a geometry that represents all points whose " +"distance from this Geometry is less than or equal to distance. Calculations " +"are in the Spatial Reference System of this Geometry. For geography: Uses a " +"planar transform wrapper. Introduced in 1.5 support for different end cap " +"and mitre settings to control shape. buffer_style options: quad_segs=#," +"endcap=round|flat|square,join=round|mitre|bevel,mitre_limit=#.#" +msgstr "" + +#. Tag: funcsynopsis +#: reference_processing.xml:16 +#, no-c-format +msgid "" +" geometry ST_Buffer " +"geometry g1 " +"float radius_of_buffer geometry " +"ST_Buffer geometry " +"g1 float " +"radius_of_buffer integer num_seg_quarter_circle geometry ST_Buffer geometry g1 float " +"radius_of_buffer text buffer_style_parameters geography ST_Buffer geography g1 float " +"radius_of_buffer_in_meters " +msgstr "" + +#. Tag: title +#: reference_processing.xml:47 reference_processing.xml:221 +#: reference_processing.xml:307 reference_processing.xml:373 +#: reference_processing.xml:522 reference_processing.xml:590 +#: reference_processing.xml:638 reference_processing.xml:736 +#: reference_processing.xml:816 reference_processing.xml:874 +#: reference_processing.xml:942 reference_processing.xml:989 +#: reference_processing.xml:1041 reference_processing.xml:1093 +#: reference_processing.xml:1133 reference_processing.xml:1192 +#: reference_processing.xml:1239 reference_processing.xml:1298 +#: reference_processing.xml:1350 reference_processing.xml:1404 +#: reference_processing.xml:1557 reference_processing.xml:1593 +#: reference_processing.xml:1670 reference_processing.xml:1720 +#: reference_processing.xml:1766 reference_processing.xml:1808 +#: reference_processing.xml:1919 reference_processing.xml:2012 +#: reference_processing.xml:2081 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_processing.xml:49 +#, no-c-format +msgid "" +"Returns a geometry/geography that represents all points whose distance from " +"this Geometry/geography is less than or equal to distance." +msgstr "" + +#. Tag: para +#: reference_processing.xml:51 +#, no-c-format +msgid "" +"Geometry: Calculations are in the Spatial Reference System of the geometry. " +"Introduced in 1.5 support for different end cap and mitre settings to " +"control shape." +msgstr "" + +#. Tag: para +#: reference_processing.xml:54 +#, no-c-format +msgid "" +"Negative radii: For polygons, a negative radius can be used, which will " +"shrink the polygon rather than expanding it." +msgstr "" + +#. Tag: para +#: reference_processing.xml:55 +#, no-c-format +msgid "" +"Geography: For geography this is really a thin wrapper around the geometry " +"implementation. It first determines the best SRID that fits the bounding box " +"of the geography object (favoring UTM, Lambert Azimuthal Equal Area (LAEA) " +"north/south pole, and falling back on mercator in worst case scenario) and " +"then buffers in that planar spatial ref and retransforms back to WGS84 " +"geography." +msgstr "" + +#. Tag: para +#: reference_processing.xml:57 +#, no-c-format +msgid "" +"For geography this may not behave as expected if object is sufficiently " +"large that it falls between two UTM zones or crosses the dateline" +msgstr "" + +#. Tag: para +#: reference_processing.xml:59 +#, no-c-format +msgid "" +"Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and " +"join types. These are useful for example to convert road linestrings into " +"polygon roads with flat or square edges instead of rounded edges. Thin " +"wrapper for geography was added. - requires GEOS >= 3.2 to take advantage " +"of advanced geometry functionality." +msgstr "" + +#. Tag: para +#: reference_processing.xml:62 +#, no-c-format +msgid "" +"The optional third parameter (currently only applies to geometry) can either " +"specify number of segments used to approximate a quarter circle (integer " +"case, defaults to 8) or a list of blank-separated key=value pairs (string " +"case) to tweak operations as follows:" +msgstr "" + +#. Tag: para +#: reference_processing.xml:66 reference_processing.xml:1427 +#, no-c-format +msgid "" +"'quad_segs=#' : number of segments used to approximate a quarter circle " +"(defaults to 8)." +msgstr "" + +#. Tag: para +#: reference_processing.xml:69 +#, no-c-format +msgid "" +"'endcap=round|flat|square' : endcap style (defaults to \"round\", needs " +"GEOS-3.2 or higher for a different value). 'butt' is also accepted as a " +"synonym for 'flat'." +msgstr "" + +#. Tag: para +#: reference_processing.xml:72 +#, no-c-format +msgid "" +"'join=round|mitre|bevel' : join style (defaults to \"round\", needs GEOS-3.2 " +"or higher for a different value). 'miter' is also accepted as a synonym for " +"'mitre'." +msgstr "" + +#. Tag: para +#: reference_processing.xml:75 +#, no-c-format +msgid "" +"'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). " +"'miter_limit' is also accepted as a synonym for 'mitre_limit'." +msgstr "" + +#. Tag: para +#: reference_processing.xml:80 +#, no-c-format +msgid "Units of radius are measured in units of the spatial reference system." +msgstr "" + +#. Tag: para +#: reference_processing.xml:81 +#, no-c-format +msgid "" +"The inputs can be POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, " +"POLYGONS, MULTIPOLYGONS, and GeometryCollections." +msgstr "" + +#. Tag: para +#: reference_processing.xml:82 +#, no-c-format +msgid "" +"This function ignores the third dimension (z) and will always give a 2-d " +"buffer even when presented with a 3d-geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:84 reference_processing.xml:1444 +#: reference_processing.xml:1732 reference_processing.xml:1775 +#: reference_processing.xml:2032 +#, no-c-format +msgid "Performed by the GEOS module." +msgstr "" + +#. Tag: para +#: reference_processing.xml:85 reference_processing.xml:541 +#: reference_processing.xml:747 reference_processing.xml:1063 +#: reference_processing.xml:1930 reference_processing.xml:2041 +#, no-c-format +msgid "&sfs_compliant; s2.1.1.3" +msgstr "" + +#. Tag: para +#: reference_processing.xml:86 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.17" +msgstr "" + +#. Tag: para +#: reference_processing.xml:88 +#, no-c-format +msgid "" +"People often make the mistake of using this function to try to do radius " +"searches. Creating a buffer to to a radius search is slow and pointless. Use " +" instead." +msgstr "" + +#. Tag: title +#: reference_processing.xml:93 reference_processing.xml:238 +#: reference_processing.xml:343 reference_processing.xml:411 +#: reference_processing.xml:547 reference_processing.xml:604 +#: reference_processing.xml:754 reference_processing.xml:957 +#: reference_processing.xml:1067 reference_processing.xml:1104 +#: reference_processing.xml:1208 reference_processing.xml:1256 +#: reference_processing.xml:1367 reference_processing.xml:1453 +#: reference_processing.xml:1690 reference_processing.xml:1737 +#: reference_processing.xml:1781 reference_processing.xml:1823 +#: reference_processing.xml:1938 reference_processing.xml:2048 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: para +#: reference_processing.xml:104 +#, no-c-format +msgid "quad_segs=8 (default)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:107 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText('POINT(100 90)'),\n" +" 50, 'quad_segs=8');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:115 +#, no-c-format +msgid "quad_segs=2 (lame)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:118 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText('POINT(100 90)'),\n" +" 50, 'quad_segs=2');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:127 +#, no-c-format +msgid "endcap=round join=round (default)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:130 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'\n" +" ), 10, 'endcap=round join=round');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:138 +#, no-c-format +msgid "endcap=square" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:141 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'\n" +" ), 10, 'endcap=square join=round');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:149 +#, no-c-format +msgid "endcap=flat" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:152 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'\n" +" ), 10, 'endcap=flat join=round');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:161 +#, no-c-format +msgid "join=bevel" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:164 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'\n" +" ), 10, 'join=bevel');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:172 +#, no-c-format +msgid "join=mitre mitre_limit=5.0 (default mitre limit)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:175 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'\n" +" ), 10, 'join=mitre mitre_limit=5.0');" +msgstr "" + +#. Tag: para +#: reference_processing.xml:183 +#, no-c-format +msgid "join=mitre mitre_limit=1" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:186 +#, no-c-format +msgid "" +"SELECT ST_Buffer(\n" +" ST_GeomFromText(\n" +" 'LINESTRING(50 50,150 150,150 50)'\n" +" ), 10, 'join=mitre mitre_limit=1.0');" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:193 +#, no-c-format +msgid "" +"--A buffered point approximates a circle\n" +"-- A buffered point forcing approximation of (see diagram)\n" +"-- 2 points per circle is poly with 8 sides (see diagram)\n" +"SELECT ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50)) As " +"promisingcircle_pcount,\n" +"ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50, 2)) As " +"lamecircle_pcount;\n" +"\n" +"promisingcircle_pcount | lamecircle_pcount\n" +"------------------------+-------------------\n" +" 33 | 9\n" +"\n" +"--A lighter but lamer circle\n" +"-- only 2 points per quarter circle is an octagon\n" +"--Below is a 100 meter octagon\n" +"-- Note coordinates are in NAD 83 long lat which we transform\n" +"to Mass state plane meter and then buffer to get measurements in meters;\n" +"SELECT ST_AsText(ST_Buffer(\n" +"ST_Transform(\n" +"ST_SetSRID(ST_MakePoint(-71.063526, 42.35785),4269), 26986)\n" +",100,2)) As octagon;\n" +"----------------------\n" +"POLYGON((236057.59057465 900908.759918696,236028.301252769 " +"900838.049240578,235\n" +"957.59057465 900808.759918696,235886.879896532 " +"900838.049240578,235857.59057465\n" +"900908.759918696,235886.879896532 900979.470596815,235957.59057465 " +"901008.759918\n" +"696,236028.301252769 900979.470596815,236057.59057465 900908.759918696))" +msgstr "" + +#. Tag: title +#: reference_processing.xml:197 reference_processing.xml:272 +#: reference_processing.xml:350 reference_processing.xml:500 +#: reference_processing.xml:563 reference_processing.xml:611 +#: reference_processing.xml:711 reference_processing.xml:794 +#: reference_processing.xml:853 reference_processing.xml:920 +#: reference_processing.xml:964 reference_processing.xml:1071 +#: reference_processing.xml:1111 reference_processing.xml:1165 +#: reference_processing.xml:1215 reference_processing.xml:1269 +#: reference_processing.xml:1322 reference_processing.xml:1373 +#: reference_processing.xml:1535 reference_processing.xml:1571 +#: reference_processing.xml:1641 reference_processing.xml:1697 +#: reference_processing.xml:1742 reference_processing.xml:1786 +#: reference_processing.xml:1894 reference_processing.xml:1979 +#: reference_processing.xml:2055 reference_processing.xml:2109 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: para +#: reference_processing.xml:199 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:205 +#, no-c-format +msgid "ST_BuildArea" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:207 +#, no-c-format +msgid "" +"Creates an areal geometry formed by the constituent linework of given " +"geometry" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:213 +#, no-c-format +msgid "" +"geometry ST_BuildArea " +"geometry A" +msgstr "" + +#. Tag: para +#: reference_processing.xml:223 +#, no-c-format +msgid "" +"Creates an areal geometry formed by the constituent linework of given " +"geometry. The return type can be a Polygon or MultiPolygon, depending on " +"input. If the input lineworks do not form polygons NULL is returned. The " +"inputs can be LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS, and " +"GeometryCollections." +msgstr "" + +#. Tag: para +#: reference_processing.xml:228 +#, no-c-format +msgid "This function will assume all inner geometries represent holes" +msgstr "" + +#. Tag: para +#: reference_processing.xml:231 reference_processing.xml:1310 +#, no-c-format +msgid "" +"Input linework must be correctly noded for this function to work properly" +msgstr "" + +#. Tag: para +#: reference_processing.xml:234 +#, no-c-format +msgid "Availability: 1.1.0 - requires GEOS >= 2.1.0." +msgstr "" + +#. Tag: para +#: reference_processing.xml:248 +#, no-c-format +msgid "This will create a donut" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:251 +#, no-c-format +msgid "" +"SELECT ST_BuildArea(ST_Collect(smallc,bigc))\n" +"FROM (SELECT\n" +" ST_Buffer(\n" +" ST_GeomFromText('POINT(100 90)'), 25) As smallc,\n" +" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As bigc) As foo;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:260 +#, no-c-format +msgid "" +"This will create a gaping hole inside the circle with prongs sticking out" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:263 +#, no-c-format +msgid "" +"SELECT ST_BuildArea(ST_Collect(line,circle))\n" +"FROM (SELECT\n" +" ST_Buffer(\n" +" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)),\n" +" 5) As line,\n" +" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;\n" +"\n" +"--this creates the same gaping hole\n" +"--but using linestrings instead of polygons\n" +"SELECT ST_BuildArea(\n" +" ST_Collect(ST_ExteriorRing(line),ST_ExteriorRing(circle))\n" +" )\n" +"FROM (SELECT ST_Buffer(\n" +" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190))\n" +" ,5) As line,\n" +" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:274 +#, no-c-format +msgid "" +", , , " +"wrappers to this function with " +"standard OGC interface" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:284 +#, no-c-format +msgid "ST_Collect" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:285 +#, no-c-format +msgid "" +"Return a specified ST_Geometry value from a collection of other geometries." +msgstr "" + +#. Tag: funcsynopsis +#: reference_processing.xml:289 +#, no-c-format +msgid "" +" geometry ST_Collect " +"geometry set g1field geometry " +"ST_Collect geometry " +"g1 geometry " +"g2 " +"geometry ST_Collect " +"geometry[] g1_array " +"" +msgstr "" + +#. Tag: para +#: reference_processing.xml:308 +#, no-c-format +msgid "" +"Output type can be a MULTI* or a GEOMETRYCOLLECTION. Comes in 2 variants. " +"Variant 1 collects 2 geometries. Variant 2 is an aggregate function that " +"takes a set of geometries and collects them into a single ST_Geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:312 +#, no-c-format +msgid "" +"Aggregate version: This function returns a GEOMETRYCOLLECTION or a MULTI " +"object from a set of geometries. The ST_Collect() function is an \"aggregate" +"\" function in the terminology of PostgreSQL. That means that it operates on " +"rows of data, in the same way the SUM() and AVG() functions do. For example, " +"\"SELECT ST_Collect(GEOM) FROM GEOMTABLE GROUP BY ATTRCOLUMN\" will return a " +"separate GEOMETRYCOLLECTION for each distinct value of ATTRCOLUMN." +msgstr "" + +#. Tag: para +#: reference_processing.xml:320 +#, no-c-format +msgid "" +"Non-Aggregate version: This function returns a geometry being a collection " +"of two input geometries. Output type can be a MULTI* or a GEOMETRYCOLLECTION." +msgstr "" + +#. Tag: para +#: reference_processing.xml:324 +#, no-c-format +msgid "" +"ST_Collect and ST_Union are often interchangeable. ST_Collect is in general " +"orders of magnitude faster than ST_Union because it does not try to dissolve " +"boundaries or validate that a constructed MultiPolgon doesn't have " +"overlapping regions. It merely rolls up single geometries into MULTI and " +"MULTI or mixed geometry types into Geometry Collections. Unfortunately " +"geometry collections are not well-supported by GIS tools. To prevent " +"ST_Collect from returning a Geometry Collection when collecting MULTI " +"geometries, one can use the below trick that utilizes to expand the MULTIs out to singles and then regroup them." +msgstr "" + +#. Tag: para +#: reference_processing.xml:335 +#, no-c-format +msgid "" +"Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was " +"enhanced to handle more geometries faster." +msgstr "" + +#. Tag: para +#: reference_processing.xml:336 reference_processing.xml:543 +#: reference_processing.xml:598 reference_processing.xml:650 +#: reference_processing.xml:840 reference_processing.xml:894 +#: reference_processing.xml:952 reference_processing.xml:992 +#: reference_processing.xml:1098 reference_processing.xml:1160 +#: reference_processing.xml:1203 reference_processing.xml:1357 +#: reference_processing.xml:1567 reference_processing.xml:1682 +#: reference_processing.xml:2101 +#, no-c-format +msgid "&Z_support;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:337 +#, no-c-format +msgid "" +"&curve_support; This method supports Circular Strings and Curves, but will " +"never return a MULTICURVE or MULTI as one would expect and PostGIS does not " +"currently support those." +msgstr "" + +#. Tag: para +#: reference_processing.xml:344 +#, no-c-format +msgid "" +"Aggregate example (http://postgis.refractions.net/" +"pipermail/postgis-users/2008-June/020331.html)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:345 +#, no-c-format +msgid "" +"SELECT stusps,\n" +" ST_Multi(ST_Collect(f.the_geom)) as singlegeom\n" +" FROM (SELECT stusps, (ST_Dump(the_geom)).geom As the_geom\n" +" FROM\n" +" somestatetable ) As f\n" +"GROUP BY stusps" +msgstr "" + +#. Tag: para +#: reference_processing.xml:346 reference_processing.xml:2051 +#, no-c-format +msgid "Non-Aggregate example" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:347 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'),\n" +" ST_GeomFromText('POINT(-2 3)') ));\n" +"\n" +"st_astext\n" +"----------\n" +"MULTIPOINT(1 2,-2 3)\n" +"\n" +"--Collect 2 d points\n" +"SELECT ST_AsText(ST_Collect(ST_GeomFromText('POINT(1 2)'),\n" +" ST_GeomFromText('POINT(1 2)') ) );\n" +"\n" +"st_astext\n" +"----------\n" +"MULTIPOINT(1 2,1 2)\n" +"\n" +"--Collect 3d points\n" +"SELECT ST_AsEWKT(ST_Collect(ST_GeomFromEWKT('POINT(1 2 3)'),\n" +" ST_GeomFromEWKT('POINT(1 2 4)') ) );\n" +"\n" +" st_asewkt\n" +"-------------------------\n" +" MULTIPOINT(1 2 3,1 2 4)\n" +"\n" +" --Example with curves\n" +"SELECT ST_AsText(ST_Collect(ST_GeomFromText('CIRCULARSTRING(220268 " +"150415,220227 150505,220227 150406)'),\n" +"ST_GeomFromText('CIRCULARSTRING(220227 150406,2220227 150407,220227 " +"150406)')));\n" +" st_astext\n" +"------------------------------------------------------------------------------------\n" +" GEOMETRYCOLLECTION(CIRCULARSTRING(220268 150415,220227 150505,220227 " +"150406),\n" +" CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))\n" +"\n" +"--New ST_Collect array construct\n" +"SELECT ST_Collect(ARRAY(SELECT the_geom FROM sometable));\n" +"\n" +"SELECT ST_AsText(ST_Collect(ARRAY[ST_GeomFromText('LINESTRING(1 2, 3 4)'),\n" +" ST_GeomFromText('LINESTRING(3 4, 4 5)')])) As " +"wktcollect;\n" +"\n" +"--wkt collect --\n" +"MULTILINESTRING((1 2,3 4),(3 4,4 5))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:351 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:356 +#, no-c-format +msgid "ST_ConcaveHull" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:357 +#, no-c-format +msgid "" +"The concave hull of a geometry represents a possibly concave geometry that " +"encloses all geometries within the set. You can think of it as shrink " +"wrapping." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:363 +#, no-c-format +msgid "" +"geometry ST_ConcaveHull " +"geometry geomA " +"float target_percent boolean " +"allow_holes=false" +msgstr "" + +#. Tag: para +#: reference_processing.xml:374 +#, no-c-format +msgid "" +"The concave hull of a geometry represents a possibly concave geometry that " +"encloses all geometries within the set. Defaults to false for allowing " +"polygons with holes. The result is never higher than a single polygon." +msgstr "" + +#. Tag: para +#: reference_processing.xml:378 +#, no-c-format +msgid "" +"The target_percent is the target percent of area of convex hull the PostGIS " +"solution will try to approach before giving up or exiting. One can think of " +"the concave hull as the geometry you get by vacuum sealing a set of " +"geometries. The target_percent of 1 will give you the same answer as the " +"convex hull. A target_percent between 0 and 0.99 will give you something " +"that should have a smaller area than the convex hull. This is different from " +"a convex hull which is more like wrapping a rubber band around the set of " +"geometries." +msgstr "" + +#. Tag: para +#: reference_processing.xml:383 +#, no-c-format +msgid "" +"It is usually used with MULTI and Geometry Collections. Although it is not " +"an aggregate - you can use it in conjunction with ST_Collect or ST_Union to " +"get the concave hull of a set of points/linestring/polygons " +"ST_ConcaveHull(ST_Collect(somepointfield), 0.80)." +msgstr "" + +#. Tag: para +#: reference_processing.xml:388 +#, no-c-format +msgid "" +"It is much slower to compute than convex hull but encloses the geometry " +"better and is also useful for image recognition." +msgstr "" + +#. Tag: para +#: reference_processing.xml:391 reference_processing.xml:539 +#: reference_processing.xml:743 reference_processing.xml:1059 +#: reference_processing.xml:1926 +#, no-c-format +msgid "Performed by the GEOS module" +msgstr "" + +#. Tag: para +#: reference_processing.xml:392 +#, no-c-format +msgid "" +"Note - If you are using with points, linestrings, or geometry collections " +"use ST_Collect. If you are using with polygons, use ST_Union since it may " +"fail with invalid geometries." +msgstr "" + +#. Tag: para +#: reference_processing.xml:395 +#, no-c-format +msgid "" +"Note - The smaller you make the target percent, the longer it takes to " +"process the concave hull and more likely to run into topological exceptions. " +"Also the more floating points and number of points you accrue. First try a " +"0.99 which does a first hop, is usually very fast, sometimes as fast as " +"computing the convex hull, and usually gives much better than 99% of shrink " +"since it almost always overshoots. Second hope of 0.98 it slower, others get " +"slower usually quadratically. To reduce precision and float points, use " +" or after ST_ConcaveHull. ST_SnapToGrid is a bit faster, but " +"could result in invalid geometries where as ST_SimplifyPreserveTopology " +"almost always preserves the validity of the geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:400 +#, no-c-format +msgid "" +"More real world examples and brief explanation of the technique are shown " +"http://" +"www.bostongis.com/postgis_concavehull.snippet" +msgstr "" + +#. Tag: para +#: reference_processing.xml:403 +#, no-c-format +msgid "" +"Also check out Simon Greener's article on demonstrating ConcaveHull " +"introduced in Oracle 11G R2. http://www.spatialdbadvisor.com/" +"oracle_spatial_tips_tricks/172/concave-hull-geometries-in-oracle-11gr2. The solution we get at 0.75 target percent of convex hull is similar " +"to the shape Simon gets with Oracle SDO_CONCAVEHULL_BOUNDARY." +msgstr "" + +#. Tag: para +#: reference_processing.xml:407 reference_processing.xml:994 +#: reference_processing.xml:1565 reference_processing.xml:1819 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:412 +#, no-c-format +msgid "" +"--Get estimate of infected area based on point observations\n" +"SELECT d.disease_type,\n" +" ST_ConcaveHull(ST_Collect(d.pnt_geom), 0.99) As geom\n" +" FROM disease_obs As d\n" +" GROUP BY d.disease_type;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:422 +#, no-c-format +msgid "ST_ConcaveHull of 2 polygons encased in target 100% shrink concave hull" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:425 +#, no-c-format +msgid "" +"-- geometries overlaid with concavehull \n" +"-- at target 100% shrink (this is the same as convex hull - since no " +"shrink)\n" +"SELECT \n" +" ST_ConcaveHull(\n" +" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n" +" 50 60, 125 100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" ), 1) \n" +" As convexhull;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:432 +#, no-c-format +msgid "" +"-- geometries overlaid with concavehull at target 90% of convex hull area" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:436 +#, no-c-format +msgid "" +"-- geometries overlaid with concavehull at target 90% shrink\n" +"SELECT \n" +" ST_ConcaveHull(\n" +" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n" +" 50 60, 125 100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" ), 0.9) \n" +" As target_90;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:445 +#, no-c-format +msgid "L Shape points overlaid with convex hull" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:448 +#, no-c-format +msgid "" +"-- this produces a table of 42 points that form an L shape\n" +"SELECT (ST_DumpPoints(ST_GeomFromText(\n" +"'MULTIPOINT(14 14,34 14,54 14,74 14,94 14,114 14,134 14,\n" +"150 14,154 14,154 6,134 6,114 6,94 6,74 6,54 6,34 6,\n" +"14 6,10 6,8 6,7 7,6 8,6 10,6 30,6 50,6 70,6 90,6 110,6 130,\n" +"6 150,6 170,6 190,6 194,14 194,14 174,14 154,14 134,14 114,\n" +"14 94,14 74,14 54,14 34,14 14)'))).geom \n" +" INTO TABLE l_shape;\n" +"\n" +"SELECT ST_ConvexHull(ST_Collect(geom))\n" +"FROM l_shape;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:455 +#, no-c-format +msgid "ST_ConcaveHull of L points at target 99% of convex hull" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:458 +#, no-c-format +msgid "" +"SELECT ST_ConcaveHull(ST_Collect(geom), 0.99)\n" +" FROM l_shape;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:467 +#, no-c-format +msgid "Concave Hull of L points at target 80% convex hull area" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:470 +#, no-c-format +msgid "" +"-- Concave Hull L shape points\n" +" -- at target 80% of convexhull\n" +" SELECT ST_ConcaveHull(ST_Collect(geom), 0.80)\n" +" FROM l_shape;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:479 +#, no-c-format +msgid "multilinestring overlaid with Convex hull" +msgstr "" + +#. Tag: para +#: reference_processing.xml:487 +#, no-c-format +msgid "" +"multilinestring with overlaid with Concave hull of linestrings at 99% target " +"-- first hop" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:491 +#, no-c-format +msgid "" +"SELECT ST_ConcaveHull(ST_GeomFromText('MULTILINESTRING((106 164,30 112,74 " +"70,82 112,130 94,\n" +" 130 62,122 40,156 32,162 76,172 88),\n" +"(132 178,134 148,128 136,96 128,132 108,150 130,\n" +"170 142,174 110,156 96,158 90,158 88),\n" +"(22 64,66 28,94 38,94 68,114 76,112 30,\n" +"132 10,168 18,178 34,186 52,184 74,190 100,\n" +"190 122,182 148,178 170,176 184,156 164,146 178,\n" +"132 186,92 182,56 158,36 150,62 150,76 128,88 118))'),0.99)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:501 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:507 +#, no-c-format +msgid "ST_ConvexHull" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:508 +#, no-c-format +msgid "" +"The convex hull of a geometry represents the minimum convex " +"geometry that encloses all geometries within the set." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:514 +#, no-c-format +msgid "" +"geometry ST_ConvexHull " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_processing.xml:523 +#, no-c-format +msgid "" +"The convex hull of a geometry represents the minimum convex geometry " +"that encloses all geometries within the set." +msgstr "" + +#. Tag: para +#: reference_processing.xml:526 +#, no-c-format +msgid "" +"One can think of the convex hull as the geometry you get by wrapping an " +"elastic band around a set of geometries. This is different from a concave " +"hull which is analogous to shrink-wrapping your geometries." +msgstr "" + +#. Tag: para +#: reference_processing.xml:530 +#, no-c-format +msgid "" +"It is usually used with MULTI and Geometry Collections. Although it is not " +"an aggregate - you can use it in conjunction with ST_Collect to get the " +"convex hull of a set of points. ST_ConvexHull(ST_Collect(somepointfield))." +msgstr "" + +#. Tag: para +#: reference_processing.xml:535 +#, no-c-format +msgid "" +"It is often used to determine an affected area based on a set of point " +"observations." +msgstr "" + +#. Tag: para +#: reference_processing.xml:542 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.16" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:548 +#, no-c-format +msgid "" +"--Get estimate of infected area based on point observations\n" +"SELECT d.disease_type,\n" +" ST_ConvexHull(ST_Collect(d.the_geom)) As the_geom\n" +" FROM disease_obs As d\n" +" GROUP BY d.disease_type;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:556 +#, no-c-format +msgid "" +"Convex Hull of a MultiLinestring and a MultiPoint seen together with the " +"MultiLinestring and MultiPoint" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:559 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_ConvexHull(\n" +" ST_Collect(\n" +" ST_GeomFromText('MULTILINESTRING((100 190,10 8),(150 10, 20 " +"30))'),\n" +" ST_GeomFromText('MULTIPOINT(50 5, 150 30, 50 10, 10 " +"10)')\n" +" )) );\n" +"---st_astext--\n" +"POLYGON((50 5,10 8,10 10,100 190,150 30,150 10,50 5))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:564 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:570 +#, no-c-format +msgid "ST_CurveToLine" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:572 +#, no-c-format +msgid "Converts a CIRCULARSTRING/CURVEDPOLYGON to a LINESTRING/POLYGON" +msgstr "" + +#. Tag: funcsynopsis +#: reference_processing.xml:576 +#, no-c-format +msgid "" +" geometry ST_CurveToLine geometry curveGeom geometry " +"ST_CurveToLine geometry curveGeom integer segments_per_qtr_circle " +msgstr "" + +#. Tag: para +#: reference_processing.xml:592 +#, no-c-format +msgid "" +"Converst a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON. " +"Useful for outputting to devices that can't support CIRCULARSTRING geometry " +"types" +msgstr "" + +#. Tag: para +#: reference_processing.xml:593 +#, no-c-format +msgid "" +"Converts a given geometry to a linear geometry. Each curved geometry or " +"segment is converted into a linear approximation using the default value of " +"32 segments per quarter circle" +msgstr "" + +#. Tag: para +#: reference_processing.xml:595 reference_processing.xml:1097 +#, no-c-format +msgid "Availability: 1.2.2?" +msgstr "" + +#. Tag: para +#: reference_processing.xml:596 +#, no-c-format +msgid "&sfs_compliant;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:597 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 7.1.7" +msgstr "" + +#. Tag: para +#: reference_processing.xml:599 reference_processing.xml:837 +#: reference_processing.xml:891 reference_processing.xml:991 +#: reference_processing.xml:1099 +#, no-c-format +msgid "&curve_support;" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:606 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 " +"150415,220227 150505,220227 150406)')));\n" +"\n" +"--Result --\n" +" LINESTRING(220268 150415,220269.95064912 150416.539364228,220271.823415575 " +"150418.17258804,220273.613787707 150419.895736857,\n" +" 220275.317452352 150421.704659462,220276.930305234 " +"150423.594998003,220278.448460847 150425.562198489,\n" +" 220279.868261823 150427.60152176,220281.186287736 " +"150429.708054909,220282.399363347 150431.876723113,\n" +" 220283.50456625 150434.10230186,220284.499233914 " +"150436.379429536,220285.380970099 150438.702620341,220286.147650624 " +"150441.066277505,\n" +" 220286.797428488 150443.464706771,220287.328738321 " +"150445.892130112,220287.740300149 150448.342699654,\n" +" 220288.031122486 150450.810511759,220288.200504713 " +"150453.289621251,220288.248038775 150455.77405574,\n" +" 220288.173610157 150458.257830005,220287.977398166 " +"150460.734960415,220287.659875492 150463.199479347,\n" +" 220287.221807076 150465.64544956,220286.664248262 " +"150468.066978495,220285.988542259 150470.458232479,220285.196316903 " +"150472.81345077,\n" +" 220284.289480732 150475.126959442,220283.270218395 " +"150477.39318505,220282.140985384 150479.606668057,\n" +" 220280.90450212 150481.762075989,220279.5637474 " +"150483.85421628,220278.12195122 150485.87804878,\n" +" 220276.582586992 150487.828697901,220274.949363179 " +"150489.701464356,220273.226214362 150491.491836488,\n" +" 220271.417291757 150493.195501133,220269.526953216 " +"150494.808354014,220267.559752731 150496.326509628,\n" +" 220265.520429459 150497.746310603,220263.41389631 " +"150499.064336517,220261.245228106 150500.277412127,\n" +" 220259.019649359 150501.38261503,220256.742521683 " +"150502.377282695,220254.419330878 150503.259018879,\n" +" 220252.055673714 150504.025699404,220249.657244448 " +"150504.675477269,220247.229821107 150505.206787101,\n" +" 220244.779251566 150505.61834893,220242.311439461 " +"150505.909171266,220239.832329968 150506.078553494,\n" +" 220237.347895479 150506.126087555,220234.864121215 " +"150506.051658938,220232.386990804 150505.855446946,\n" +" 220229.922471872 150505.537924272,220227.47650166 " +"150505.099855856,220225.054972724 150504.542297043,\n" +" 220222.663718741 150503.86659104,220220.308500449 150503.074365683,\n" +" 220217.994991777 150502.167529512,220215.72876617 150501.148267175,\n" +" 220213.515283163 150500.019034164,220211.35987523 150498.7825509,\n" +" 220209.267734939 150497.441796181,220207.243902439 150496,\n" +" 220205.293253319 150494.460635772,220203.420486864 " +"150492.82741196,220201.630114732 150491.104263143,\n" +" 220199.926450087 150489.295340538,220198.313597205 " +"150487.405001997,220196.795441592 150485.437801511,\n" +" 220195.375640616 150483.39847824,220194.057614703 " +"150481.291945091,220192.844539092 150479.123276887,220191.739336189 " +"150476.89769814,\n" +" 220190.744668525 150474.620570464,220189.86293234 " +"150472.297379659,220189.096251815 150469.933722495,\n" +" 220188.446473951 150467.535293229,220187.915164118 " +"150465.107869888,220187.50360229 150462.657300346,\n" +" 220187.212779953 150460.189488241,220187.043397726 " +"150457.710378749,220186.995863664 150455.22594426,\n" +" 220187.070292282 150452.742169995,220187.266504273 " +"150450.265039585,220187.584026947 150447.800520653,\n" +" 220188.022095363 150445.35455044,220188.579654177 " +"150442.933021505,220189.25536018 150440.541767521,\n" +" 220190.047585536 150438.18654923,220190.954421707 " +"150435.873040558,220191.973684044 150433.60681495,\n" +" 220193.102917055 150431.393331943,220194.339400319 " +"150429.237924011,220195.680155039 150427.14578372,220197.12195122 " +"150425.12195122,\n" +" 220198.661315447 150423.171302099,220200.29453926 " +"150421.298535644,220202.017688077 150419.508163512,220203.826610682 " +"150417.804498867,\n" +" 220205.716949223 150416.191645986,220207.684149708 " +"150414.673490372,220209.72347298 150413.253689397,220211.830006129 " +"150411.935663483,\n" +" 220213.998674333 150410.722587873,220216.22425308 " +"150409.61738497,220218.501380756 150408.622717305,220220.824571561 " +"150407.740981121,\n" +" 220223.188228725 150406.974300596,220225.586657991 150406.324522731,220227 " +"150406)\n" +"\n" +"--3d example\n" +"SELECT ST_AsEWKT(ST_CurveToLine(ST_GeomFromEWKT('CIRCULARSTRING(220268 " +"150415 1,220227 150505 2,220227 150406 3)')));\n" +"Output\n" +"------\n" +" LINESTRING(220268 150415 1,220269.95064912 150416.539364228 " +"1.0181172856673,\n" +" 220271.823415575 150418.17258804 1.03623457133459,220273.613787707 " +"150419.895736857 1.05435185700189,....AD INFINITUM ....\n" +" 220225.586657991 150406.324522731 1.32611114201132,220227 150406 3)\n" +"\n" +"--use only 2 segments to approximate quarter circle\n" +"SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 " +"150415,220227 150505,220227 150406)'),2));\n" +"st_astext\n" +"------------------------------\n" +" LINESTRING(220268 150415,220287.740300149 150448.342699654,220278.12195122 " +"150485.87804878,\n" +" 220244.779251566 150505.61834893,220207.243902439 150496,220187.50360229 " +"150462.657300346,\n" +" 220197.12195122 150425.12195122,220227 150406)" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:619 +#, no-c-format +msgid "ST_DelaunayTriangles" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:621 +#, no-c-format +msgid "Return a Delaunay triangulation around the given input points." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:628 +#, no-c-format +msgid "" +"geometry ST_DelaunayTriangles " +"geometry g1 " +"float tolerance " +"int4 flags" +msgstr "" + +#. Tag: para +#: reference_processing.xml:640 +#, no-c-format +msgid "" +"Return a Delaunay triangulation around the vertices of the input geometry. " +"Output is a COLLECTION of polygons (for flags=0) or a MULTILINESTRING (for " +"flags=1). The tolerance, if any, is used to snap input vertices togheter." +msgstr "" + +#. Tag: para +#: reference_processing.xml:649 +#, no-c-format +msgid "Availability: 2.1.0 - requires GEOS >= 3.4.0." +msgstr "" + +#. Tag: title +#: reference_processing.xml:654 +#, no-c-format +msgid "2D Examples" +msgstr "" + +#. Tag: para +#: reference_processing.xml:663 +#, no-c-format +msgid "Original polygons" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:666 +#, no-c-format +msgid "" +"-- our original geometry --\n" +" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n" +" 50 60, 125 100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" )" +msgstr "" + +#. Tag: para +#: reference_processing.xml:674 +#, no-c-format +msgid "" +"ST_DelaunayTriangles of 2 polygons: delaunay triangle polygons each triangle " +"themed in different color" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:677 +#, no-c-format +msgid "" +"-- geometries overlaid multilinestring triangles\n" +"SELECT \n" +" ST_DelaunayTriangles(\n" +" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n" +" 50 60, 125 100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" )) \n" +" As dtriag;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:684 +#, no-c-format +msgid "-- delaunay triangles as multilinestring" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:687 +#, no-c-format +msgid "" +"SELECT \n" +" ST_DelaunayTriangles(\n" +" ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40, \n" +" 50 60, 125 100, 175 150))'),\n" +" ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)\n" +" ),0.001,1) \n" +" As dtriag;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:695 +#, no-c-format +msgid "-- delaunay triangles of 45 points as 55 triangle polygons" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:698 +#, no-c-format +msgid "" +"-- this produces a table of 42 points that form an L shape\n" +"SELECT (ST_DumpPoints(ST_GeomFromText(\n" +"'MULTIPOINT(14 14,34 14,54 14,74 14,94 14,114 14,134 14,\n" +"150 14,154 14,154 6,134 6,114 6,94 6,74 6,54 6,34 6,\n" +"14 6,10 6,8 6,7 7,6 8,6 10,6 30,6 50,6 70,6 90,6 110,6 130,\n" +"6 150,6 170,6 190,6 194,14 194,14 174,14 154,14 134,14 114,\n" +"14 94,14 74,14 54,14 34,14 14)'))).geom \n" +" INTO TABLE l_shape;\n" +"-- output as individual polygon triangles\n" +"SELECT ST_AsText((ST_Dump(geom)).geom) As wkt\n" +"FROM ( SELECT ST_DelaunayTriangles(ST_Collect(geom)) As geom\n" +"FROM l_shape) As foo;\n" +"\n" +"---wkt ---\n" +"POLYGON((6 194,6 190,14 194,6 194))\n" +"POLYGON((14 194,6 190,14 174,14 194))\n" +"POLYGON((14 194,14 174,154 14,14 194))\n" +"POLYGON((154 14,14 174,14 154,154 14))\n" +"POLYGON((154 14,14 154,150 14,154 14))\n" +"POLYGON((154 14,150 14,154 6,154 14))\n" +":\n" +":" +msgstr "" + +#. Tag: title +#: reference_processing.xml:707 +#, no-c-format +msgid "3D Examples" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:708 +#, no-c-format +msgid "" +"-- 3D multipoint --\n" +"SELECT ST_AsText(ST_DelaunayTriangles(ST_GeomFromText(\n" +"'MULTIPOINT Z(14 14 10,\n" +"150 14 100,34 6 25, 20 10 150)'))) As wkt;\n" +"\n" +"-----wkt----\n" +"GEOMETRYCOLLECTION Z (POLYGON Z ((14 14 10,20 10 150,34 6 25,14 14 10))\n" +" ,POLYGON Z ((14 14 10,34 6 25,150 14 100,14 14 10)))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:712 reference_processing.xml:1323 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:719 +#, no-c-format +msgid "ST_Difference" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:721 +#, no-c-format +msgid "" +"Returns a geometry that represents that part of geometry A that does not " +"intersect with geometry B." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:727 +#, no-c-format +msgid "" +"geometry ST_Difference " +"geometry geomA " +"geometry geomB" +msgstr "" + +#. Tag: para +#: reference_processing.xml:738 +#, no-c-format +msgid "" +"Returns a geometry that represents that part of geometry A that does not " +"intersect with geometry B. One can think of this as GeometryA - " +"ST_Intersection(A,B). If A is completely contained in B then an empty " +"geometry collection is returned." +msgstr "" + +#. Tag: para +#: reference_processing.xml:741 +#, no-c-format +msgid "Note - order matters. B - A will always return a portion of B" +msgstr "" + +#. Tag: para +#: reference_processing.xml:745 reference_processing.xml:1928 +#, no-c-format +msgid "Do not call with a GeometryCollection as an argument" +msgstr "" + +#. Tag: para +#: reference_processing.xml:748 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.20" +msgstr "" + +#. Tag: para +#: reference_processing.xml:749 reference_processing.xml:1932 +#, no-c-format +msgid "" +"&Z_support; However it seems to only consider x y when doing the difference " +"and tacks back on the Z-Index" +msgstr "" + +#. Tag: para +#: reference_processing.xml:766 +#, no-c-format +msgid "The original linestrings shown together." +msgstr "" + +#. Tag: para +#: reference_processing.xml:778 +#, no-c-format +msgid "The difference of the two linestrings" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:787 +#, no-c-format +msgid "" +"--Safe for 2d. This is same geometries as what is shown for " +"st_symdifference\n" +"SELECT ST_AsText(\n" +" ST_Difference(\n" +" ST_GeomFromText('LINESTRING(50 100, 50 200)'),\n" +" ST_GeomFromText('LINESTRING(50 50, 50 150)')\n" +" )\n" +" );\n" +"\n" +"st_astext\n" +"---------\n" +"LINESTRING(50 150,50 200)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:789 +#, no-c-format +msgid "" +"--When used in 3d doesn't quite do the right thing\n" +"SELECT ST_AsEWKT(ST_Difference(ST_GeomFromEWKT('MULTIPOINT(-118.58 38.38 " +"5,-118.60 38.329 6,-118.614 38.281 7)'), ST_GeomFromEWKT('POINT(-118.614 " +"38.281 5)')));\n" +"st_asewkt\n" +"---------\n" +"MULTIPOINT(-118.6 38.329 6,-118.58 38.38 5)" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:802 +#, no-c-format +msgid "ST_Dump" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:803 +#, no-c-format +msgid "" +"Returns a set of geometry_dump (geom,path) rows, that make up a geometry g1." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:808 +#, no-c-format +msgid "" +"geometry_dump[] ST_Dump " +"geometry g1" +msgstr "" + +#. Tag: para +#: reference_processing.xml:817 +#, no-c-format +msgid "" +"This is a set-returning function (SRF). It returns a set of geometry_dump " +"rows, formed by a geometry (geom) and an array of integers (path). When the " +"input geometry is a simple type (POINT,LINESTRING,POLYGON) a single record " +"will be returned with an empty path array and the input geometry as geom. " +"When the input geometry is a collection or multi it will return a record for " +"each of the collection components, and the path will express the position of " +"the component inside the collection." +msgstr "" + +#. Tag: para +#: reference_processing.xml:826 +#, no-c-format +msgid "" +"ST_Dump is useful for expanding geometries. It is the reverse of a GROUP BY " +"in that it creates new rows. For example it can be use to expand " +"MULTIPOLYGONS into POLYGONS." +msgstr "" + +#. Tag: para +#: reference_processing.xml:830 reference_processing.xml:889 +#, no-c-format +msgid "" +"Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was " +"introduced." +msgstr "" + +#. Tag: para +#: reference_processing.xml:831 +#, no-c-format +msgid "Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher." +msgstr "" + +#. Tag: para +#: reference_processing.xml:833 +#, no-c-format +msgid "" +"Prior to 1.3.4, this function crashes if used with geometries that contain " +"CURVES. This is fixed in 1.3.4+" +msgstr "" + +#. Tag: para +#: reference_processing.xml:838 reference_processing.xml:892 +#: reference_processing.xml:995 reference_processing.xml:1566 +#: reference_processing.xml:1684 +#, no-c-format +msgid "&P_support;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:839 reference_processing.xml:893 +#: reference_processing.xml:996 reference_processing.xml:1685 +#, no-c-format +msgid "&T_support;" +msgstr "" + +#. Tag: title +#: reference_processing.xml:844 +#, no-c-format +msgid "Standard Examples" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:845 +#, no-c-format +msgid "" +"SELECT sometable.field1, sometable.field1,\n" +" (ST_Dump(sometable.the_geom)).geom AS the_geom\n" +"FROM sometable;\n" +"\n" +"-- Break a compound curve into its constituent linestrings and " +"circularstrings\n" +"SELECT ST_AsEWKT(a.geom), ST_HasArc(a.geom)\n" +" FROM ( SELECT (ST_Dump(p_geom)).geom AS geom\n" +" FROM (SELECT ST_GeomFromEWKT('COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 " +"1, 1 0),(1 0, 0 1))') AS p_geom) AS b\n" +" ) AS a;\n" +" st_asewkt | st_hasarc\n" +"-----------------------------+----------\n" +" CIRCULARSTRING(0 0,1 1,1 0) | t\n" +" LINESTRING(1 0,0 1) | f\n" +"(2 rows)" +msgstr "" + +#. Tag: title +#: reference_processing.xml:847 reference_processing.xml:914 +#, no-c-format +msgid "Polyhedral Surfaces, TIN and Triangle Examples" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:848 +#, no-c-format +msgid "" +"-- Polyhedral surface example\n" +"-- Break a Polyhedral surface into its faces\n" +"SELECT (a.p_geom).path[1] As path, ST_AsEWKT((a.p_geom).geom) As geom_ewkt\n" +" FROM (SELECT ST_Dump(ST_GeomFromEWKT('POLYHEDRALSURFACE( \n" +"((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), \n" +"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 " +"0)), ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 " +"1)) \n" +")') ) AS p_geom ) AS a;\n" +"\n" +" path | geom_ewkt\n" +"------+------------------------------------------\n" +" 1 | POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0))\n" +" 2 | POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))\n" +" 3 | POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))\n" +" 4 | POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0))\n" +" 5 | POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0))\n" +" 6 | POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:850 +#, no-c-format +msgid "" +"-- TIN -- \n" +"SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt\n" +" FROM\n" +" (SELECT \n" +" ST_Dump( ST_GeomFromEWKT('TIN (((\n" +" 0 0 0, \n" +" 0 0 1, \n" +" 0 1 0, \n" +" 0 0 0\n" +" )), ((\n" +" 0 0 0, \n" +" 0 1 0, \n" +" 1 1 0, \n" +" 0 0 0\n" +" ))\n" +" )') ) AS gdump\n" +" ) AS g;\n" +"-- result --\n" +" path | wkt\n" +"------+-------------------------------------\n" +" {1} | TRIANGLE((0 0 0,0 0 1,0 1 0,0 0 0))\n" +" {2} | TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:854 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:860 +#, no-c-format +msgid "ST_DumpPoints" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:861 +#, no-c-format +msgid "" +"Returns a set of geometry_dump (geom,path) rows of all points that make up a " +"geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:866 +#, no-c-format +msgid "" +"geometry_dump[]ST_DumpPoints " +"geometry geom" +msgstr "" + +#. Tag: para +#: reference_processing.xml:875 +#, no-c-format +msgid "" +"This set-returning function (SRF) returns a set of geometry_dump rows formed by a geometry (geom) and an array of " +"integers (path)." +msgstr "" + +#. Tag: para +#: reference_processing.xml:878 +#, no-c-format +msgid "" +"The geom component of geometry_dump are all the POINTs that make up the supplied " +"geometry" +msgstr "" + +#. Tag: para +#: reference_processing.xml:881 +#, no-c-format +msgid "" +"The path component of geometry_dump (an integer[]) is an index reference enumerating " +"the POINTs of the supplied geometry. For example, if a " +"LINESTRING is supplied, a path of {i} " +"is returned where i is the nth " +"coordinate in the LINESTRING. If a POLYGON is supplied, a path of {i,j} is returned where " +"i is the ring number (1 is outer; inner rings follow) and " +"j enumerates the POINTs (again 1-based " +"index)." +msgstr "" + +#. Tag: para +#: reference_processing.xml:890 +#, no-c-format +msgid "Availability: 1.5.0" +msgstr "" + +#. Tag: title +#: reference_processing.xml:897 +#, no-c-format +msgid "Classic Explode a Table of LineStrings into nodes" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:898 +#, no-c-format +msgid "" +"SELECT edge_id, (dp).path[1] As index, ST_AsText((dp).geom) As wktnode\n" +"FROM (SELECT 1 As edge_id\n" +" , ST_DumpPoints(ST_GeomFromText('LINESTRING(1 2, 3 4, 10 10)')) AS " +"dp\n" +" UNION ALL\n" +" SELECT 2 As edge_id\n" +" , ST_DumpPoints(ST_GeomFromText('LINESTRING(3 5, 5 6, 9 10)')) AS " +"dp\n" +" ) As foo;\n" +" edge_id | index | wktnode\n" +"---------+-------+--------------\n" +" 1 | 1 | POINT(1 2)\n" +" 1 | 2 | POINT(3 4)\n" +" 1 | 3 | POINT(10 10)\n" +" 2 | 1 | POINT(3 5)\n" +" 2 | 2 | POINT(5 6)\n" +" 2 | 3 | POINT(9 10)" +msgstr "" + +#. Tag: title +#: reference_processing.xml:901 +#, no-c-format +msgid "Standard Geometry Examples" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:911 +#, no-c-format +msgid "" +"SELECT path, ST_AsText(geom) \n" +"FROM (\n" +" SELECT (ST_DumpPoints(g.geom)).* \n" +" FROM\n" +" (SELECT \n" +" 'GEOMETRYCOLLECTION(\n" +" POINT ( 0 1 ), \n" +" LINESTRING ( 0 3, 3 4 ),\n" +" POLYGON (( 2 0, 2 3, 0 2, 2 0 )),\n" +" POLYGON (( 3 0, 3 3, 6 3, 6 0, 3 0 ), \n" +" ( 5 1, 4 2, 5 2, 5 1 )),\n" +" MULTIPOLYGON (\n" +" (( 0 5, 0 8, 4 8, 4 5, 0 5 ), \n" +" ( 1 6, 3 6, 2 7, 1 6 )), \n" +" (( 5 4, 5 8, 6 7, 5 4 ))\n" +" )\n" +" )'::geometry AS geom\n" +" ) AS g\n" +" ) j;\n" +" \n" +" path | st_astext \n" +"-----------+------------\n" +" {1,1} | POINT(0 1)\n" +" {2,1} | POINT(0 3)\n" +" {2,2} | POINT(3 4)\n" +" {3,1,1} | POINT(2 0)\n" +" {3,1,2} | POINT(2 3)\n" +" {3,1,3} | POINT(0 2)\n" +" {3,1,4} | POINT(2 0)\n" +" {4,1,1} | POINT(3 0)\n" +" {4,1,2} | POINT(3 3)\n" +" {4,1,3} | POINT(6 3)\n" +" {4,1,4} | POINT(6 0)\n" +" {4,1,5} | POINT(3 0)\n" +" {4,2,1} | POINT(5 1)\n" +" {4,2,2} | POINT(4 2)\n" +" {4,2,3} | POINT(5 2)\n" +" {4,2,4} | POINT(5 1)\n" +" {5,1,1,1} | POINT(0 5)\n" +" {5,1,1,2} | POINT(0 8)\n" +" {5,1,1,3} | POINT(4 8)\n" +" {5,1,1,4} | POINT(4 5)\n" +" {5,1,1,5} | POINT(0 5)\n" +" {5,1,2,1} | POINT(1 6)\n" +" {5,1,2,2} | POINT(3 6)\n" +" {5,1,2,3} | POINT(2 7)\n" +" {5,1,2,4} | POINT(1 6)\n" +" {5,2,1,1} | POINT(5 4)\n" +" {5,2,1,2} | POINT(5 8)\n" +" {5,2,1,3} | POINT(6 7)\n" +" {5,2,1,4} | POINT(5 4)\n" +"(29 rows)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:915 +#, no-c-format +msgid "" +"-- Polyhedral surface cube -- \n" +"SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt\n" +" FROM\n" +" (SELECT \n" +" ST_DumpPoints(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 " +"1, 0 1 0, 0 0 0)), \n" +"((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 " +"0)), \n" +"((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), \n" +"((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 " +"1)) )') ) AS gdump\n" +" ) AS g;\n" +"-- result --\n" +" path | wkt\n" +"---------+--------------\n" +" {1,1,1} | POINT(0 0 0)\n" +" {1,1,2} | POINT(0 0 1)\n" +" {1,1,3} | POINT(0 1 1)\n" +" {1,1,4} | POINT(0 1 0)\n" +" {1,1,5} | POINT(0 0 0)\n" +" {2,1,1} | POINT(0 0 0)\n" +" {2,1,2} | POINT(0 1 0)\n" +" {2,1,3} | POINT(1 1 0)\n" +" {2,1,4} | POINT(1 0 0)\n" +" {2,1,5} | POINT(0 0 0)\n" +" {3,1,1} | POINT(0 0 0)\n" +" {3,1,2} | POINT(1 0 0)\n" +" {3,1,3} | POINT(1 0 1)\n" +" {3,1,4} | POINT(0 0 1)\n" +" {3,1,5} | POINT(0 0 0)\n" +" {4,1,1} | POINT(1 1 0)\n" +" {4,1,2} | POINT(1 1 1)\n" +" {4,1,3} | POINT(1 0 1)\n" +" {4,1,4} | POINT(1 0 0)\n" +" {4,1,5} | POINT(1 1 0)\n" +" {5,1,1} | POINT(0 1 0)\n" +" {5,1,2} | POINT(0 1 1)\n" +" {5,1,3} | POINT(1 1 1)\n" +" {5,1,4} | POINT(1 1 0)\n" +" {5,1,5} | POINT(0 1 0)\n" +" {6,1,1} | POINT(0 0 1)\n" +" {6,1,2} | POINT(1 0 1)\n" +" {6,1,3} | POINT(1 1 1)\n" +" {6,1,4} | POINT(0 1 1)\n" +" {6,1,5} | POINT(0 0 1)\n" +"(30 rows)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:916 +#, no-c-format +msgid "" +"-- Triangle -- \n" +"SELECT (g.gdump).path, ST_AsText((g.gdump).geom) as wkt\n" +" FROM\n" +" (SELECT \n" +" ST_DumpPoints( ST_GeomFromEWKT('TRIANGLE ((\n" +" 0 0, \n" +" 0 9, \n" +" 9 0, \n" +" 0 0\n" +" ))') ) AS gdump\n" +" ) AS g;\n" +"-- result --\n" +" path | wkt\n" +"------+------------\n" +" {1} | POINT(0 0)\n" +" {2} | POINT(0 9)\n" +" {3} | POINT(9 0)\n" +" {4} | POINT(0 0)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:917 +#, no-c-format +msgid "" +"-- TIN -- \n" +"SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt\n" +" FROM\n" +" (SELECT \n" +" ST_DumpPoints( ST_GeomFromEWKT('TIN (((\n" +" 0 0 0, \n" +" 0 0 1, \n" +" 0 1 0, \n" +" 0 0 0\n" +" )), ((\n" +" 0 0 0, \n" +" 0 1 0, \n" +" 1 1 0, \n" +" 0 0 0\n" +" ))\n" +" )') ) AS gdump\n" +" ) AS g;\n" +"-- result --\n" +" path | wkt\n" +"---------+--------------\n" +" {1,1,1} | POINT(0 0 0)\n" +" {1,1,2} | POINT(0 0 1)\n" +" {1,1,3} | POINT(0 1 0)\n" +" {1,1,4} | POINT(0 0 0)\n" +" {2,1,1} | POINT(0 0 0)\n" +" {2,1,2} | POINT(0 1 0)\n" +" {2,1,3} | POINT(1 1 0)\n" +" {2,1,4} | POINT(0 0 0)\n" +"(8 rows)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:921 +#, no-c-format +msgid "" +", , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:926 +#, no-c-format +msgid "ST_DumpRings" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:928 +#, no-c-format +msgid "" +"Returns a set of geometry_dump rows, representing the " +"exterior and interior rings of a polygon." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:934 +#, no-c-format +msgid "" +"geometry_dump[] ST_DumpRings " +"geometry a_polygon" +msgstr "" + +#. Tag: para +#: reference_processing.xml:944 +#, no-c-format +msgid "" +"This is a set-returning function (SRF). It returns a set of " +"geometry_dump rows, defined as an integer[] and a geometry, aliased \"path\" and \"geom\" " +"respectively. The \"path\" field holds the polygon ring index containing a " +"single integer: 0 for the shell, >0 for holes. The \"geom\" field contains " +"the corresponding ring as a polygon." +msgstr "" + +#. Tag: para +#: reference_processing.xml:950 +#, no-c-format +msgid "Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher." +msgstr "" + +#. Tag: para +#: reference_processing.xml:951 +#, no-c-format +msgid "" +"This only works for POLYGON geometries. It will not work for MULTIPOLYGONS" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:959 +#, no-c-format +msgid "" +"SELECT sometable.field1, sometable.field1,\n" +" (ST_DumpRings(sometable.the_geom)).geom As the_geom\n" +"FROM sometableOfpolys;\n" +"\n" +"SELECT ST_AsEWKT(geom) As the_geom, path\n" +" FROM ST_DumpRings(\n" +" ST_GeomFromEWKT('POLYGON((-8149064 5133092 1,-8149064 " +"5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,-8148941 " +"5132466 1,-8148924 5132394 1,\n" +" -8148903 5132210 1,-8148930 5131967 1,-8148992 5131978 " +"1,-8149237 5132093 1,-8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 " +"1,\n" +" -8150305 5132788 1,-8149064 5133092 1),\n" +" (-8149362 5132394 1,-8149446 5132501 1,-8149548 5132597 " +"1,-8149695 5132675 1,-8149362 5132394 1))')\n" +" ) as foo;\n" +" path | the_geom\n" +"----------------------------------------------------------------------------------------------------------------\n" +" {0} | POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 " +"1,-8148972 5132767 1,-8148958 5132508 1,\n" +" | -8148941 5132466 1,-8148924 5132394 1,\n" +" | -8148903 5132210 1,-8148930 5131967 1,\n" +" | -8148992 5131978 1,-8149237 5132093 1,\n" +" | -8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 " +"1,-8150305 5132788 1,-8149064 5133092 1))\n" +" {1} | POLYGON((-8149362 5132394 1,-8149446 5132501 1,\n" +" | -8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 " +"1))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:966 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:972 +#, no-c-format +msgid "ST_FlipCoordinates" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:973 +#, no-c-format +msgid "" +"Returns a version of the given geometry with X and Y axis flipped. Useful " +"for people who have built latitude/longitude features and need to fix them." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:981 +#, no-c-format +msgid "" +"geometry ST_FlipCoordinates " +"geometry geom" +msgstr "" + +#. Tag: para +#: reference_processing.xml:990 +#, no-c-format +msgid "Returns a version of the given geometry with X and Y axis flipped." +msgstr "" + +#. Tag: para +#: reference_processing.xml:993 +#, no-c-format +msgid "&M_support;" +msgstr "" + +#. Tag: title +#: reference_processing.xml:1000 +#, no-c-format +msgid "Example" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1001 +#, no-c-format +msgid "" +"" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1008 +#, no-c-format +msgid "ST_Intersection" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1010 +#, no-c-format +msgid "" +"(T) Returns a geometry that represents the shared portion of geomA and " +"geomB. The geography implementation does a transform to geometry to do the " +"intersection and then transform back to WGS84." +msgstr "" + +#. Tag: funcsynopsis +#: reference_processing.xml:1015 +#, no-c-format +msgid "" +" geometry ST_Intersection geometry geomA geometry geomB geography " +"ST_Intersection geography geogA geography geogB " +msgstr "" + +#. Tag: para +#: reference_processing.xml:1042 +#, no-c-format +msgid "" +"Returns a geometry that represents the point set intersection of the " +"Geometries." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1045 +#, no-c-format +msgid "" +"In other words - that portion of geometry A and geometry B that is shared " +"between the two geometries." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1048 +#, no-c-format +msgid "" +"If the geometries do not share any space (are disjoint), then an empty " +"geometry collection is returned." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1050 +#, no-c-format +msgid "" +"ST_Intersection in conjunction with ST_Intersects is very useful for " +"clipping geometries such as in bounding box, buffer, region queries where " +"you only want to return that portion of a geometry that sits in a country or " +"region of interest." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1053 +#, no-c-format +msgid "" +"Geography: For geography this is really a thin wrapper around the geometry " +"implementation. It first determines the best SRID that fits the bounding box " +"of the 2 geography objects (if geography objects are within one half zone " +"UTM but not same UTM will pick one of those) (favoring UTM or Lambert " +"Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator " +"in worst case scenario) and then intersection in that best fit planar " +"spatial ref and retransforms back to WGS84 geography." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1056 +#, no-c-format +msgid "Do not call with a GEOMETRYCOLLECTION as an argument" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1061 +#, no-c-format +msgid "Availability: 1.5 support for geography data type was introduced." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1064 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.18" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1068 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, " +"0 2 )'::geometry));\n" +" st_astext\n" +"---------------\n" +"GEOMETRYCOLLECTION EMPTY\n" +"(1 row)\n" +"SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, " +"0 2 )'::geometry));\n" +" st_astext\n" +"---------------\n" +"POINT(0 0)\n" +"(1 row)\n" +"\n" +"---Clip all lines (trails) by country (here we assume country geom are " +"POLYGON or MULTIPOLYGONS)\n" +"-- NOTE: we are only keeping intersections that result in a LINESTRING or " +"MULTILINESTRING because we don't\n" +"-- care about trails that just share a point\n" +"-- the dump is needed to expand a geometry collection into individual single " +"MULT* parts\n" +"-- the below is fairly generic and will work for polys, etc. by just " +"changing the where clause\n" +"SELECT clipped.gid, clipped.f_name, clipped_geom\n" +"FROM (SELECT trails.gid, trails.f_name, (ST_Dump(ST_Intersection(country." +"the_geom, trails.the_geom))).geom As clipped_geom\n" +"FROM country\n" +" INNER JOIN trails\n" +" ON ST_Intersects(country.the_geom, trails.the_geom)) As clipped\n" +" WHERE ST_Dimension(clipped.clipped_geom) = 1 ;\n" +"\n" +"--For polys e.g. polygon landmarks, you can also use the sometimes faster " +"hack that buffering anything by 0.0\n" +"-- except a polygon results in an empty geometry collection\n" +"--(so a geometry collection containing polys, lines and points)\n" +"-- buffered by 0.0 would only leave the polygons and dissolve the collection " +"shell\n" +"SELECT poly.gid, ST_Multi(ST_Buffer(\n" +" ST_Intersection(country.the_geom, poly." +"the_geom),\n" +" 0.0)\n" +" ) As clipped_geom\n" +"FROM country\n" +" INNER JOIN poly\n" +" ON ST_Intersects(country.the_geom, poly.the_geom)\n" +" WHERE Not ST_IsEmpty(ST_Buffer(ST_Intersection(country.the_geom, " +"poly.the_geom),0.0));" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1072 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1078 +#, no-c-format +msgid "ST_LineToCurve" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1080 +#, no-c-format +msgid "Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVED POLYGON" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1085 +#, no-c-format +msgid "" +"geometry ST_LineToCurve " +"geometry geomANoncircular" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1095 +#, no-c-format +msgid "" +"Converts plain LINESTRING/POLYGONS to CIRCULAR STRINGs and Curved Polygons. " +"Note much fewer points are needed to describe the curved equivalent." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1106 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_LineToCurve(foo.the_geom)) As curvedastext,ST_AsText(foo." +"the_geom) As non_curvedastext\n" +" FROM (SELECT ST_Buffer('POINT(1 3)'::geometry, 3) As the_geom) As " +"foo;\n" +"\n" +"curvedatext " +"non_curvedastext\n" +"--------------------------------------------------------------------|-----------------------------------------------------------------\n" +"CURVEPOLYGON(CIRCULARSTRING(4 3,3.12132034355964 0.878679656440359, | " +"POLYGON((4 3,3.94235584120969 2.41472903395162,3.77163859753386 " +"1.85194970290473,\n" +"1 0,-1.12132034355965 5.12132034355963,4 3)) | " +"3.49440883690764 1.33328930094119,3.12132034355964 0.878679656440359,\n" +" | " +"2.66671069905881 0.505591163092366,2.14805029709527 0.228361402466141,\n" +" | " +"1.58527096604839 0.0576441587903094,1 0,\n" +" | " +"0.414729033951621 0.0576441587903077,-0.148050297095264 0.228361402466137,\n" +" | " +"-0.666710699058802 0.505591163092361,-1.12132034355964 0.878679656440353,\n" +" | " +"-1.49440883690763 1.33328930094119,-1.77163859753386 1.85194970290472\n" +" | --" +"ETC-- ,3.94235584120969 3.58527096604839,4 3))\n" +"--3D example\n" +"SELECT ST_AsEWKT(ST_LineToCurve(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 8, 5 " +"6 4, 7 8 4, 9 10 4)')));\n" +"\n" +" st_asewkt\n" +"------------------------------------\n" +" CIRCULARSTRING(1 2 3,5 6 4,9 10 4)" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1119 +#, no-c-format +msgid "ST_MakeValid" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1120 +#, no-c-format +msgid "Attempts to make an invalid geometry valid w/out loosing vertices." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1125 +#, no-c-format +msgid "" +"geometry ST_MakeValid " +"geometry input" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1134 +#, no-c-format +msgid "" +"The function attempts to create a valid representation of a given invalid " +"geometry without loosing any of the input vertices. Already-valid geometries " +"are returned w/out further intervention." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1140 +#, no-c-format +msgid "" +"Supported inputs are: POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, " +"POLYGONS, MULTIPOLYGONS and GEOMETRYCOLLECTIONS containing any mix of them." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1146 +#, no-c-format +msgid "" +"In case of full or partial dimensional collapses, the output geometry may be " +"a collection of lower-to-equal dimension geometries or a geometry of lower " +"dimension." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1152 +#, no-c-format +msgid "" +"Single polygons may become multi-geometries in case of self-intersections." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1156 +#, no-c-format +msgid "Availability: 2.0.0, requires GEOS-3.3.0" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1157 +#, no-c-format +msgid "Enahnced: 2.0.1, speed improvements requires GEOS-3.3.4" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1158 +#, no-c-format +msgid "Enhanced: 2.1.0 added support for GEOMETRYCOLLECTION and MULTIPOINT." +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1175 +#, no-c-format +msgid "ST_MemUnion" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1177 +#, no-c-format +msgid "" +"Same as ST_Union, only memory-friendly (uses less memory and more processor " +"time)." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1183 +#, no-c-format +msgid "" +"geometry ST_MemUnion " +"geometry set geomfield" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1194 +#, no-c-format +msgid "Some useful description here." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1198 +#, no-c-format +msgid "" +"Same as ST_Union, only memory-friendly (uses less memory and more processor " +"time). This aggregate function works by unioning the geometries one at a " +"time to previous result as opposed to ST_Union aggregate which first creates " +"an array and then unions" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1210 +#, no-c-format +msgid "See ST_Union" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1223 +#, no-c-format +msgid "ST_MinimumBoundingCircle" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1224 +#, no-c-format +msgid "" +"Returns the smallest circle polygon that can fully contain a geometry. " +"Default uses 48 segments per quarter circle." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1230 +#, no-c-format +msgid "" +"geometry ST_MinimumBoundingCircle " +"geometry geomA " +"integer " +"num_segs_per_qt_circ=48" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1240 +#, no-c-format +msgid "Returns the smallest circle polygon that can fully contain a geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1241 +#, no-c-format +msgid "" +"The circle is approximated by a polygon with a default of 48 segments per " +"quarter circle. This number can be increased with little performance penalty " +"to obtain a more accurate result." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1243 +#, no-c-format +msgid "" +"It is often used with MULTI and Geometry Collections. Although it is not an " +"aggregate - you can use it in conjunction with ST_Collect to get the minimum " +"bounding circle of a set of geometries. " +"ST_MinimumBoundingCircle(ST_Collect(somepointfield))." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1248 +#, no-c-format +msgid "" +"The ratio of the area of a polygon divided by the area of its Minimum " +"Bounding Circle is often referred to as the Roeck test." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1250 +#, no-c-format +msgid "Availability: 1.4.0 - requires GEOS" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1257 +#, no-c-format +msgid "" +"SELECT d.disease_type,\n" +" ST_MinimumBoundingCircle(ST_Collect(d.the_geom)) As the_geom\n" +" FROM disease_obs As d\n" +" GROUP BY d.disease_type;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1263 +#, no-c-format +msgid "" +"Minimum bounding circle of a point and linestring. Using 8 segs to " +"approximate a quarter circle" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1266 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_MinimumBoundingCircle(\n" +" ST_Collect(\n" +" ST_GeomFromEWKT('LINESTRING(55 75,125 150)'),\n" +" ST_Point(20, 80)), 8\n" +" )) As wktmbc;\n" +"wktmbc\n" +"-----------\n" +"POLYGON((135.59714732062 115,134.384753327498 " +"102.690357210921,130.79416296937 90.8537670908995,124.963360620072 " +"79.9451031602111,117.116420743937 70.3835792560632,107.554896839789 " +"62.5366393799277,96.6462329091006 56.70583703063,84.8096427890789 " +"53.115246672502,72.5000000000001 51.9028526793802,60.1903572109213 " +"53.1152466725019,48.3537670908996 56.7058370306299,37.4451031602112 " +"62.5366393799276,27.8835792560632 70.383579256063,20.0366393799278 " +"79.9451031602109,14.20583703063 90.8537670908993,10.615246672502 " +"102.690357210921,9.40285267938019 115,10.6152466725019 " +"127.309642789079,14.2058370306299 139.1462329091,20.0366393799275 " +"150.054896839789,27.883579256063 159.616420743937,\n" +"37.4451031602108 167.463360620072,48.3537670908992 " +"173.29416296937,60.190357210921 176.884753327498,\n" +"72.4999999999998 178.09714732062,84.8096427890786 " +"176.884753327498,96.6462329091003 173.29416296937,107.554896839789 " +"167.463360620072,\n" +"117.116420743937 159.616420743937,124.963360620072 " +"150.054896839789,130.79416296937 139.146232909101,134.384753327498 " +"127.309642789079,135.59714732062 115))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1270 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1276 +#, no-c-format +msgid "ST_Polygonize" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1278 +#, no-c-format +msgid "" +"Aggregate. Creates a GeometryCollection containing possible polygons formed " +"from the constituent linework of a set of geometries." +msgstr "" + +#. Tag: funcsynopsis +#: reference_processing.xml:1284 +#, no-c-format +msgid "" +" geometry ST_Polygonize geometry set geomfield geometry " +"ST_Polygonize geometry[] geom_array " +msgstr "" + +#. Tag: para +#: reference_processing.xml:1300 +#, no-c-format +msgid "" +"Creates a GeometryCollection containing possible polygons formed from the " +"constituent linework of a set of geometries." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1305 +#, no-c-format +msgid "" +"Geometry Collections are often difficult to deal with with third party " +"tools, so use ST_Polygonize in conjunction with " +"to dump the polygons out into individual polygons." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1313 +#, no-c-format +msgid "Availability: 1.0.0RC1 - requires GEOS >= 2.1.0." +msgstr "" + +#. Tag: title +#: reference_processing.xml:1317 +#, no-c-format +msgid "Examples: Polygonizing single linestrings" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1318 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(ST_Polygonize(the_geom_4269)) As geomtextrep\n" +"FROM (SELECT the_geom_4269 FROM ma.suffolk_edges ORDER BY tlid LIMIT 45) As " +"foo;\n" +"\n" +"geomtextrep\n" +"-------------------------------------\n" +" SRID=4269;GEOMETRYCOLLECTION(POLYGON((-71.040878 42.285678,-71.040943 " +"42.2856,-71.04096 42.285752,-71.040878 42.285678)),\n" +" POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 " +"42.354358,-71.171794 42.354971,-71.170511 42.354855,\n" +" -71.17112 42.354238,-71.17166 42.353675)))\n" +"(1 row)\n" +"\n" +"--Use ST_Dump to dump out the polygonize geoms into individual polygons\n" +"SELECT ST_AsEWKT((ST_Dump(foofoo.polycoll)).geom) As geomtextrep\n" +"FROM (SELECT ST_Polygonize(the_geom_4269) As polycoll\n" +" FROM (SELECT the_geom_4269 FROM ma.suffolk_edges\n" +" ORDER BY tlid LIMIT 45) As foo) As foofoo;\n" +"\n" +"geomtextrep\n" +"------------------------\n" +" SRID=4269;POLYGON((-71.040878 42.285678,-71.040943 42.2856,-71.04096 " +"42.285752,\n" +"-71.040878 42.285678))\n" +" SRID=4269;POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 " +"42.354358\n" +",-71.171794 42.354971,-71.170511 42.354855,-71.17112 42.354238,-71.17166 " +"42.353675))\n" +"(2 rows)" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1332 +#, no-c-format +msgid "ST_Node" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1334 +#, no-c-format +msgid "Node a set of linestrings." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1341 +#, no-c-format +msgid "" +"geometry ST_Node " +"geometry geom" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1352 +#, no-c-format +msgid "" +"Fully node a set of linestrings using the least possible number of nodes " +"while preserving all of the input ones." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1359 reference_processing.xml:2103 +#, no-c-format +msgid "Availability: 2.0.0 - requires GEOS >= 3.3.0." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1361 +#, no-c-format +msgid "" +"Due to a bug in GEOS up to 3.3.1 this function fails to node self-" +"intersecting lines. This is fixed with GEOS 3.3.2 or higher." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1368 +#, no-c-format +msgid "" +"SELECT ST_AsEWKT(\n" +" ST_Node('LINESTRINGZ(0 0 0, 10 10 10, 0 10 5, 10 0 3)'::" +"geometry)\n" +" ) As output;\n" +"output\n" +"-----------\n" +"MULTILINESTRING((0 0 0,5 5 4.5),(5 5 4.5,10 10 10,0 10 5,5 5 4.5),(5 5 " +"4.5,10 0 3))" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1383 +#, no-c-format +msgid "ST_OffsetCurve" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1385 +#, no-c-format +msgid "" +"Return an offset line at a given distance and side from an input line. " +"Useful for computing parallel lines about a center line" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1393 +#, no-c-format +msgid "" +"geometry ST_OffsetCurve " +"geometry line " +"float signed_distance text " +"style_parameters=''" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1406 +#, no-c-format +msgid "" +"Return an offset line at a given distance and side from an input line. All " +"points of the returned geometries are not further than the given distance " +"from the input geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1412 +#, no-c-format +msgid "" +"For positive distance the offset will be at the left side of the input line " +"and retain the same direction. For a negative distance it'll be at the right " +"side and in the opposite direction." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1418 +#, no-c-format +msgid "" +"Availability: 2.0 - requires GEOS >= 3.2, improved with GEOS >= 3.3" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1422 +#, no-c-format +msgid "" +"The optional third parameter allows specifying a list of blank-separated " +"key=value pairs to tweak operations as follows:" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1430 +#, no-c-format +msgid "" +"'join=round|mitre|bevel' : join style (defaults to \"round\"). 'miter' is " +"also accepted as a synonym for 'mitre'." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1433 +#, no-c-format +msgid "" +"'mitre_limit=#.#' : mitre ratio limit (only affects mitred join style). " +"'miter_limit' is also accepted as a synonym for 'mitre_limit'." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1438 +#, no-c-format +msgid "" +"Units of distance are measured in units of the spatial reference system." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1442 +#, no-c-format +msgid "The inputs can only be LINESTRINGS." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1446 +#, no-c-format +msgid "" +"This function ignores the third dimension (z) and will always give a 2-d " +"result even when presented with a 3d-geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1454 +#, no-c-format +msgid "Compute an open buffer around roads" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1455 +#, no-c-format +msgid "" +"SELECT ST_Union(\n" +" ST_OffsetCurve(f.the_geom, f.width/2, 'quad_segs=4 join=round'),\n" +" ST_OffsetCurve(f.the_geom, -f.width/2, 'quad_segs=4 join=round')\n" +") as track\n" +"FROM someroadstable;" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1465 +#, no-c-format +msgid "15, 'quad_segs=4 join=round' original line and its offset 15 units." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1469 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n" +"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n" +" 44 16,24 16,20 16,18 16,17 17,\n" +" 16 18,16 20,16 40,16 60,16 80,16 100,\n" +" 16 120,16 140,16 160,16 180,16 195)'),\n" +" 15, 'quad_segs=4 join=round'));\n" +"--output --\n" +"LINESTRING(164 1,18 1,12.2597485145237 2.1418070123307,\n" +" 7.39339828220179 5.39339828220179,\n" +" 5.39339828220179 7.39339828220179,\n" +" 2.14180701233067 12.2597485145237,1 18,1 195)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1476 +#, no-c-format +msgid "-15, 'quad_segs=4 join=round' original line and its offset -15 units" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1480 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_OffsetCurve(geom,\n" +" -15, 'quad_segs=4 join=round')) As notsocurvy\n" +" FROM ST_GeomFromText(\n" +"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n" +" 44 16,24 16,20 16,18 16,17 17,\n" +" 16 18,16 20,16 40,16 60,16 80,16 100,\n" +" 16 120,16 140,16 160,16 180,16 195)') As geom;\n" +"-- notsocurvy --\n" +"LINESTRING(31 195,31 31,164 31)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1489 +#, no-c-format +msgid "" +"double-offset to get more curvy, note the first reverses direction, so -30 + " +"15 = -15" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1492 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_OffsetCurve(ST_OffsetCurve(geom,\n" +" -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')) As " +"morecurvy\n" +" FROM ST_GeomFromText(\n" +"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n" +" 44 16,24 16,20 16,18 16,17 17,\n" +" 16 18,16 20,16 40,16 60,16 80,16 100,\n" +" 16 120,16 140,16 160,16 180,16 195)') As geom;\n" +"-- morecurvy --\n" +"LINESTRING(164 31,46 31,40.2597485145236 32.1418070123307,\n" +"35.3933982822018 35.3933982822018,\n" +"32.1418070123307 40.2597485145237,31 46,31 195)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1499 +#, no-c-format +msgid "" +"double-offset to get more curvy,combined with regular offset 15 to get " +"parallel lines. Overlaid with original." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1502 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Collect(\n" +" ST_OffsetCurve(geom, 15, 'quad_segs=4 join=round'), \n" +" ST_OffsetCurve(ST_OffsetCurve(geom,\n" +" -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')\n" +" )\n" +") As parallel_curves\n" +" FROM ST_GeomFromText(\n" +"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n" +" 44 16,24 16,20 16,18 16,17 17,\n" +" 16 18,16 20,16 40,16 60,16 80,16 100,\n" +" 16 120,16 140,16 160,16 180,16 195)') As geom;\n" +"-- parallel curves --\n" +"MULTILINESTRING((164 1,18 1,12.2597485145237 2.1418070123307,\n" +"7.39339828220179 5.39339828220179,5.39339828220179 7.39339828220179,\n" +"2.14180701233067 12.2597485145237,1 18,1 195),\n" +"(164 31,46 31,40.2597485145236 32.1418070123307,35.3933982822018 " +"35.3933982822018,\n" +"32.1418070123307 40.2597485145237,31 46,31 195))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1511 +#, no-c-format +msgid "15, 'quad_segs=4 join=bevel' shown with original line" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1514 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(\n" +"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n" +" 44 16,24 16,20 16,18 16,17 17,\n" +" 16 18,16 20,16 40,16 60,16 80,16 100,\n" +" 16 120,16 140,16 160,16 180,16 195)'), \n" +" 15, 'quad_segs=4 join=bevel'));\n" +"-- output --\n" +"LINESTRING(164 1,18 1,7.39339828220179 5.39339828220179,\n" +" 5.39339828220179 7.39339828220179,1 18,1 195)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1522 +#, no-c-format +msgid "15,-15 collected, join=mitre mitre_limit=2.1" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1525 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Collect(\n" +" ST_OffsetCurve(geom, 15, 'quad_segs=4 join=mitre mitre_limit=2.2'),\n" +" ST_OffsetCurve(geom, -15, 'quad_segs=4 join=mitre mitre_limit=2.2')\n" +" ) )\n" +" FROM ST_GeomFromText(\n" +"'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,\n" +" 44 16,24 16,20 16,18 16,17 17,\n" +" 16 18,16 20,16 40,16 60,16 80,16 100,\n" +" 16 120,16 140,16 160,16 180,16 195)') As geom;\n" +"-- output --\n" +"MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),\n" +" (31 195,31 31,164 31))" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1542 +#, no-c-format +msgid "ST_RemoveRepeatedPoints" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1543 +#, no-c-format +msgid "Returns a version of the given geometry with duplicated points removed." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1549 +#, no-c-format +msgid "" +"geometry ST_RemoveRepeatedPoints " +"geometry geom" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1558 +#, no-c-format +msgid "" +"Returns a version of the given geometry with duplicated points removed. Will " +"actually do something only with (multi)lines, (multi)polygons and " +"multipoints but you can safely call it with any kind of geometry. Since " +"simplification occurs on a object-by-object basis you can also feed a " +"GeometryCollection to this function." +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1578 +#, no-c-format +msgid "ST_SharedPaths" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1579 +#, no-c-format +msgid "" +"Returns a collection containing paths shared by the two input linestrings/" +"multilinestrings." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1584 +#, no-c-format +msgid "" +"geometry ST_SharedPaths " +"geometry lineal1 " +"geometry lineal2" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1594 +#, no-c-format +msgid "" +"Returns a collection containing paths shared by the two input geometries. " +"Those going in the same direction are in the first element of the " +"collection, those going in the opposite direction are in the second element. " +"The paths themselves are given in the direction of the first geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1599 +#, no-c-format +msgid "Availability: 2.0.0 requires GEOS >= 3.3.0." +msgstr "" + +#. Tag: title +#: reference_processing.xml:1602 +#, no-c-format +msgid "Examples: Finding shared paths" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1612 +#, no-c-format +msgid "A multilinestring and a linestring" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1623 +#, no-c-format +msgid "" +"The shared path of multilinestring and linestring overlaid with original " +"geometries." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1626 +#, no-c-format +msgid "" +"SELECT ST_AsText(\n" +" ST_SharedPaths(\n" +" ST_GeomFromText('MULTILINESTRING((26 125,26 200,126 200,126 125,26 " +"125),\n" +" (51 150,101 150,76 175,51 150))'),\n" +" ST_GeomFromText('LINESTRING(151 100,126 156.25,126 125,90 161, 76 " +"175)')\n" +" )\n" +" ) As wkt\n" +"\n" +" wkt\n" +"-------------------------------------------------------------\n" +"GEOMETRYCOLLECTION(MULTILINESTRING((126 156.25,126 125),\n" +" (101 150,90 161),(90 161,76 175)),MULTILINESTRING EMPTY)" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1632 +#, no-c-format +msgid "" +"-- same example but linestring orientation flipped\n" +"SELECT ST_AsText(\n" +" ST_SharedPaths(\n" +" ST_GeomFromText('LINESTRING(76 175,90 161,126 125,126 156.25,151 100)'),\n" +" ST_GeomFromText('MULTILINESTRING((26 125,26 200,126 200,126 125,26 125),\n" +" (51 150,101 150,76 175,51 150))')\n" +" )\n" +" ) As wkt\n" +"\n" +" wkt\n" +"-------------------------------------------------------------\n" +"GEOMETRYCOLLECTION(MULTILINESTRING EMPTY,\n" +"MULTILINESTRING((76 175,90 161),(90 161,101 150),(126 125,126 156.25)))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1642 +#, no-c-format +msgid "" +", , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1652 +#, no-c-format +msgid "ST_Shift_Longitude" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1654 +#, no-c-format +msgid "" +"Reads every point/vertex in every component of every feature in " +"a geometry, and if the longitude coordinate is <0, adds 360 to it. The " +"result would be a 0-360 version of the data to be plotted in a 180 centric " +"map" +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1662 +#, no-c-format +msgid "" +"geometry ST_Shift_Longitude " +"geometry geomA" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1672 +#, no-c-format +msgid "" +"Reads every point/vertex in every component of every feature in a " +"geometry, and if the longitude coordinate is <0, adds 360 to it. The " +"result would be a 0-360 version of the data to be plotted in a 180 centric " +"map" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1676 +#, no-c-format +msgid "This is only useful for data in long lat e.g. 4326 (WGS 84 long lat)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1678 +#, no-c-format +msgid "" +"Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with " +"MULTIPOINT as well." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1683 +#, no-c-format +msgid "Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1692 +#, no-c-format +msgid "" +"--3d points\n" +"SELECT ST_AsEWKT(ST_Shift_Longitude(ST_GeomFromEWKT('SRID=4326;POINT(-118.58 " +"38.38 10)'))) As geomA,\n" +" ST_AsEWKT(ST_Shift_Longitude(ST_GeomFromEWKT('SRID=4326;POINT(241.42 " +"38.38 10)'))) As geomb\n" +"geomA geomB\n" +"---------- -----------\n" +"SRID=4326;POINT(241.42 38.38 10) SRID=4326;POINT(-118.58 38.38 10)\n" +"\n" +"--regular line string\n" +"SELECT ST_AsText(ST_Shift_Longitude(ST_GeomFromText('LINESTRING(-118.58 " +"38.38, -118.20 38.45)')))\n" +"\n" +"st_astext\n" +"----------\n" +"LINESTRING(241.42 38.38,241.8 38.45)" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1698 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1704 +#, no-c-format +msgid "ST_Simplify" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1705 +#, no-c-format +msgid "" +"Returns a \"simplified\" version of the given geometry using the Douglas-" +"Peucker algorithm." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1711 +#, no-c-format +msgid "" +"geometry ST_Simplify " +"geometry geomA " +"float tolerance" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1721 +#, no-c-format +msgid "" +"Returns a \"simplified\" version of the given geometry using the Douglas-" +"Peucker algorithm. Will actually do something only with (multi)lines and " +"(multi)polygons but you can safely call it with any kind of geometry. Since " +"simplification occurs on a object-by-object basis you can also feed a " +"GeometryCollection to this function." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1728 +#, no-c-format +msgid "" +"Note that returned geometry might loose its simplicity (see )" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1730 +#, no-c-format +msgid "" +"Note topology may not be preserved and may result in invalid geometries. Use " +"(see ) to preserve topology." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1733 +#, no-c-format +msgid "Availability: 1.2.2" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1738 +#, no-c-format +msgid "A circle simplified too much becomes a triangle, medium an octagon," +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1739 +#, no-c-format +msgid "" +"SELECT ST_Npoints(the_geom) As np_before, " +"ST_NPoints(ST_Simplify(the_geom,0.1)) As np01_notbadcircle, " +"ST_NPoints(ST_Simplify(the_geom,0.5)) As np05_notquitecircle,\n" +"ST_NPoints(ST_Simplify(the_geom,1)) As np1_octagon, " +"ST_NPoints(ST_Simplify(the_geom,10)) As np10_triangle,\n" +"(ST_Simplify(the_geom,100) is null) As np100_geometrygoesaway\n" +"FROM (SELECT ST_Buffer('POINT(1 3)', 10,12) As the_geom) As foo;\n" +"-result\n" +" np_before | np01_notbadcircle | np05_notquitecircle | np1_octagon | " +"np10_triangle | np100_geometrygoesaway\n" +"-----------+-------------------+---------------------+-------------" +"+---------------+------------------------\n" +" 49 | 33 | 17 | 9 " +"| 4 | t" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1743 +#, no-c-format +msgid ", " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1749 +#, no-c-format +msgid "ST_SimplifyPreserveTopology" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1750 +#, no-c-format +msgid "" +"Returns a \"simplified\" version of the given geometry using the Douglas-" +"Peucker algorithm. Will avoid creating derived geometries (polygons in " +"particular) that are invalid." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1757 +#, no-c-format +msgid "" +"geometry ST_SimplifyPreserveTopology " +"geometry geomA " +"float tolerance" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1767 +#, no-c-format +msgid "" +"Returns a \"simplified\" version of the given geometry using the Douglas-" +"Peucker algorithm. Will avoid creating derived geometries (polygons in " +"particular) that are invalid. Will actually do something only with " +"(multi)lines and (multi)polygons but you can safely call it with any kind of " +"geometry. Since simplification occurs on a object-by-object basis you can " +"also feed a GeometryCollection to this function." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1776 +#, no-c-format +msgid "Requires GEOS 3.0.0+" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1777 +#, no-c-format +msgid "Availability: 1.3.3" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1782 +#, no-c-format +msgid "" +"Same example as Simplify, but we see Preserve Topology prevents " +"oversimplification. The circle can at most become a square." +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1783 +#, no-c-format +msgid "" +"SELECT ST_Npoints(the_geom) As np_before, " +"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,0.1)) As np01_notbadcircle, " +"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,0.5)) As " +"np05_notquitecircle,\n" +"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,1)) As np1_octagon, " +"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,10)) As np10_square,\n" +"ST_NPoints(ST_SimplifyPreserveTopology(the_geom,100)) As np100_stillsquare\n" +"FROM (SELECT ST_Buffer('POINT(1 3)', 10,12) As the_geom) As foo;\n" +"\n" +"--result--\n" +" np_before | np01_notbadcircle | np05_notquitecircle | np1_octagon | " +"np10_square | np100_stillsquare\n" +"-----------+-------------------+---------------------+-------------" +"+---------------+-------------------\n" +" 49 | 33 | 17 | 9 " +"| 5 | 5" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1793 +#, no-c-format +msgid "ST_Split" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1794 +#, no-c-format +msgid "Returns a collection of geometries resulting by splitting a geometry." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1799 +#, no-c-format +msgid "" +"geometry ST_Split " +"geometry input " +"geometry blade" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1809 +#, no-c-format +msgid "" +"The function supports splitting a line by point, a line by line, a polygon " +"by line. The returned geometry is always a collection." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1813 +#, no-c-format +msgid "" +"Think of this function as the opposite of ST_Union. Theoretically applying " +"ST_Union to the elements of the returned collection should always yield the " +"original geometry." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1824 +#, no-c-format +msgid "Polygon Cut by Line" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1836 reference_processing.xml:1870 +#, no-c-format +msgid "Before Split" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1848 reference_processing.xml:1882 +#, no-c-format +msgid "After split" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1857 +#, no-c-format +msgid "" +"-- this creates a geometry collection consisting of the 2 halves of the " +"polygon\n" +"-- this is similar to the example we demonstrated in ST_BuildArea\n" +"SELECT ST_Split(circle, line)\n" +"FROM (SELECT \n" +" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)) As line,\n" +" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;\n" +" \n" +"-- result --\n" +" GEOMETRYCOLLECTION(POLYGON((150 90,149.039264020162 " +"80.2454838991936,146.193976625564 70.8658283817455,..), POLYGON(..)))\n" +" \n" +"-- To convert to individual polygons, you can use ST_Dump or ST_GeometryN\n" +"SELECT ST_AsText((ST_Dump(ST_Split(circle, line))).geom) As wkt\n" +"FROM (SELECT \n" +" ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)) As line,\n" +" ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;\n" +" \n" +"-- result --\n" +"wkt\n" +"---------------\n" +"POLYGON((150 90,149.039264020162 80.2454838991936,..))\n" +"POLYGON((60.1371179574584 60.1371179574584,58.4265193848728 " +"62.2214883490198,53.8060233744357 ..))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1858 +#, no-c-format +msgid "Multilinestring Cut by point" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1891 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Split(mline, pt)) As wktcut\n" +" FROM (SELECT \n" +" ST_GeomFromText('MULTILINESTRING((10 10, 190 190), (15 15, 30 30, 100 " +"90))') As mline,\n" +" ST_Point(30,30) As pt) As foo;\n" +" \n" +"wktcut\n" +"------\n" +"GEOMETRYCOLLECTION(\n" +" LINESTRING(10 10,30 30),\n" +" LINESTRING(30 30,190 190),\n" +" LINESTRING(15 15,30 30),\n" +" LINESTRING(30 30,100 90)\n" +")" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1895 +#, no-c-format +msgid "" +", , , , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1901 +#, no-c-format +msgid "ST_SymDifference" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1903 +#, no-c-format +msgid "" +"Returns a geometry that represents the portions of A and B that do not " +"intersect. It is called a symmetric difference because ST_SymDifference(A,B) " +"= ST_SymDifference(B,A)." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:1910 +#, no-c-format +msgid "" +"geometry ST_SymDifference " +"geometry geomA " +"geometry geomB" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1921 +#, no-c-format +msgid "" +"Returns a geometry that represents the portions of A and B that do not " +"intersect. It is called a symmetric difference because ST_SymDifference(A,B) " +"= ST_SymDifference(B,A). One can think of this as ST_Union(geomA,geomB) - " +"ST_Intersection(A,B)." +msgstr "" + +#. Tag: para +#: reference_processing.xml:1931 +#, no-c-format +msgid "&sqlmm_compliant; SQL-MM 3: 5.1.21" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1951 +#, no-c-format +msgid "The original linestrings shown together" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1963 +#, no-c-format +msgid "The symmetric difference of the two linestrings" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1972 +#, no-c-format +msgid "" +"--Safe for 2d - symmetric difference of 2 linestrings\n" +"SELECT ST_AsText(\n" +" ST_SymDifference(\n" +" ST_GeomFromText('LINESTRING(50 100, 50 200)'),\n" +" ST_GeomFromText('LINESTRING(50 50, 50 150)')\n" +" )\n" +");\n" +"\n" +"st_astext\n" +"---------\n" +"MULTILINESTRING((50 150,50 200),(50 50,50 100))" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:1974 +#, no-c-format +msgid "" +"--When used in 3d doesn't quite do the right thing\n" +"SELECT ST_AsEWKT(ST_SymDifference(ST_GeomFromEWKT('LINESTRING(1 2 1, 1 4 " +"2)'),\n" +" ST_GeomFromEWKT('LINESTRING(1 1 3, 1 3 4)')))\n" +"\n" +"st_astext\n" +"------------\n" +"MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))" +msgstr "" + +#. Tag: para +#: reference_processing.xml:1981 +#, no-c-format +msgid ", , " +msgstr "" + +#. Tag: refname +#: reference_processing.xml:1988 +#, no-c-format +msgid "ST_Union" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:1989 +#, no-c-format +msgid "" +"Returns a geometry that represents the point set union of the Geometries." +msgstr "" + +#. Tag: funcsynopsis +#: reference_processing.xml:1994 +#, no-c-format +msgid "" +" geometry ST_Union " +"geometry set g1field geometry " +"ST_Union geometry " +"g1 geometry " +"g2 " +"geometry ST_Union " +"geometry[] g1_array " +"" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2013 +#, no-c-format +msgid "" +"Output type can be a MULTI*, single geometry, or Geometry Collection. Comes " +"in 2 variants. Variant 1 unions 2 geometries resulting in a new geometry " +"with no intersecting regions. Variant 2 is an aggregate function that takes " +"a set of geometries and unions them into a single ST_Geometry resulting in " +"no intersecting regions." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2017 +#, no-c-format +msgid "" +"Aggregate version: This function returns a MULTI geometry or NON-MULTI " +"geometry from a set of geometries. The ST_Union() function is an \"aggregate" +"\" function in the terminology of PostgreSQL. That means that it operates on " +"rows of data, in the same way the SUM() and AVG() functions do." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2023 +#, no-c-format +msgid "" +"Non-Aggregate version: This function returns a geometry being a union of two " +"input geometries. Output type can be a MULTI*, NON-MULTI or " +"GEOMETRYCOLLECTION." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2027 +#, no-c-format +msgid "" +"ST_Collect and ST_Union are often interchangeable. ST_Union is in general " +"orders of magnitude slower than ST_Collect because it tries to dissolve " +"boundaries and reorder geometries to ensure that a constructed Multi* " +"doesn't have intersecting regions." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2033 +#, no-c-format +msgid "" +"NOTE: this function was formerly called GeomUnion(), which was renamed from " +"\"Union\" because UNION is an SQL reserved word." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2036 +#, no-c-format +msgid "" +"Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was " +"introduced and also faster aggregate collection in PostgreSQL. If you are " +"using GEOS 3.1.0+ ST_Union will use the faster Cascaded Union algorithm " +"described in http://blog.cleverelephant.ca/2009/01/must-" +"faster-unions-in-postgis-14.html" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2042 +#, no-c-format +msgid "Aggregate version is not explicitly defined in OGC SPEC." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2043 +#, no-c-format +msgid "" +"&sqlmm_compliant; SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are " +"involved." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2049 +#, no-c-format +msgid "Aggregate example" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2050 +#, no-c-format +msgid "" +"SELECT stusps,\n" +" ST_Multi(ST_Union(f.the_geom)) as singlegeom\n" +" FROM sometable As f\n" +"GROUP BY stusps" +msgstr "" + +#. Tag: programlisting +#: reference_processing.xml:2052 +#, no-c-format +msgid "" +"SELECT ST_AsText(ST_Union(ST_GeomFromText('POINT(1 2)'),\n" +" ST_GeomFromText('POINT(-2 3)') ) )\n" +"\n" +"st_astext\n" +"----------\n" +"MULTIPOINT(-2 3,1 2)\n" +"\n" +"\n" +"SELECT ST_AsText(ST_Union(ST_GeomFromText('POINT(1 2)'),\n" +" ST_GeomFromText('POINT(1 2)') ) );\n" +"st_astext\n" +"----------\n" +"POINT(1 2)\n" +"\n" +"--3d example - sort of supports 3d (and with mixed dimensions!)\n" +"SELECT ST_AsEWKT(st_union(the_geom))\n" +"FROM\n" +"(SELECT ST_GeomFromEWKT('POLYGON((-7 4.2,-7.1 4.2,-7.1 4.3,\n" +"-7 4.2))') as the_geom\n" +"UNION ALL\n" +"SELECT ST_GeomFromEWKT('POINT(5 5 5)') as the_geom\n" +"UNION ALL\n" +" SELECT ST_GeomFromEWKT('POINT(-2 3 1)') as the_geom\n" +"UNION ALL\n" +"SELECT ST_GeomFromEWKT('LINESTRING(5 5 5, 10 10 10)') as the_geom ) as foo;\n" +"\n" +"st_asewkt\n" +"---------\n" +"GEOMETRYCOLLECTION(POINT(-2 3 1),LINESTRING(5 5 5,10 10 10),POLYGON((-7 4.2 " +"5,-7.1 4.2 5,-7.1 4.3 5,-7 4.2 5)));\n" +"\n" +"--3d example not mixing dimensions\n" +"SELECT ST_AsEWKT(st_union(the_geom))\n" +"FROM\n" +"(SELECT ST_GeomFromEWKT('POLYGON((-7 4.2 2,-7.1 4.2 3,-7.1 4.3 2,\n" +"-7 4.2 2))') as the_geom\n" +"UNION ALL\n" +"SELECT ST_GeomFromEWKT('POINT(5 5 5)') as the_geom\n" +"UNION ALL\n" +" SELECT ST_GeomFromEWKT('POINT(-2 3 1)') as the_geom\n" +"UNION ALL\n" +"SELECT ST_GeomFromEWKT('LINESTRING(5 5 5, 10 10 10)') as the_geom ) as foo;\n" +"\n" +"st_asewkt\n" +"---------\n" +"GEOMETRYCOLLECTION(POINT(-2 3 1),LINESTRING(5 5 5,10 10 10),POLYGON((-7 4.2 " +"2,-7.1 4.2 3,-7.1 4.3 2,-7 4.2 2)))\n" +"\n" +"--Examples using new Array construct\n" +"SELECT ST_Union(ARRAY(SELECT the_geom FROM sometable));\n" +"\n" +"SELECT ST_AsText(ST_Union(ARRAY[ST_GeomFromText('LINESTRING(1 2, 3 4)'),\n" +" ST_GeomFromText('LINESTRING(3 4, 4 5)')])) As " +"wktunion;\n" +"\n" +"--wktunion---\n" +"MULTILINESTRING((3 4,4 5),(1 2,3 4))" +msgstr "" + +#. Tag: refname +#: reference_processing.xml:2065 +#, no-c-format +msgid "ST_UnaryUnion" +msgstr "" + +#. Tag: refpurpose +#: reference_processing.xml:2067 +#, no-c-format +msgid "Like ST_Union, but working at the geometry component level." +msgstr "" + +#. Tag: funcprototype +#: reference_processing.xml:2072 +#, no-c-format +msgid "" +"geometry ST_UnaryUnion " +"geometry geom" +msgstr "" + +#. Tag: para +#: reference_processing.xml:2083 +#, no-c-format +msgid "" +"Unlike ST_Union, ST_UnaryUnion does dissolve boundaries between components " +"of a multipolygon (invalid) and does perform union between the components of " +"a geometrycollection. Each components of the input geometry is assumed to be " +"valid, so you won't get a valid multipolygon out of a bow-tie polygon " +"(invalid)." +msgstr "" + +#. Tag: para +#: reference_processing.xml:2093 +#, no-c-format +msgid "" +"You may use this function to node a set of linestrings. You may mix " +"ST_UnaryUnion with ST_Collect to fine-tune how many geometries at once you " +"want to dissolve to be nice on both memory size and CPU time, finding the " +"balance between ST_Union and ST_MemUnion." +msgstr "" diff --git a/doc/po/pl/reference_raster.xml.po b/doc/po/pl/reference_raster.xml.po new file mode 100644 index 000000000..83963f76b --- /dev/null +++ b/doc/po/pl/reference_raster.xml.po @@ -0,0 +1,13139 @@ +# SOME DESCRIPTIVE TITLE. +# +# Translators: +msgid "" +msgstr "" +"Project-Id-Version: PostGIS\n" +"Report-Msgid-Bugs-To: http://bugs.kde.org\n" +"POT-Creation-Date: 2012-10-11 21:39+0000\n" +"PO-Revision-Date: 2013-11-27 16:31+0000\n" +"Last-Translator: Sandro Santilli \n" +"Language-Team: Polish (http://www.transifex.com/projects/p/postgis-1/" +"language/pl/)\n" +"Language: pl\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 " +"|| n%100>=20) ? 1 : 2);\n" + +#. Tag: title +#: reference_raster.xml:3 +#, no-c-format +msgid "Raster Reference" +msgstr "" + +#. Tag: para +#: reference_raster.xml:5 +#, no-c-format +msgid "" +"The functions given below are the ones which a user of PostGIS Raster is " +"likely to need and which are currently available in PostGIS Raster. There " +"are other functions which are required support functions to the raster " +"objects which are not of use to a general user." +msgstr "" + +#. Tag: para +#: reference_raster.xml:9 +#, no-c-format +msgid "" +"raster is a new PostGIS type for storing and analyzing " +"raster data." +msgstr "" + +#. Tag: para +#: reference_raster.xml:10 +#, no-c-format +msgid "" +"For loading rasters from raster files please refer to " +msgstr "" + +#. Tag: para +#: reference_raster.xml:12 +#, no-c-format +msgid "" +"For the examples in this reference we will be using a raster table of dummy " +"rasters - Formed with the following code" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:13 +#, no-c-format +msgid "" +"CREATE TABLE dummy_rast(rid integer, rast raster);\n" +"INSERT INTO dummy_rast(rid, rast)\n" +"VALUES (1,\n" +"('01' -- little endian (uint8 ndr)\n" +"|| \n" +"'0000' -- version (uint16 0)\n" +"||\n" +"'0000' -- nBands (uint16 0)\n" +"||\n" +"'0000000000000040' -- scaleX (float64 2)\n" +"||\n" +"'0000000000000840' -- scaleY (float64 3)\n" +"||\n" +"'000000000000E03F' -- ipX (float64 0.5)\n" +"||\n" +"'000000000000E03F' -- ipY (float64 0.5)\n" +"||\n" +"'0000000000000000' -- skewX (float64 0)\n" +"||\n" +"'0000000000000000' -- skewY (float64 0)\n" +"||\n" +"'00000000' -- SRID (int32 0)\n" +"||\n" +"'0A00' -- width (uint16 10)\n" +"||\n" +"'1400' -- height (uint16 20)\n" +")::raster\n" +"),\n" +"-- Raster: 5 x 5 pixels, 3 bands, PT_8BUI pixel type, NODATA = 0\n" +"(2, ('01000003009A9999999999A93F9A9999999999A9BF000000E02B274A' ||\n" +"'41000000007719564100000000000000000000000000000000FFFFFFFF050005000400FDFEFDFEFEFDFEFEFDF9FAFEF' " +"||\n" +"'EFCF9FBFDFEFEFDFCFAFEFEFE04004E627AADD16076B4F9FE6370A9F5FE59637AB0E54F58617087040046566487A1506CA2E3FA5A6CAFFBFE4D566DA4CB3E454C5665')::" +"raster);" +msgstr "" + +#. Tag: para +#: reference_raster.xml:17 +#, no-c-format +msgid "" +"This section lists the PostgreSQL data types specifically created to support " +"raster functionality." +msgstr "" + +#. Tag: title +#: reference_raster.xml:20 +#, no-c-format +msgid "Raster Support Data types" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:24 +#, no-c-format +msgid "geomval" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:25 +#, no-c-format +msgid "" +"A spatial datatype with two fields - geom (holding a geometry object) and " +"val (holding a double precision pixel value from a raster band)." +msgstr "" + +#. Tag: title +#: reference_raster.xml:30 reference_raster.xml:49 reference_raster.xml:121 +#: reference_raster.xml:171 reference_raster.xml:211 reference_raster.xml:257 +#: reference_raster.xml:439 reference_raster.xml:613 reference_raster.xml:652 +#: reference_raster.xml:689 reference_raster.xml:730 reference_raster.xml:820 +#: reference_raster.xml:1022 reference_raster.xml:1109 +#: reference_raster.xml:1203 reference_raster.xml:1248 +#: reference_raster.xml:1287 reference_raster.xml:1321 +#: reference_raster.xml:1356 reference_raster.xml:1390 +#: reference_raster.xml:1435 reference_raster.xml:1489 +#: reference_raster.xml:1526 reference_raster.xml:1566 +#: reference_raster.xml:1621 reference_raster.xml:1673 +#: reference_raster.xml:1717 reference_raster.xml:1752 +#: reference_raster.xml:1788 reference_raster.xml:1824 +#: reference_raster.xml:1859 reference_raster.xml:1893 +#: reference_raster.xml:1927 reference_raster.xml:1971 +#: reference_raster.xml:2033 reference_raster.xml:2087 +#: reference_raster.xml:2122 reference_raster.xml:2162 +#: reference_raster.xml:2209 reference_raster.xml:2251 +#: reference_raster.xml:2305 reference_raster.xml:2340 +#: reference_raster.xml:2415 reference_raster.xml:2458 +#: reference_raster.xml:2504 reference_raster.xml:2556 +#: reference_raster.xml:2599 reference_raster.xml:2644 +#: reference_raster.xml:2687 reference_raster.xml:2753 +#: reference_raster.xml:2829 reference_raster.xml:2916 +#: reference_raster.xml:3004 reference_raster.xml:3081 +#: reference_raster.xml:3215 reference_raster.xml:3254 +#: reference_raster.xml:3293 reference_raster.xml:3336 +#: reference_raster.xml:3383 reference_raster.xml:3427 +#: reference_raster.xml:3465 reference_raster.xml:3540 +#: reference_raster.xml:3595 reference_raster.xml:3657 +#: reference_raster.xml:3735 reference_raster.xml:3800 +#: reference_raster.xml:3887 reference_raster.xml:3926 +#: reference_raster.xml:3996 reference_raster.xml:4102 +#: reference_raster.xml:4222 reference_raster.xml:4283 +#: reference_raster.xml:4438 reference_raster.xml:4480 +#: reference_raster.xml:4517 reference_raster.xml:4602 +#: reference_raster.xml:4693 reference_raster.xml:4781 +#: reference_raster.xml:4842 reference_raster.xml:4900 +#: reference_raster.xml:5031 reference_raster.xml:5093 +#: reference_raster.xml:5138 reference_raster.xml:5183 +#: reference_raster.xml:5222 reference_raster.xml:5287 +#: reference_raster.xml:5401 reference_raster.xml:5513 +#: reference_raster.xml:5651 reference_raster.xml:5747 +#: reference_raster.xml:5984 reference_raster.xml:6080 +#: reference_raster.xml:6172 reference_raster.xml:6284 +#: reference_raster.xml:6334 reference_raster.xml:6419 +#: reference_raster.xml:6480 reference_raster.xml:6530 +#: reference_raster.xml:6580 reference_raster.xml:6630 +#: reference_raster.xml:6679 reference_raster.xml:6729 +#: reference_raster.xml:6779 reference_raster.xml:6829 +#: reference_raster.xml:6893 reference_raster.xml:6956 +#: reference_raster.xml:7000 reference_raster.xml:7045 +#: reference_raster.xml:7112 reference_raster.xml:7201 +#: reference_raster.xml:7286 reference_raster.xml:7367 +#: reference_raster.xml:7448 reference_raster.xml:7577 +#: reference_raster.xml:7661 reference_raster.xml:7741 +#: reference_raster.xml:7860 reference_raster.xml:7932 +#: reference_raster.xml:8029 reference_raster.xml:8122 +#, no-c-format +msgid "Description" +msgstr "" + +#. Tag: para +#: reference_raster.xml:31 +#, no-c-format +msgid "" +"geomval is a compound data type consisting of a geometry object referenced " +"by the .geom field and val, a double precision value that represents the " +"pixel value at a particular geometric location in a raster band. It is used " +"by the ST_DumpAsPolygon and Raster intersection family of functions as an " +"output type to explode a raster band into geometry polygons." +msgstr "" + +#. Tag: title +#: reference_raster.xml:37 reference_raster.xml:107 reference_raster.xml:157 +#: reference_raster.xml:200 reference_raster.xml:245 reference_raster.xml:292 +#: reference_raster.xml:487 reference_raster.xml:628 reference_raster.xml:664 +#: reference_raster.xml:702 reference_raster.xml:750 reference_raster.xml:857 +#: reference_raster.xml:1074 reference_raster.xml:1163 +#: reference_raster.xml:1223 reference_raster.xml:1266 +#: reference_raster.xml:1300 reference_raster.xml:1335 +#: reference_raster.xml:1369 reference_raster.xml:1413 +#: reference_raster.xml:1468 reference_raster.xml:1505 +#: reference_raster.xml:1543 reference_raster.xml:1588 +#: reference_raster.xml:1644 reference_raster.xml:1696 +#: reference_raster.xml:1731 reference_raster.xml:1767 +#: reference_raster.xml:1803 reference_raster.xml:1838 +#: reference_raster.xml:1872 reference_raster.xml:1906 +#: reference_raster.xml:1941 reference_raster.xml:1991 +#: reference_raster.xml:2047 reference_raster.xml:2101 +#: reference_raster.xml:2137 reference_raster.xml:2187 +#: reference_raster.xml:2222 reference_raster.xml:2280 +#: reference_raster.xml:2318 reference_raster.xml:2393 +#: reference_raster.xml:2430 reference_raster.xml:2472 +#: reference_raster.xml:2524 reference_raster.xml:2567 +#: reference_raster.xml:2612 reference_raster.xml:2655 +#: reference_raster.xml:2700 reference_raster.xml:2775 +#: reference_raster.xml:2854 reference_raster.xml:2948 +#: reference_raster.xml:3019 reference_raster.xml:3138 +#: reference_raster.xml:3271 reference_raster.xml:3306 +#: reference_raster.xml:3355 reference_raster.xml:3400 +#: reference_raster.xml:3440 reference_raster.xml:3478 +#: reference_raster.xml:3560 reference_raster.xml:3622 +#: reference_raster.xml:3685 reference_raster.xml:3764 +#: reference_raster.xml:3852 reference_raster.xml:3900 +#: reference_raster.xml:3949 reference_raster.xml:4010 +#: reference_raster.xml:4137 reference_raster.xml:4237 +#: reference_raster.xml:4311 reference_raster.xml:4456 +#: reference_raster.xml:4556 reference_raster.xml:4647 +#: reference_raster.xml:4738 reference_raster.xml:4818 +#: reference_raster.xml:4860 reference_raster.xml:5008 +#: reference_raster.xml:5070 reference_raster.xml:5117 +#: reference_raster.xml:5157 reference_raster.xml:5198 +#: reference_raster.xml:5263 reference_raster.xml:5328 +#: reference_raster.xml:5440 reference_raster.xml:5612 +#: reference_raster.xml:5705 reference_raster.xml:5910 +#: reference_raster.xml:6042 reference_raster.xml:6142 +#: reference_raster.xml:6260 reference_raster.xml:6295 +#: reference_raster.xml:6369 reference_raster.xml:6449 +#: reference_raster.xml:6499 reference_raster.xml:6549 +#: reference_raster.xml:6599 reference_raster.xml:6649 +#: reference_raster.xml:6698 reference_raster.xml:6748 +#: reference_raster.xml:6798 reference_raster.xml:6867 +#: reference_raster.xml:6916 reference_raster.xml:7147 +#: reference_raster.xml:7232 reference_raster.xml:7313 +#: reference_raster.xml:7394 reference_raster.xml:7478 +#: reference_raster.xml:7607 reference_raster.xml:7688 +#: reference_raster.xml:7768 reference_raster.xml:7881 +#: reference_raster.xml:7965 reference_raster.xml:8060 +#: reference_raster.xml:8153 +#, no-c-format +msgid "See Also" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:44 +#, no-c-format +msgid "addbandarg" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:45 +#, no-c-format +msgid "" +"A composite type used as input into the ST_AddBand function " +"defining the attributes and initial value of the new band." +msgstr "" + +#. Tag: para +#: reference_raster.xml:50 +#, no-c-format +msgid "" +"A composite type used as input into the ST_AddBand function defining " +"the attributes and initial value of the new band." +msgstr "" + +#. Tag: term +#: reference_raster.xml:55 +#, no-c-format +msgid "index integer" +msgstr "" + +#. Tag: para +#: reference_raster.xml:60 +#, no-c-format +msgid "" +"1-based value indicating the position where the new band will be added " +"amongst the raster's bands. If NULL, the new band will be added at the end " +"of the raster's bands." +msgstr "" + +#. Tag: term +#: reference_raster.xml:67 +#, no-c-format +msgid "pixeltype text" +msgstr "" + +#. Tag: para +#: reference_raster.xml:72 +#, no-c-format +msgid "" +"Pixel type of the new band. One of defined pixel types as described in ." +msgstr "" + +#. Tag: term +#: reference_raster.xml:79 +#, no-c-format +msgid "initialvalue double precision" +msgstr "" + +#. Tag: para +#: reference_raster.xml:84 +#, no-c-format +msgid "Initial value that all pixels of new band will be set to." +msgstr "" + +#. Tag: term +#: reference_raster.xml:91 +#, no-c-format +msgid "nodataval double precision" +msgstr "" + +#. Tag: para +#: reference_raster.xml:96 +#, no-c-format +msgid "" +"NODATA value of the new band. If NULL, the new band will not have a NODATA " +"value assigned." +msgstr "" + +#. Tag: refname +#: reference_raster.xml:116 +#, no-c-format +msgid "rastbandarg" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:117 +#, no-c-format +msgid "" +"A composite type for use when needing to express a raster and a " +"band index of that raster." +msgstr "" + +#. Tag: para +#: reference_raster.xml:122 +#, no-c-format +msgid "" +"A composite type for use when needing to express a raster and a band " +"index of that raster." +msgstr "" + +#. Tag: term +#: reference_raster.xml:128 +#, no-c-format +msgid "rast raster" +msgstr "" + +#. Tag: para +#: reference_raster.xml:133 +#, no-c-format +msgid "The raster in question/" +msgstr "" + +#. Tag: term +#: reference_raster.xml:140 reference_raster.xml:263 +#, no-c-format +msgid "nband integer" +msgstr "" + +#. Tag: para +#: reference_raster.xml:145 +#, no-c-format +msgid "1-based value indicating the band of raster" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:166 +#, no-c-format +msgid "raster" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:167 +#, no-c-format +msgid "raster spatial data type." +msgstr "" + +#. Tag: para +#: reference_raster.xml:172 +#, no-c-format +msgid "" +"raster is a spatial data type used to represent raster data such as those " +"imported from jpegs, tiffs, pngs, digital elevation models. Each raster has " +"1 or more bands each having a set of pixel values. Rasters can be " +"georeferenced." +msgstr "" + +#. Tag: para +#: reference_raster.xml:175 +#, no-c-format +msgid "" +"Requires PostGIS be compiled with GDAL support. Currently rasters can be " +"implicitly converted to geometry type, but the conversion returns the of the raster. This auto casting may be " +"removed in the near future so don't rely on it." +msgstr "" + +#. Tag: title +#: reference_raster.xml:181 +#, no-c-format +msgid "Casting Behavior" +msgstr "" + +#. Tag: para +#: reference_raster.xml:182 +#, no-c-format +msgid "" +"This section lists the automatic as well as explicit casts allowed for this " +"data type" +msgstr "" + +#. Tag: entry +#: reference_raster.xml:187 +#, no-c-format +msgid "Cast To" +msgstr "" + +#. Tag: entry +#: reference_raster.xml:188 +#, no-c-format +msgid "Behavior" +msgstr "" + +#. Tag: entry +#: reference_raster.xml:191 +#, no-c-format +msgid "geometry" +msgstr "" + +#. Tag: entry +#: reference_raster.xml:192 +#, no-c-format +msgid "automatic" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:207 +#, no-c-format +msgid "reclassarg" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:208 +#, no-c-format +msgid "" +"A composite type used as input into the ST_Reclass function " +"defining the behavior of reclassification." +msgstr "" + +#. Tag: para +#: reference_raster.xml:212 +#, no-c-format +msgid "" +"A composite type used as input into the ST_Reclass function defining " +"the behavior of reclassification." +msgstr "" + +#. Tag: term +#: reference_raster.xml:215 +#, no-c-format +msgid "nband integer" +msgstr "" + +#. Tag: para +#: reference_raster.xml:216 +#, no-c-format +msgid "The band number of band to reclassify." +msgstr "" + +#. Tag: term +#: reference_raster.xml:219 +#, no-c-format +msgid "reclassexpr text" +msgstr "" + +#. Tag: para +#: reference_raster.xml:220 +#, no-c-format +msgid "" +"range expression consisting of comma delimited range:map_range mappings. : " +"to define mapping that defines how to map old band values to new band " +"values. ( means >, ) means less than, ] < or equal, [ means > or " +"equal" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:221 +#, no-c-format +msgid "" +"1. [a-b] = a <= x <= b\n" +"\n" +"2. (a-b] = a < x <= b\n" +"\n" +"3. [a-b) = a <= x < b\n" +"\n" +"4. (a-b) = a < x < b" +msgstr "" + +#. Tag: para +#: reference_raster.xml:222 +#, no-c-format +msgid "( notation is optional so a-b means the same as (a-b)" +msgstr "" + +#. Tag: term +#: reference_raster.xml:227 +#, no-c-format +msgid "pixeltype text" +msgstr "" + +#. Tag: para +#: reference_raster.xml:228 +#, no-c-format +msgid "" +"One of defined pixel types as described in " +msgstr "" + +#. Tag: term +#: reference_raster.xml:231 +#, no-c-format +msgid "nodataval double precision" +msgstr "" + +#. Tag: para +#: reference_raster.xml:232 +#, no-c-format +msgid "" +"Value to treat as no data. For image outputs that support transparency, " +"these will be blank." +msgstr "" + +#. Tag: title +#: reference_raster.xml:237 +#, no-c-format +msgid "Example: Reclassify band 2 as an 8BUI where 255 is nodata value" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:238 +#, no-c-format +msgid "" +"SELECT ROW(2, '0-100:1-10, 101-500:11-150,501 - 10000: 151-254', '8BUI', " +"255)::reclassarg;" +msgstr "" + +#. Tag: title +#: reference_raster.xml:241 +#, no-c-format +msgid "Example: Reclassify band 1 as an 1BB and no nodata value defined" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:242 +#, no-c-format +msgid "SELECT ROW(1, '0-100]:0, (100-255:1', '1BB', NULL)::reclassarg;" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:252 +#, no-c-format +msgid "unionarg" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:253 +#, no-c-format +msgid "" +"A composite type used as input into the ST_Union function " +"defining the bands to be processed and behavior of the UNION operation." +msgstr "" + +#. Tag: para +#: reference_raster.xml:258 +#, no-c-format +msgid "" +"A composite type used as input into the ST_Union function defining the " +"bands to be processed and behavior of the UNION operation." +msgstr "" + +#. Tag: para +#: reference_raster.xml:268 +#, no-c-format +msgid "1-based value indicating the band of each input raster to be processed." +msgstr "" + +#. Tag: term +#: reference_raster.xml:275 +#, no-c-format +msgid "uniontype text" +msgstr "" + +#. Tag: para +#: reference_raster.xml:280 +#, no-c-format +msgid "" +"Type of UNION operation. One of defined types as described in ." +msgstr "" + +#. Tag: title +#: reference_raster.xml:302 +#, no-c-format +msgid "Raster Management" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:305 +#, no-c-format +msgid "AddRasterConstraints" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:307 +#, no-c-format +msgid "" +"Adds raster constraints to a loaded raster table for a specific column that " +"constrains spatial ref, scaling, blocksize, alignment, bands, band type and " +"a flag to denote if raster column is regularly blocked. The table must be " +"loaded with data for the constraints to be inferred. Returns true of the " +"constraint setting was accomplished and if issues a notice." +msgstr "" + +#. Tag: funcsynopsis +#: reference_raster.xml:311 +#, no-c-format +msgid "" +" boolean AddRasterConstraints name rasttable name rastcolumn boolean srid boolean scale_x boolean scale_y boolean blocksize_x boolean " +"blocksize_y boolean same_alignment " +"boolean regular_blocking boolean " +"num_bands=true boolean pixel_types=true " +"boolean " +"nodata_values=true boolean out_db=true " +"boolean extent=true boolean " +"AddRasterConstraints name rasttable name rastcolumn text[] VARIADIC constraints boolean " +"AddRasterConstraints name rastschema name rasttable name rastcolumn text[] VARIADIC constraints boolean " +"AddRasterConstraints name rastschema name rasttable name rastcolumn boolean srid=true " +"boolean scale_x=true boolean " +"scale_y=true boolean blocksize_x=true " +"boolean blocksize_y=true boolean " +"same_alignment=true boolean regular_blocking=true boolean " +"num_bands=true boolean pixel_types=true " +"boolean " +"nodata_values=true boolean out_db=true " +"boolean extent=true " +msgstr "" + +#. Tag: para +#: reference_raster.xml:441 +#, no-c-format +msgid "" +"Generates constraints on a raster column that are used to display " +"information in the raster_columns raster catalog. The " +"rastschema is the name of the table schema the table " +"resides in. The srid must be an integer value reference " +"to an entry in the SPATIAL_REF_SYS table." +msgstr "" + +#. Tag: para +#: reference_raster.xml:446 +#, no-c-format +msgid "" +"raster2pgsql loader uses this function to register raster " +"tables" +msgstr "" + +#. Tag: para +#: reference_raster.xml:447 +#, no-c-format +msgid "" +"Valid constraint names to pass in: refer to for more details." +msgstr "" + +#. Tag: para +#: reference_raster.xml:449 +#, no-c-format +msgid "blocksize sets both X and Y blocksize" +msgstr "" + +#. Tag: para +#: reference_raster.xml:450 +#, no-c-format +msgid "" +"blocksize_x sets X tile (width in pixels of each tile)" +msgstr "" + +#. Tag: para +#: reference_raster.xml:451 +#, no-c-format +msgid "" +"blocksize_y sets Y tile (height in pixels of each tile)" +msgstr "" + +#. Tag: para +#: reference_raster.xml:452 +#, no-c-format +msgid "" +"extent computes extent of whole table and applys " +"constraint all rasters must be within that extent" +msgstr "" + +#. Tag: para +#: reference_raster.xml:454 +#, no-c-format +msgid "num_bands number of bands" +msgstr "" + +#. Tag: para +#: reference_raster.xml:455 +#, no-c-format +msgid "" +"pixel_types reads array of pixel types for each band " +"ensure all band n have same pixel type" +msgstr "" + +#. Tag: para +#: reference_raster.xml:456 +#, no-c-format +msgid "" +"regular_blocking apply informational flag to denote all " +"tiles are regularly blocked" +msgstr "" + +#. Tag: para +#: reference_raster.xml:457 +#, no-c-format +msgid "" +"same_alignment ensures they all have same alignment " +"meaning any two tiles you compare will return true for. Refer to" +msgstr "" + +#. Tag: para +#: reference_raster.xml:458 +#, no-c-format +msgid "srid ensures all have same srid" +msgstr "" + +#. Tag: para +#: reference_raster.xml:459 +#, no-c-format +msgid "More -- any listed as inputs into the above functions" +msgstr "" + +#. Tag: para +#: reference_raster.xml:462 +#, no-c-format +msgid "" +"This function infers the constraints from the data already present in the " +"table. As such for it to work, you must create the raster column first and " +"then load it with data." +msgstr "" + +#. Tag: para +#: reference_raster.xml:467 +#, no-c-format +msgid "" +"If you need to load more data in your tables after you have already applied " +"constraints, you may want to run the DropRasterConstraints if the extent of " +"your data has changed." +msgstr "" + +#. Tag: para +#: reference_raster.xml:471 reference_raster.xml:620 reference_raster.xml:1114 +#: reference_raster.xml:2126 reference_raster.xml:2259 +#: reference_raster.xml:2419 reference_raster.xml:2462 +#: reference_raster.xml:2514 reference_raster.xml:3934 +#: reference_raster.xml:4000 reference_raster.xml:4123 +#: reference_raster.xml:4226 reference_raster.xml:4290 +#: reference_raster.xml:4443 reference_raster.xml:4908 +#: reference_raster.xml:5187 reference_raster.xml:5252 +#: reference_raster.xml:5317 reference_raster.xml:5663 +#: reference_raster.xml:5800 reference_raster.xml:6002 +#: reference_raster.xml:6099 reference_raster.xml:6219 +#: reference_raster.xml:6343 reference_raster.xml:6423 +#: reference_raster.xml:6488 reference_raster.xml:6538 +#: reference_raster.xml:6588 reference_raster.xml:6638 +#: reference_raster.xml:6687 reference_raster.xml:6737 +#: reference_raster.xml:6787 reference_raster.xml:7870 +#, no-c-format +msgid "Availability: 2.0.0" +msgstr "" + +#. Tag: title +#: reference_raster.xml:475 +#, no-c-format +msgid "Examples: Apply all possible constraints on column based on data" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:477 +#, no-c-format +msgid "" +"CREATE TABLE myrasters(rid SERIAL primary key, rast raster);\n" +"INSERT INTO myrasters(rast)\n" +"SELECT ST_AddBand(ST_MakeEmptyRaster(1000, 1000, 0.3, -0.3, 2, 2, 0, " +"0,4326), 1, '8BSI'::text, -129, NULL);\n" +"\n" +"SELECT AddRasterConstraints('myrasters'::name, 'rast'::name);\n" +"\n" +"\n" +"-- verify if registered correctly in the raster_columns view --\n" +"SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, " +"pixel_types, nodata_values\n" +" FROM raster_columns\n" +" WHERE r_table_name = 'myrasters';\n" +" \n" +" srid | scale_x | scale_y | blocksize_x | blocksize_y | num_bands | " +"pixel_types| nodata_values\n" +"------+---------+---------+-------------+-------------+-----------" +"+-------------+---------------\n" +" 4326 | 2 | 2 | 1000 | 1000 | 1 | " +"{8BSI} | {0}" +msgstr "" + +#. Tag: title +#: reference_raster.xml:481 +#, no-c-format +msgid "Examples: Apply single constraint" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:483 +#, no-c-format +msgid "" +"CREATE TABLE public.myrasters2(rid SERIAL primary key, rast raster);\n" +"INSERT INTO myrasters2(rast)\n" +"SELECT ST_AddBand(ST_MakeEmptyRaster(1000, 1000, 0.3, -0.3, 2, 2, 0, " +"0,4326), 1, '8BSI'::text, -129, NULL);\n" +"\n" +"SELECT AddRasterConstraints('public'::name, 'myrasters2'::name, 'rast'::" +"name,'regular_blocking', 'blocksize');\n" +"-- get notice--\n" +"NOTICE: Adding regular blocking constraint\n" +"INFO: The regular_blocking constraint is just a flag indicating that the " +"column \"rast\" is regularly blocked. As no function exist yet to assert " +"that a raster column is regularly blocked, it is up to the end-user to " +"ensure that the column is truly regularly blocked.\n" +"CONTEXT: PL/pgSQL function \"addrasterconstraints\" line 85 at assignment\n" +"NOTICE: Adding blocksize-X constraint\n" +"NOTICE: Adding blocksize-Y constraint" +msgstr "" + +#. Tag: para +#: reference_raster.xml:489 +#, no-c-format +msgid "" +", , , , , " +msgstr "" + +#. Tag: refname +#: reference_raster.xml:495 +#, no-c-format +msgid "DropRasterConstraints" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:497 +#, no-c-format +msgid "" +"Drops PostGIS raster constraints that refer to a raster table column. Useful " +"if you need to reload data or update your raster column data." +msgstr "" + +#. Tag: funcsynopsis +#: reference_raster.xml:501 +#, no-c-format +msgid "" +" boolean DropRasterConstraints name rasttable name rastcolumn boolean srid boolean scale_x boolean scale_y boolean blocksize_x boolean " +"blocksize_y boolean same_alignment " +"boolean regular_blocking boolean " +"num_bands=true boolean pixel_types=true " +"boolean " +"nodata_values=true boolean out_db=true " +"boolean extent=true boolean " +"DropRasterConstraints name rastschema name rasttable name rastcolumn boolean srid=true " +"boolean scale_x=true boolean " +"scale_y=true boolean blocksize_x=true " +"boolean blocksize_y=true boolean " +"same_alignment=true boolean regular_blocking=true boolean " +"num_bands=true boolean pixel_types=true " +"boolean " +"nodata_values=true boolean out_db=true " +"boolean extent=true boolean " +"DropRasterConstraints name rastschema name rasttable name rastcolumn text[] constraints " +msgstr "" + +#. Tag: para +#: reference_raster.xml:614 +#, no-c-format +msgid "" +"Drops PostGIS raster constraints that refer to a raster table column that " +"were added by . Useful if you " +"need to load more data or update your raster column data. You do not need to " +"do this if you want to get rid of a raster table or a raster column." +msgstr "" + +#. Tag: para +#: reference_raster.xml:616 +#, no-c-format +msgid "To drop a raster table use the standard" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:616 +#, no-c-format +msgid "DROP TABLE mytable" +msgstr "" + +#. Tag: para +#: reference_raster.xml:617 +#, no-c-format +msgid "" +"To drop just a raster column and leave the rest of the table, use standard " +"SQL" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:617 +#, no-c-format +msgid "ALTER TABLE mytable DROP COLUMN rast" +msgstr "" + +#. Tag: para +#: reference_raster.xml:618 +#, no-c-format +msgid "" +"the table will disappear from the raster_columns catalog " +"if the column or table is dropped. However if only the constraints are " +"dropped, the raster column will still be listed in the " +"raster_columns catalog, but there will be no other " +"information about it aside from the column name and table." +msgstr "" + +#. Tag: title +#: reference_raster.xml:623 reference_raster.xml:658 reference_raster.xml:696 +#: reference_raster.xml:1118 reference_raster.xml:1216 +#: reference_raster.xml:1260 reference_raster.xml:1293 +#: reference_raster.xml:1328 reference_raster.xml:1362 +#: reference_raster.xml:1497 reference_raster.xml:1535 +#: reference_raster.xml:1578 reference_raster.xml:1634 +#: reference_raster.xml:1686 reference_raster.xml:1724 +#: reference_raster.xml:1759 reference_raster.xml:1795 +#: reference_raster.xml:1831 reference_raster.xml:1865 +#: reference_raster.xml:1899 reference_raster.xml:1933 +#: reference_raster.xml:1984 reference_raster.xml:2040 +#: reference_raster.xml:2094 reference_raster.xml:2130 +#: reference_raster.xml:2180 reference_raster.xml:2215 +#: reference_raster.xml:2273 reference_raster.xml:2311 +#: reference_raster.xml:2386 reference_raster.xml:2423 +#: reference_raster.xml:2467 reference_raster.xml:2519 +#: reference_raster.xml:2562 reference_raster.xml:2607 +#: reference_raster.xml:2650 reference_raster.xml:2695 +#: reference_raster.xml:2762 reference_raster.xml:2845 +#: reference_raster.xml:2937 reference_raster.xml:3012 +#: reference_raster.xml:3224 reference_raster.xml:3265 +#: reference_raster.xml:3299 reference_raster.xml:3347 +#: reference_raster.xml:3390 reference_raster.xml:3471 +#: reference_raster.xml:3554 reference_raster.xml:3615 +#: reference_raster.xml:3677 reference_raster.xml:3756 +#: reference_raster.xml:3811 reference_raster.xml:3893 +#: reference_raster.xml:3942 reference_raster.xml:4004 +#: reference_raster.xml:4230 reference_raster.xml:4447 +#: reference_raster.xml:4490 reference_raster.xml:4730 +#: reference_raster.xml:4853 reference_raster.xml:5043 +#: reference_raster.xml:5113 reference_raster.xml:5150 +#: reference_raster.xml:5667 reference_raster.xml:6006 +#: reference_raster.xml:6226 reference_raster.xml:6291 +#: reference_raster.xml:6492 reference_raster.xml:6542 +#: reference_raster.xml:6592 reference_raster.xml:6642 +#: reference_raster.xml:6691 reference_raster.xml:6741 +#: reference_raster.xml:6791 reference_raster.xml:6862 +#: reference_raster.xml:6911 reference_raster.xml:6966 +#: reference_raster.xml:7011 reference_raster.xml:7056 +#: reference_raster.xml:7140 reference_raster.xml:7227 +#: reference_raster.xml:7308 reference_raster.xml:7389 +#: reference_raster.xml:7470 reference_raster.xml:7602 +#: reference_raster.xml:7683 reference_raster.xml:7763 +#: reference_raster.xml:7960 reference_raster.xml:8055 +#: reference_raster.xml:8148 +#, no-c-format +msgid "Examples" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:625 +#, no-c-format +msgid "" +"SELECT DropRasterConstraints ('myrasters','rast');\n" +"----RESULT output ---\n" +"t\n" +"\n" +"-- verify change in raster_columns --\n" +"SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, " +"pixel_types, nodata_values\n" +" FROM raster_columns\n" +" WHERE r_table_name = 'myrasters';\n" +" \n" +" srid | scale_x | scale_y | blocksize_x | blocksize_y | num_bands | " +"pixel_types| nodata_values\n" +"------+---------+---------+-------------+-------------+-----------" +"+-------------+---------------\n" +" 0 | | | | | " +"| |" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:636 +#, no-c-format +msgid "PostGIS_Raster_Lib_Build_Date" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:638 +#, no-c-format +msgid "Reports full raster library build date." +msgstr "" + +#. Tag: funcprototype +#: reference_raster.xml:643 +#, no-c-format +msgid "" +"text PostGIS_Raster_Lib_Build_Date " +"" +msgstr "" + +#. Tag: para +#: reference_raster.xml:654 +#, no-c-format +msgid "Reports raster build date" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:660 +#, no-c-format +msgid "" +"SELECT PostGIS_Raster_Lib_Build_Date();\n" +"postgis_raster_lib_build_date\n" +"-----------------------------\n" +"2010-04-28 21:15:10" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:672 +#, no-c-format +msgid "PostGIS_Raster_Lib_Version" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:674 +#, no-c-format +msgid "" +"Reports full raster version and build configuration infos." +msgstr "" + +#. Tag: funcprototype +#: reference_raster.xml:680 +#, no-c-format +msgid "" +"text PostGIS_Raster_Lib_Version " +"" +msgstr "" + +#. Tag: para +#: reference_raster.xml:691 +#, no-c-format +msgid "Reports full raster version and build configuration infos." +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:698 +#, no-c-format +msgid "" +"SELECT PostGIS_Raster_Lib_Version();\n" +"postgis_raster_lib_version\n" +"-----------------------------\n" +" 2.0.0" +msgstr "" + +#. Tag: refname +#: reference_raster.xml:712 +#, no-c-format +msgid "ST_GDALDrivers" +msgstr "" + +#. Tag: refpurpose +#: reference_raster.xml:714 +#, no-c-format +msgid "" +"Returns a list of raster formats supported by your lib gdal. These are the " +"formats you can output your raster using ST_AsGDALRaster." +msgstr "" + +#. Tag: funcprototype +#: reference_raster.xml:719 +#, no-c-format +msgid "" +"setof record ST_GDALDrivers " +"integer OUT idx " +"text OUT short_name text OUT long_name text OUT create_options" +msgstr "" + +#. Tag: para +#: reference_raster.xml:732 +#, no-c-format +msgid "" +"Returns a list of raster formats short_name,long_name and creator options of " +"each format supported by your lib gdal. Use the short_name as input in the " +"format parameter of . Options vary depending on what drivers your libgdal was compiled with. " +"create_options returns an xml formatted set of " +"CreationOptionList/Option consisting of name and optional type, description and set of VALUE " +"for each creator option for the specific driver." +msgstr "" + +#. Tag: para +#: reference_raster.xml:735 reference_raster.xml:1042 +#: reference_raster.xml:4537 reference_raster.xml:4635 +#: reference_raster.xml:4726 reference_raster.xml:4806 +#, no-c-format +msgid "Availability: 2.0.0 - requires GDAL >= 1.6.0." +msgstr "" + +#. Tag: title +#: reference_raster.xml:739 +#, no-c-format +msgid "Examples: List of Drivers" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:741 +#, no-c-format +msgid "" +"SELECT short_name, long_name\n" +"FROM st_gdaldrivers()\n" +"ORDER BY short_name;\n" +" short_name | long_name\n" +"----------------+--------------------------------------\n" +"AAIGrid | Arc/Info ASCII Grid\n" +"DTED | DTED Elevation Raster\n" +"EHdr | ESRI .hdr Labelled\n" +"FIT | FIT Image\n" +"GIF | Graphics Interchange Format (.gif)\n" +"GSAG | Golden Software ASCII Grid (.grd)\n" +"GSBG | Golden Software Binary Grid (.grd)\n" +"GTiff | GeoTIFF\n" +"HF2 | HF2/HFZ heightfield raster\n" +"HFA | Erdas Imagine Images (.img)\n" +"ILWIS | ILWIS Raster Map\n" +"INGR | Intergraph Raster\n" +"JPEG | JPEG JFIF\n" +"KMLSUPEROVERLAY | Kml Super Overlay\n" +"NITF | National Imagery Transmission Format\n" +"PNG | Portable Network Graphics\n" +"R | R Object Data Store\n" +"SAGA | SAGA GIS Binary Grid (.sdat)\n" +"SRTMHGT | SRTMHGT File Format\n" +"USGSDEM | USGS Optional ASCII DEM (and CDED)\n" +"VRT | Virtual Raster\n" +"XPM | X11 PixMap Format" +msgstr "" + +#. Tag: title +#: reference_raster.xml:743 +#, no-c-format +msgid "Example: List of options for each driver" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:744 +#, no-c-format +msgid "" +"-- Output the create options XML column of JPEG as a table --\n" +"-- Note you can use these creator options in ST_AsGDALRaster options " +"argument\n" +"SELECT (xpath('@name', g.opt))[1]::text As oname,\n" +" (xpath('@type', g.opt))[1]::text As otype,\n" +" (xpath('@description', g.opt))[1]::text As descrip\n" +"FROM (SELECT unnest(xpath('/CreationOptionList/Option', create_options::" +"xml)) As opt\n" +"FROM st_gdaldrivers()\n" +"WHERE short_name = 'JPEG') As g;\n" +"\n" +" oname | otype | descrip\n" +"-------------+---------+-----------------------------\n" +" PROGRESSIVE | boolean |\n" +" QUALITY | int | good=100, bad=0, default=75\n" +" WORLDFILE | boolean |" +msgstr "" + +#. Tag: programlisting +#: reference_raster.xml:746 +#, no-c-format +msgid "" +"-- raw xml output for creator options for GeoTiff --\n" +"SELECT create_options\n" +"FROM st_gdaldrivers()\n" +"WHERE short_name = 'GTiff';\n" +"\n" +"\n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +" \n" +"