Geocoding Guide for Poland - REST - Support
Contents
1. RS8A Point parcel level precision for reverse geocoding Candidate returned from address dictionary RS5A Interpolated street candidate for reverse geocoding Candidate returned from address dictionary RS4A Street centroid candidate for reverse geocoding Candidate returned from address dictionary If the reverse geocoded candidate comes from a user dictionary the letter U is appended to the result For example RS8U indicates a point parcel level reverse geocode match from a custom user dictionary Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 34 GeocodeAddressGlobal Non match Codes The following result codes indicate no match was made e N No close match NX No close match for street intersections e ND Spectrum Technology Platform could not find the geocoding database for the given postal code or municipality state province anne en ee eee ee ee ee ee ee eee ee eee eee eee eT Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 35 ReverseGeocodeAddressGlobal determines the address for a given latitude longitude point ReverseGeocodeAddressGlobal can determine addresses in many countries The countries available to you depends on which country databases you have installed For example if you have databases for Canada Italy and Australia installed ReverseGeocodeAddressGlobal would be able to geocode addresses in these countries in a single2. 10C 10A 10A Non Match Input suffix does not match the data suffix 10 10 12 10 12 Match Input number 10 matches the first number of the dashed data range 12 10 12 10 12 Match Input number 12 matches the last number of the dashed data range 10A 10 12 10 12 Match Input number 10 matches the first number of the dashed data range Input suffix is not in data but this does not affect matching eS Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 9 GeocodeAddressGlobal Input House Data House Number Candidate House Match or Non Match Number Number 12 10 14 10 14 Non Match Input number 12 does not match either number of the dashed data range No interpolation is performed ona house number ranges 10 12 10 14 10 14 Match First input number 10 matches the first number of the data and the second number 12 is within the data range 10 12 10A 14A 10A 14A Match The input has no suffix information but the input number 10 matches 10 16 10 12 10 12 Non Match Input second number 16 is outside the 10 12 data range 10 13 10 14 10 14 Non Match Both input numbers are within data range but second number 13 is odd and this does not match with the even range of 10 14 10 13 10 15 10 15 Match Data range 10 15 suggests a mixed odd even range so input is matched RMB 10 10 10 Match Input number matches 16 A16 A16 Match Input number matches RMB 10 A10 A10 Non Match Inpu
3. REST 17 GeocodeAddressGlobal Parameter Description spelled improperly This slows down performance but increases the match rate If the geocoding database is indexed the performance impact is reduced Y Yes a candidate must match the street name to be considered a close match N No a candidate does not have to match the street name to be considered a close match Option MustMatchLocality Specifies whether candidates must match the locality or equivalent to be considered a close match The meaning of Locality varies for different countries e POL Poland Not used Y Yes a candidate must match the locality to be considered a close match N No a candidate does not have to match the locality to be considered a close match Option MustMatchCity Specifies whether candidates must match the city to be considered a close match For Japan this field specifies whether the candidate must match the municipality subdivision oaza If you do not require exact matches on city the geocoder searches on the street address matched to the particular postal code and considers other cities that do not match the name but do match the postal code Y Yes a candidate must match the city to be considered a close match N No a candidate does not have to match the city to be considered a close match Option MustMatchCounty Specifies whether candidates must match the county or equivalent to be considered a close match The meaning of co
4. results with Z2 or Z3 result codes If the postal candidate comes from a user dictionary the letter U is appended to the result For example Z1U indicates a postal centroid match from a custom user dictionary International Geographic Geocoding Result Codes G Codes Geographic level geocoded candidates return a result code beginning with the letter G The numbers following the G in the result code provides more detailed information on the accuracy of the candidate Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 33 GeocodeAddressGlobal Table 11 Geographic G Result Codes G Result Code Description G1 State or province centroid match G2 County district or region centroid match G3 City or town municipality centroid match G4 Locality village suburb or neighborhood centroid match If the geographic candidate comes from a user dictionary the letter U is appended to the result code For example G4U indicates a locality centroid match from a custom user dictionary Reverse Geocoding Codes R Codes Matches in the R category indicate that the record was matched by reverse geocoding The second two characters of the R result code indicate the type of match found R geocode results include an additional letter to indicate the dictionary from which the match was made Example reverse geocoding codes Table 12 Reverse Geocoding R Result Codes Reverse Geocoding Code Description
5. by a double ampersand amp amp in AddressLine1 For some countries the word AND can also be used to delimit intersections The amp amp delimiter can be used for all countries For example AddressLine1 Grodkowska amp amp Augustyna Kordeckiego City Nysa Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 7 GeocodeAddressGlobal Note The double ampersand amp amp can always be used as an street intersection separator For some countries you can use additional symbols or words to delimit street intersections All close match criteria are enforced for intersection geocoding just as for any street level geocoding Address Range Input Street range data represents a range of house numbers that can possibly exist but are not guaranteed to exist For addresses derived from the Street Range Address database house number matching is more relaxed compared to the G NAF database Also the candidate house number may be changed based on how the input house number matches the suffix range data The following table shows geocoding match results with house number ranges from a Street range data source Input House Number Candidate House Candidate House Match or Non Match Number Range Number 10 10 12 10 Match 10A 10 12 10 Match 10 8 12 10 Match 10 14 10 12 10 Match 10 14 10 20 10 14 Match 10 12 16 12 Non Match G NAF Range Address Matching Australian addresses originating from the G NAF
6. database may contain house number ranges but these records still represent single address delivery points These range addresses may also have alphabetic suffixes For example the following house address numbers each represent a single address Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 8 GeocodeAddressGlobal 10 12 10A 10C 10 10A GeocodeAddressAUS validates and geocodes these point source addresses If the criteria are met and the reliability of the match is 1 or 2 GeocodeAddressAUS returns point matches with an S8 result code See the description of the output field AUS GNAF_Reliability in G NAF Outputfor information on reliability levels If a complete house number range suffix is specified for input candidates from a point data source must be fully matched If partial house number information is given without complete range or suffix information then candidates with non conflicting range suffix information or no range suffix information will match The following table shows geocoding match results with house number ranges from a point data source G NAF database The matching rules are based on the Address Matching Approval System AMAS developed by Australia Post Table 2 Range Match Results Input House Data House Number Candidate House Match or Non Match Number Number 10 10A 10A Match Input number 10 matches 10A or 10 with any suffix 10A 10 10 Match Input number 10 matches
7. directional that follows the street name UnitNumberHigh The highest unit number of the range in which the unit resides UnitNumberLow The lowest unit number of the range in which the unit resides Return Parsed Address The formatted input address can be returned along with a separate returned field for each input address element Parsed Address Input elements are returned in separately labeled fields names with a Input extension See the Return Parsed Address Geocoding Option for more information Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 27 GeocodeAddressGlobal Geocode Output Table 7 Geocode Output for Poland Response Element Description CoordinateSystem The coordinate system used to determine the latitude and longitude coordinates A coordinate system specifies a map projection coordinate units etc An example is EPSG 4326 EPSG stands for European Petroleum Survey Group Latitude Seven digit number in degrees and calculated to four decimal places in the format specified Longitude Seven digit number in degrees and calculated to four decimal places in the format specified Country Specific Output The following topics describe output that s unique to specific countries Result Codes Result codes contain information about the success or failure of the geocoding attempt as well as information about the accuracy of the geocode Table 8 Result Code Output for Poland Re
8. for Poland REST 44 ReverseGeocodeAddressGlobal Response Element Description UnitNumberHigh The highest unit number of the range in which the unit resides UnitNumberLow The lowest unit number of the range in which the unit resides Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 45 Candidates returned by Spectrum geocoders return another class of return codes that are referred to as International Geocoding Result Codes Each attempted match returns a result code in the Geocoder MatchCode output field 8 In this section International Street Geocoding Result Codes S Codes 47 Interpreting S Result Codes 48 International Postal Geocoding Result Codes Z Codes 49 International Geographic Geocoding Result Codes G Codes 50 Reverse Geocoding Codes R Codes 50 Non match Codes 51 Result Codes for International Geocoding International Street Geocoding Result Codes S Codes Street level geocoded candidates return a result code beginning with the letter S The second character in the code indicates the positional accuracy of the resulting point for the geocoded record Table 18 Street S Result Codes S Result Code Description S1 Single close match with the point located at postal code centroid 3 Single close match with the point located at postal code centroid S4 Single close match with the point located at the street centroid For databases vintage 2014 Q4
9. information is returned when available even if the input address did not include level information or if the input had the wrong level information If the input address has level information but the G NAF database does not include level information for the matching address then the input level information is discarded since it is not validated in the G NAF data Following are several examples of partial addresses that contain level information The level information is indicated in bold Suite 3 Level 7 17 Jones Street Suite 3 is a unit Floor 2 17 Jones Street Level 7 17 19 Middleborough Road Geocode Address Global Options Geocode Address Global includes geocoding matching and data options Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 11 GeocodeAddressGlobal Geocoding Options The following table lists the options that control how a location s coordinates are determined Table 3 Geocoding Options for Poland Parameter Description Option GeocodeLevel Specifies how precisely you want to geocode addresses One of the following StreetAddress The geocoder attempts to geocode addresses to a street address but some matches may end up at a less precise location such as a postal code centroid intersection or shape path PostalCentroid If postal code data is available the geocoder attempts to geocode addresses to the most precise postal code it finds The advantage of postal code centroid
10. lower ranked databases are demoted to non close matches You can also use the order of the databases to perform fallback processing if you have an both an address point database and a street level database installed for the country List the address point database first and the street database second If the address cannot be geocoded to the address point level the geocoder will attempt to geocode it to the street level Output Table 17 Reverse Geocode Address Global Output Fields Response Element Description AddressLine1 First line of the address AddressLine2 Second line of the address Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 41 Response Element ApartmentLabel ApartmentNumber City Data Country ReverseGeocodeAddressGlobal Description The type of unit such as apartment suite or lot Unit number The municipality name The meaning of county varies by country e POL Poland District poviat The district povia name Distance The distance from input location in meters If the input coordinates are an exact match for the address the value is 0 FirmName Name of the company or a place name Geocoder MatchCode Indicates how closely the input coordinates match the candidate address For more information see Reverse Geocoding Codes R Codes on page 34 HouseNumber The building number for the matched location HouseNumberHigh The highest ho
11. may also represent a single building with multiple units such as an apartment building The Ranges field contains the following sub fields Address This is a list filed that contains sub fields for any address elements AddressLine1 City and so on that are different from the candidate s address AdditionalFields A listing of country specific information related to the address The information contained in AdditionalFields varies by country HouseNumberHigh The highest address number for the range HouseNumberLow The lowest address number for the range Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 25 GeocodeAddressGlobal Response Element Description SegmentParity Indicates the side of the street where the range is located One of the following 0 It is not known which side of the street the range is located on 1 The range is on the left side of the street 2 The range is on the right side of the street HouseNumberParity Indicates whether the range contains odd or even address numbers One of the following 0 The range contains both odd and even address numbers 1 The range contains odd address numbers 2 The range contains even address numbers 1 It is not known whether the range contains odd or even house numbers TotalRangeUnitsReturned The number of unit ranges returned for the address A unit is an address within a building such as an apartment or suite RangeUnits A list of the r
12. or newer the input house number is returned with the candidate even if no such house number was found The S4 code is followed by letters and dashes indicating match precision See Interpreting S Result Codes on page 32 S5 Single close match with the point located at a street address position The S5 code is followed by letters and dashes indicating match precision For information about these letters see Interpreting S Result Codes on page 32 S7 Single match with the point located at an interpolated point along the candidate s street segment When the potential candidate is not an address point candidate and there are no exact house number matches among other address point candidates the S7 result is returned using address point interpolation The point is interpolated according to the next highest or lowest address point candidate that both intersects the segment and whose house number is contained within the range of houses of the original candidate By using known address reference points on the street segment the S7 point can be adjusted to a more accurate position For Australia the S7 G result code is also used for single matches with G NAF Reliability level of 3 The reliability level is returned in the output field AUS GNAF_Reliability For more information see Australia G NAF Database Output S8 Single close match with the point located at either the single point associated with an address point candidate or at an address point c
13. stage Note ReverseGeocodeAddressGlobal does not support U S addresses To geocode U S addresses you must use ReverseGeocodeUSLocation That performs reverese geocoding specifically for USA addresses Before you can work with ReverseGeocodeAddressGlobal you must define a global database resource containing a database for one or more countries Once you create the database resource a ReverseGeocodeAddressGlobal will become available in the Management Console Enterprise Designer and Interactive Driver In this section Input 37 Options 38 41 Output ReverseGeocodeAddressGlobal Input ReverseGeocodeAddressGlobal takes longitude and latitude as input For GRC RUS and JPN the user s locale determines the language of the returned candidates for reverse geocoding This can be Greek Russian or Japanese for GRC RUS and JPN respectively English is the default locale Table 13 ReverseGeocodeGlobal Input Parameter Format Description Data Latitude String The latitude of the point for which you want address information Data Longitude String The longitude of the point for which you want address information Data Country String One of the following The name of the country in English The two character ISO 3116 1 alpha 2 country code The three character ISO 3116 1 alpha 3 country code Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 37 ReverseGeocodeAddressGlobal Op
14. 3 result codes Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 49 Result Codes for International Geocoding If the postal candidate comes from a user dictionary the letter U is appended to the result For example Z1U indicates a postal centroid match from a custom user dictionary International Geographic Geocoding Result Codes G Codes Geographic level geocoded candidates return a result code beginning with the letter G The numbers following the G in the result code provides more detailed information on the accuracy of the candidate Table 20 Geographic G Result Codes G Result Code Description G1 State or province centroid match G2 County district or region centroid match G3 City or town municipality centroid match G4 Locality village suburb or neighborhood centroid match If the geographic candidate comes from a user dictionary the letter U is appended to the result code For example G4U indicates a locality centroid match from a custom user dictionary Reverse Geocoding Codes R Codes Matches in the R category indicate that the record was matched by reverse geocoding The second two characters of the R result code indicate the type of match found R geocode results include an additional letter to indicate the dictionary from which the match was made Example reverse geocoding codes Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 50 Res
15. Code Addon The second part of a postcode This field is not used by most countries PreAddress Miscellaneous information that appears before the street name Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 43 Response Element Reverse GeocodeAddressGlobal Description PrivateMailbox SegmentCode SegmentParity This field is not currently used A unique ID that identifies a street segment Indicates which side of the street has odd numbers L Left side of the street R Right side of the street B Both sides of the street U Undetermined Data StateProvince StreetDataType StreetName StreetPrefix StreetSuffix TrailingDirectional The meaning of State Province varies by country e POL Poland Province voivodship The default search order rank of the database used to geocode the address A value of 1 indicates that the database is first in the default search order 2 indicates that the database is second in the default search order and so on The default database search order is specified in the Management Console with the Database Resources tool For most countries this contains the street name The type of street when the street type appears before the base street name The type of street when the street type appears after the base street name Street directional that follows the street name Spectrum Technology Platform 10 0 SP1 Geocoding Guide
16. andidate may be a part of multiple ranges if the candidate is a street instead of a building NumberOfRangeUnits Indicates the number of units included in the range A unit is an address within a building such as an apartment or office suite Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 24 Response Element GeocodeAddressGlobal Description PostalCode The postcode for the address The format of the postcode varies by country Postcode data is not available for every country PostalCode Addon The second part of a postcode This field is not used by most countries PostalCode Addon Input PostalCode Base PostalCode Base I nput PreAddress PrivateMailbox The second part of a postcode as it was input This field is not used by most countries The first part of a postcode This field is not used by most countries The first part of a postcode This field is not used by most countries Miscellaneous information that appears before the street name This field is not currently used Ranges This is a list field containing the address ranges that exist on the street segment where the candidate address is located A range is a series of addresses along a street segment For example 5400 5499 Main St is an address range representing addresses in the 5400 block of Main St A range may represent just odd or even addresses within a segment or both odd and even addresses A range
17. andidate that shares the same house number No interpolation is required S8 returns are possible with point databases only SX Single close match with the point located at street intersection Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 47 Result Codes for International Geocoding Interpreting S Result Codes For S street geocoded international result codes eight additional characters describe how closely the address matches an address in the database The characters appear in the order listed in the following table Any non matched address elements are represented by a dash For example the result code S5 N SCZA represents a single close match that matched the street name street suffix direction town and postcode The dashes indicate that there was no match on house number street prefix direction or thoroughfare type The match came from the Street Range Address database This record would be geocoded at the street address position of the match candidate Category Description Example H House number 18 P Street prefix direction North P is present if any of these conditions are satisfied The candidate pre directional matches the input pre directional e The candidate post directional matches the input pre directional after pre and post directionals are swapped The input does not have a pre directional N Street name Merivale T Street type St S Street suffix direction W S in result
18. anges of units within the building An example of units are apartments or suites Address This is a list filed that contains sub fields for any address elements AddressLine 1 City and so on that are different from the candidate s address UnitNumberHigh The highest unit number UnitNumberLow The lowest unit number SegmentCode A unique ID that identifies a street segment SegmentParity Indicates which side of the street has odd numbers L Left side of the street R Right side of the street B Both sides of the street U Undetermined Renee ee ee eee ee ee Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 26 GeocodeAddressGlobal Response Element Description Data StateProvince The meaning of State Province varies by country e POL Poland Province voivodship StreetDataType The default search order rank of the database used to geocode the address A value of 1 indicates that the database is first in the default search order 2 indicates that the database is second in the default search order and so on The default database search order is specified in the Management Console with the Database Resources tool StreetName For most countries this contains the street name StreetPrefix The type of street when the street type appears before the base street name StreetSuffix The type of street when the street type appears after the base street name TrailingDirectional Street
19. appear in all copies of the Software and that both the above copyright notice s and this permission notice appear in supporting documentation THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS INNO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE DATA OR PROFITS WHETHER IN AN ACTION OF CONTRACT NEGLIGENCE OR OTHER TORTIOUS ACTION ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE Except as contained in this notice the name of a copyright holder shall not be used in advertising or otherwise to promote the sale use or other dealings in this Software without prior written authorization of the copyright holder a ee eee ee ee eee ee ee ee ee eee Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 54 pitney bowes 3001 Summer Street Stamford CT 06926 0700 USA www pitneybowes com 2015 Pitney Bowes All Rights Reserved
20. ated with an address point candidate or at an address point candidate that shares the same house number No interpolation is required S8 returns are possible with point databases only SX Single close match with the point located at street intersection Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 31 GeocodeAddressGlobal Interpreting S Result Codes For S street geocoded international result codes eight additional characters describe how closely the address matches an address in the database The characters appear in the order listed in the following table Any non matched address elements are represented by a dash For example the result code S5 N SCZA represents a single close match that matched the street name street suffix direction town and postcode The dashes indicate that there was no match on house number street prefix direction or thoroughfare type The match came from the Street Range Address database This record would be geocoded at the street address position of the match candidate Category Description Example H House number 18 P Street prefix direction North P is present if any of these conditions are satisfied The candidate pre directional matches the input pre directional e The candidate post directional matches the input pre directional after pre and post directionals are swapped The input does not have a pre directional N Street name Merivale T Street ty
21. cated at the street centroid For databases vintage 2014 Q4 or newer the input house number is returned with the candidate even if no such house number was found The S4 code is followed by letters and dashes indicating match precision See Interpreting S Result Codes on page 32 S5 Single close match with the point located at a street address position The S5 code is followed by letters and dashes indicating match precision For information about these letters see Interpreting S Result Codes on page 32 S7 Single match with the point located at an interpolated point along the candidate s street segment When the potential candidate is not an address point candidate and there are no exact house number matches among other address point candidates the S7 result is returned using address point interpolation The point is interpolated according to the next highest or lowest address point candidate that both intersects the segment and whose house number is contained within the range of houses of the original candidate By using known address reference points on the street segment the S7 point can be adjusted to a more accurate position For Australia the S7 G result code is also used for single matches with G NAF Reliability level of 3 The reliability level is returned in the output field AUS GNAF_Reliability For more information see Australia G NAF Database Output S8 Single close match with the point located at either the single point associ
22. character sets such as the Middle East countries Specifies whether candidates are sorted and returned based on the input language That is if the input was in Russian the Russian character candidate is returned first followed by the English language candidate This will override the dictionary order Y Yes candidates are sorted and returned based on input language N No candidates are returned in the order that the dictionary was added to the database regardless of input language You may want to use a balanced strategy between match rate and geographic precision That is you may want to geocode as many records as possible automatically but at the same time want to minimize the number of weaker matches false positives For example false positives can occur when the geocoder e finds a street that sounds like the input street e finds the same street in another city if postal code match is not required e finds the street but with a different house number if house number is not required The following settings may achieve a good balance between match rate and precision e CloseMatchesOnly Specify Y e MustMatchHouseNumber Specify Y e MustMatchStreet Specify Y FallbackToPostal Specify N Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 19 Data Options GeocodeAddressGlobal The Data tab allows you to specify which databases to use in geocoding Databases contain the a
23. cifies whether to return the formatted input street address and each input address element in a separate field This feature can help you understand how the input address was parsed and identify specific input elements that could not be geocoded For example a returned HouseNumber Input could contain an invalid house number in your input address Option Includelnputs You can specify parsed input returns for a specific country For example a REST API example for Canada is Option CAN IncludelInputs Y Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 14 GeocodeAddressGlobal Parameter Description Note Data vintage must be 2014 Q4 or newer to get Parsed Address Input returns Also note that Parsed Address Input elements are not returned for every country Parsed Address Input elements are returned in separately labeled fields names with a Input extension For example e FormattedinputStreet Input e City Input e Country Input e HouseNumber Input e Locality Input e PostalCode Base Input e StreetName Input e StreetSuffix Input Other labeled fields are possible depending on the input address country and data source Note Parsed Address Input elements are not returned for every country Also because Geocode Address World geocodes to the geographic or postal level only not street address this does not return Parsed Address Input For many countries if part of the input address cou
24. code is present if any of these conditions are satisfied The candidate post directional matches the input post directional Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 48 Result Codes for International Geocoding Category Description Example The candidate pre directional matches the input post directional after pre and post directionals are swapped The input does not have a post directional C City name South Brisbane Z Postal code 4101 A G or U Database type used to obtain the match A e A Street Range Address database e U Customer user defined database International Postal Geocoding Result Codes Z Codes Matches in the Z category indicate that a match was made at the postcode level A postcode match is returned in either of these cases e You specified to match to postal code centroids The resulting point is located at the postal code centroid with the following possible accuracy levels e There is no street level close match and you specified to fall back to postal code centroid Table 19 Postal Z Result Codes Z Result Code Description Z1 Postal Code centroid match Z3 Full postal code centroid match For Canada this is an FSALDU centroid Postal level geocoded candidates return a result code beginning with the letter Z Poland can generate a Z1 result code Country specific geocoders can often generate more accurate postcode results with Z2 or Z
25. d DPV eLOT FASTforward First Class Mail Intelligent Mail Laca NCoaH K PAVE PLANET Code Postal Service POSTNET Post Office RDI Suite United States Postal Service Standard Mail United States Post Office USPS ZIP Code and ZIP 4 This list is not exhaustive of the trademarks belonging to the Postal Service Pitney Bowes Inc is a non exclusive licensee of USPS for NCOAH processing Prices for Pitney Bowes Software s products options and services are not established controlled or approved by USPS or United States Government When utilizing RDI data to determine parcel shipping costs the business decision on which parcel delivery company to use is not made by the USPS or United States Government Data Provider and Related Notices Data Products contained on this media and used within Pitney Bowes Software applications are protected by various trademarks and by one or more of the following copyrights Copyright United States Postal Service All rights reserved 2014 TomTom All rights reserved TomTom and the TomTom logo are registered trademarks of TomTom N V 1987 2014 HERE All rights reserved Fuente INEGI Instituto Nacional de Estadistica y Geografia Based upon electronic data National Land Survey Sweden Copyright United States Census Bureau Copyright Nova Marketing Group Inc Portions of this program are Copyright 1993 2007 by Nova Marketing Group Inc All Rights Rese
26. ddress and geocode data necessary to determine the geocode for a given address There are two kinds of databases standard databases and custom databases Standard databases are those supplied by Pitney Bowes and based on address and geocoding data from postal authorities and suppliers of geographical data Custom databases are databases you create to enhance or augment standard databases for your particular needs The following table lists the options available for specifying which databases to use and the search order of databases Table 5 Data Options for Poland Parameter Description Option Database Option DatabasePreference Option DatabaseSearchOrder Specifies the database to be used for geocoding Only databases that have been defined in the Databases Resources panel in the Management Console are available Specifies which geocoding databases to use One of the following PreferCustom PreferStandard CustomOnly StandardOnly Both Use both standard databases and custom databases but give preference to candidates from custom databases Use this option if you feel your custom database is superior to the standard database Use both standard databases and custom databases but give preference to candidates from standard databases Use only custom databases Ignore standard databases Use only standard databases Ignore custom databases Use both standard databases and custom databases In cases where candida
27. e found Default N No do not return candidates Addresses that result in multiple candidates will fail to geocode If you specify KeepMultimatch Y this option specifies the maximum number of results to return The default is 1 Specify 1 minus one to return all possible candidates Specifies whether to return address range information If you enable this option the output field Ranges will be included in the output A range is a series of addresses along a street segment For example 5400 5499 Main St is an address range representing addresses in the 5400 block of Main St A range may represent just odd or even addresses within a segment or both odd and even addresses A range may also represent a single building with multiple units such as an apartment building Y Yes return address range information N No do not return address range information Default Option MaxRanges If you choose to return ranges this option specifies the maximum number of ranges to return for each candidate Since the geocoder returns one candidate per segment and since a segment may contain multiple ranges this option allows you to see the other ranges in a candidate s segment Option MaxRangeUnits If you choose to return ranges this option specifies the maximum number of units for example apartments or suites to return for each range For example if you were to geocode an office building at 65 Main St containing four suites th
28. eAddressGlobal you must define a global database resource containing a database for one or more countries Once you create the database resource a GeocodeAddressGlobal will become available in the Management Console Enterprise Designer and Interactive Driver GeocodeAddressGlobal is an optional component of the Enterprise Geocoding Module In this section Input 4 Geocode Address Global Options 11 Output 21 GeocodeAddressGlobal Input GeocodeAddressGlobal takes an address or intersection as input To obtain the best performance and the most possible matches your input address lists should be as complete as possible free of misspellings and incomplete addresses and as close to postal authority standards as possible Most postal authorities have websites that contain information about address standards for their particular country Input Fields To obtain the best performance and the most possible matches your input address lists should be as complete as possible free of misspellings and incomplete addresses and as close to postal authority standards as possible Most postal authorities have websites that contain information about address standards for their particular country The following table lists the input fields used for geocoding locations in Poland Table 1 Input Fields for Poland Parameter Description Data AddressLine1 One of the following The address line containing the street name and building numbe
29. ent data 18 The result is an address point that was projected using the centerline offset feature You must have both a point and a street range database to use the centerline offset feature and thereby return LocationPrecision 18 StreetDataType The default search order rank of the database used to geocode the address A value of 1 indicates that the database is first in the default search order 2 indicates that the database is second in the default search order and so on The default database search order is specified in the Management Console with the Database Resources tool Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 30 GeocodeAddressGlobal Result Codes for International Geocoding Candidates returned by Spectrum geocoders return another class of return codes that are referred to as International Geocoding Result Codes Each attempted match returns a result code in the Geocoder MatchCode output field International Street Geocoding Result Codes S Codes Street level geocoded candidates return a result code beginning with the letter S The second character in the code indicates the positional accuracy of the resulting point for the geocoded record Table 9 Street S Result Codes S Result Code Description S1 Single close match with the point located at postal code centroid 3 Single close match with the point located at postal code centroid S4 Single close match with the point lo
30. eocoding Guide for Poland REST 39 Reverse GeocodeAddressGlobal Parameter Description Option CoordinateSystem A coordinate system is a reference system for the unique location of a point in space Cartesian planar and Geodetic geographical coordinates are examples of reference systems based on Euclidean geometry Spectrum Technology Platform supports systems recognized by the European Petroleum Survey Group EPSG Each country supports different coordinate systems Depending on the country you have one or more of the following options EPSG 4326 Also known as the WGS84 coordinate system EPSG 27200 Also known as the NZGD49 coordinate system Matching Options Table 15 Matching Options for Poland Parameter Description Option KeepMultimatch Specifies whether to return results when the coordinates match to multiple candidate addresses in the database If this option is not selected coordinates that results in multiple address candidates will fail to geocode If you select this option specify the maximum number of candidates to return using the Option MaxCandidates option see below Y Yes return candidates when multiple candidates are found Default N No do not return candidates Addresses that result in multiple candidates will fail to geocode This is a Reverse geocoding option that applies to Greece Russia Ukraine and any other country that supports dual character sets such as the Middle East countrie
31. ere would be a maximum of four units returned for the building s range 65 Suite 1 65 Suite 2 65 Suite 3 and 65 Suite 4 If you were to specify a maximum number of units as 2 then only two units would be returned instead of all four Option CloseMatchesOnly Specifies whether to return only those geocoded results that are close match candidates For example if there are 10 candidates and two of them are close candidates and you enable this option only the two close matching candidates would Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 16 Parameter GeocodeAddressGlobal Description Option MatchMode be returned instead of all 10 To specify what is considered a close match use the options Address candidates are ranked according to how closely the input address matches these preferences Y Yes return only close matches N No do not return only close matches Default Specifies how to determine whether a candidate is a close match One of the following CustomMode This option allows you to specify which parts of a candidate address must match the input address to be considered a close match Use the to specify the address elements you want This is the default value for most countries RelaxedMode All candidate addresses are considered a close match Option MustMatchInput Specifies whether candidates must match all non blank input fields to be considered a close match For examp
32. he address Offset is also used to prevent addresses across the street from each other from being given the same point The following diagram shows an offset point in relation to the original point Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 38 Reverse GeocodeAddressGlobal Parameter Description Offset Pon _Original Point Street coordinates are accurate to 1 10 000 of a degree and interpolated points are accurate to the millionths of a degree Option OffsetFromCorner Specifies the distance to offset the street end points in street level matching The distance is specified in the units you specify in the OffsetUnits option This value is used to prevent addresses at street corners from being given the same geocode as the intersection Note Offset is not supported for the United Kingdom GBR or Japan JPN The default value varies by country 12 meters Australia AUS Austria AUT Germany DEU 7 meters For other supported countries the default offset is 7 meters The following diagram compares the end points of a street to offset end points 319 oo Street Segment End With Corner Offset Street Segment End Option OffsetUnits Specifies the unit of measurement for the street offset and corner offset options One of the following Feet e Miles e Meters e Kilometers The default is Meters Spectrum Technology Platform 10 0 SP1 G
33. hen used a locality typically appears on the lastline of the address with the postcode POL Poland Not used Data PostalCode The postal code in the appropriate format for the country Poland uses a five digit postal code in the format 99 999 The first digit represents the postal district The second digit represents a major subdivision of that district The three numbers after the dash represent the delivery post office For large municipalities the last three digits can represent a particular street section of a street or sometimes a specific address Data StateProvince The meaning of State Province varies by country e POL Poland Province voivodship Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 5 GeocodeAddressGlobal Address Input Guidelines Follow these suggestions to ensure that your street input data is in the best format possible for optimal geocoding Address Guidelines for Poland Follow these guidelines to provide input that GeocodeAddressGlobal can successfully geocode For additional information on Poland addresses see the Polish Post website www poczta polska pl Required fields Addresses must contain either a city or a postal code e Thoroughfare types Thoroughfare types and their common abbreviations are recognized and fully supported on input and output Common words and abbreviations The geocoder recognizes common words directionals house number indicator
34. ld not be recognized as a specific address element this content is returned in UnparsedWords Input For intersection addresses the first entered street is returned in StreetName Input and the second entered street name is returned in IntersectionStreet2 Input Matching Options Matching options let you set match restrictions fallback and multiple match settings so that the matching can be as strict or relaxed as you need The strictest matching conditions require an exact match on house number street name postal code and no fallback to postal code centroids The geocoder looks for an exact street address match within the postal code in the input address Relaxing the conditions broadens the area in which it searches for a match For example by relaxing the postal code the geocoder searches for candidates outside the postal code but within the city of your input address eee Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 15 GeocodeAddressGlobal Table 4 Matching Options for Poland Parameter Description Option KeepMultimatch Option MaxCandidates Option ReturnRanges Specifies whether to return results when the address matches to multiple candidates in the database If this option is not selected an address that results in multiple candidates will fail to geocode If you select this option specify the maximum number of candidates to return Y Yes return candidates when multiple candidates ar
35. le if an input address contains a city and postal code then candidates for this address must match the city and postal code to be considered a close match Y Yes a candidate must match all input to be considered a close match N No a candidate does not have to match all input to be considered a close match Default Option MustMatchHouseNumber Specifies whether candidates must match the house number to be considered a close match If you select this option you should also require an exact match on street name This option does not significantly affect performance It does however affect the type of match if the candidate address corresponds to a segment that does not contain any ranges The type of match can also be affected when the house number range for a candidate does not contain the input house number If you relax the house number you should set the maximum ranges to be returned to a value higher than 0 Y Yes a candidate must match the house number to be considered a close match N No a candidate does not have to match the house number to be considered a close match Option MustMatchStreet Specifies whether candidates must match the street name to be considered a close match If a close match is found the geocoder attempts expanded street name manipulation which looks for candidates with names that sound like the input address or that are Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland
36. location returned Returned when Status Code No Geocode Found No Candidates Returned The geocoder could not identify any candidate matches for the address Multiple Candidates Returned The address resulted in multiple candidates In and Keep Multiple Matches not order for the candidate address to be returned selected you must Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 29 GeocodeAddressGlobal Response Element Description LocationPrecision A code describing the precision of the geocode One of the following 0 No coordinate information is available for this candidate address 1 Interpolated street address 2 Street segment midpoint 3 Postal code 1 centroid 4 Partial postal code 2 centroid 5 Postal code 2 centroid 6 Intersection 7 Point of interest This is a placeholder value Spectrum databases do not have POI data so it is not possible to get this return 8 State province centroid 9 County centroid 10 City centroid 11 Locality centroid 12 15 For most countries LocationPrecision codes 12 through 15 LocationPrecision are reserved for unspecified custom items codes 13 Additional point precision for unspecified custom item 14 Additional point precision for unspecified custom item 15 Additional point precision for unspecified custom item 16 The result is an address point 17 The result was generated by using address point data to modify the candidates segm
37. matching is the speed of the operation The disadvantage of postal code matching is that the geocoder only examines the PostalCode field If you use street address precision the geocoder looks at both the street name and the PostalCode field and attempts to return street level coordinates and optionally fall back to postal code coordinates GeographicCentroid The geocoder attempts to geocode addresses to the geographic centroid of a city or state Option Interpolation Y Yes perform address point interpolation N No do not perform address point interpolation Option FallbackToGeographic Specifies whether to attempt to determine a geographic region centroid when an address level geocode cannot be determined Y Yes determine a geographic centroid when an address level centroid cannot be determined Default N No do not determine a geographic centroid when an address level centroid cannot be determined Option FallbackToPostal Specifies whether to attempt to determine a postal code centroid when an address level geocode cannot be determined Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 12 GeocodeAddressGlobal Parameter Description Y Yes determine a postal code centroid when an address level centroid cannot be determined Default N No do not determine a postal code centroid when an address level centroid cannot be determined Option OffsetFromStreet Indicates the offset distance from the
38. may be slightly slower than that of structured address input For best results use delimiters comma semicolon or colon between each address element For example 1 Maja 34 58260 Bielawa If the input address is missing delimiters spaces are recognized as separators and internal parsing rules identify address elements In the example above the address would still successfully geocode even if some or all of the delimiters were missing in the input Note Non delimited or partially delimited single line addresses may take longer to geocode and may not produce the same results as delimited single line input This is especially true for addresses with multi word street names or cities To optimize single line geocoding use delimiters between address elements particularly between street name and city Punctuation is ignored for geocoding purposes Guidelines for Single Line Input e Punctuation is generally ignored however you may improve results and performance by using separators commas semicolons etc between different address elements The country is not required Each country geocoder assumes that the address is in its country e Firm information placename building name or government building is returned if available Street Intersection Input If you enter a street intersection as input the geocoder will provide the coordinates of the intersection To enter an intersection specify the two street names separated
39. pe St S Street suffix direction W S in result code is present if any of these conditions are satisfied e The candidate post directional matches the input post directional The candidate pre directional matches the input post directional after pre and post directionals are swapped The input does not have a post directional Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 32 GeocodeAddressGlobal Category Description Example C City name South Brisbane Z Postal code 4101 A G or U Database type used to obtain the match A e A Street Range Address database e U Customer user defined database International Postal Geocoding Result Codes Z Codes Matches in the Z category indicate that a match was made at the postcode level A postcode match is returned in either of these cases e You specified to match to postal code centroids The resulting point is located at the postal code centroid with the following possible accuracy levels There is no street level close match and you specified to fall back to postal code centroid Table 10 Postal Z Result Codes Z Result Code Description Z1 Postal Code centroid match Z3 Full postal code centroid match For Canada this is an FSALDU centroid Postal level geocoded candidates return a result code beginning with the letter Z Poland can generate a Z1 result code Country specific geocoders can often generate more accurate postcode
40. pitney bowes Spectrum Technology Platform Version 10 0 SP1 Geocoding Guide for Poland REST Table of Contents 1 GeocodeAddressGlobal Input 4 Geocode Address Global Options 11 Output 21 2 ReverseGeocodeAddressGlobal Input 37 Options 38 Output 41 3 Result Codes for International Geocoding International Street Geocoding Result Codes S Codes 47 Interpreting S Result Codes 48 International Postal Geocoding Result Codes Z Codes 49 International Geographic Geocoding Result Codes G Codes 50 Reverse Geocoding Codes R Codes 50 Non match Codes 51 GeocodeAddressGlobal provides street level geocoding for many countries It can also determine city or locality centroids as well as postal code centroids GeocodeAddressGlobal handles street addresses in the native language and format For example a typical French formatted address might have a street name of Rue des Remparts A typical German formatted address could have a street name Bahnhofstrasse Note GeocodeAddressGlobal does not support U S or U K addresses To geocode U S addresses use GeocodeUSAddress To geocode U K addresses use GeocodeAddressGBR The countries available to you depends on which country databases you have installed For example if you have databases for Canada Italy and Australia installed GeocodeAddressGlobal would be able to geocode addresses in these countries in a single stage Before you can work with Geocod
41. r For example Plac Teatralny 13 45 056 Opole e This field can also contain the full address For more information see Single Line Input on page 6 e For all countries except Argentina Great Britain and Japan this field can contain a street intersection To specify a street intersection use double ampersand amp amp to separate the streets For more information see Street Intersection Input on page 7 Data AddressLine2 This field is not used in this country Data City The city or town name Your input address should use the official city name Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 4 GeocodeAddressGlobal Parameter Description Data Country The meaning of county varies by country e POL Poland District poviat The district povia name Data FirmName A place name such as a building name or company name Data HouseNumber The building number You may get better parsing results for some countries if you put the house number in this field instead of AddressLine1 Not every country includes house number data Note The house number specified in the HouseNumber field takes precedence over any house number specified in the AddressLine 1 field Data LastLine The last line of the address e Plac Teatralny 13 45 056 Opole Data Locality The meaning of locality varies by country Generally a locality is a village in rural areas or it may be a suburb in urban areas W
42. rved Copyright Second Decimal LLC Copyright Canada Post Corporation This CD ROM contains data from a compilation in which Canada Post Corporation is the copyright owner 2007 Claritas Inc The Geocode Address World data set contains data licensed from the GeoNames Project www geonames org provided under the Creative Commons Attribution License Attribution Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 53 Copyright License located at http creativecommons org licenses by 3 0 legalcode Your use of the GeoNames data described in the Spectrum Technology Platform User Manual is governed by the terms of the Attribution License and any conflict between your agreement with Pitney Bowes Software Inc and the Attribution License will be resolved in favor of the Attribution License solely as it relates to your use of the GeoNames data ICU Notices Copyright 1995 2011 International Business Machines Corporation and others All rights reserved Permission is hereby granted free of charge to any person obtaining a copy of this software and associated documentation files the Software to deal in the Software without restriction including without limitation the rights to use copy modify merge publish distribute and or sell copies of the Software and to permit persons to whom the Software is furnished to do so provided that the above copyright notice s and this permission notice
43. s Option SortCandidatesUsingLocale Specifies whether candidates are sorted and returned based on the input language That is if the input was in Russian the Russian character candidate is returned first followed by the English language candidate This will override the dictionary order Y Yes candidates are sorted and returned based on input language N No candidates are returned in the order that the dictionary was added to the database regardless of input language Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 40 Reverse GeocodeAddressGlobal Data Options The Data tab allows you to specify which databases to use in reverse geocoding Databases contain the address and geocode data necessary to determine the address for a given point The following table lists the options available for specifying the search order of databases Table 16 Data Options for Poland Parameter Description Option DatabaseSearchOrder The name of one or more database resources to use in the search process Use the database name specified in the Management Console s Database Resources tool You can specify multiple database resources If you specify more than one database list them in order of preference The order of the databases has an effect when there are close match candidates from different databases The close matches that are returned come from the database that is first in the search list Close matches from
44. s and abbreviations used in addresses and can geocode these addresses successfully Numbers numeric equivalents and ordinals Numbered streets are mapped to the named equivalents Ordinals are also recognized in input addresses Single Line Input Instead of entering each address element in separate fields you may enter the entire address in the AddressLine1 input field For all countries except Japan you can enter addresses in one or more of these single line formats Note Not all formats work may work for every country StreetAddress PostalCode City StreetAddress City PostalCode StreetAddress City StreetAddress City StateProvince PostalCode StreetAddress Locality StreetAddress County City PostalCode StreetAddress PostalCode StreetAddress City City PostalCode StreetAddress Where Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 6 GeocodeAddressGlobal e StreetAddress can be house number and street name in either order with street type immediately before or after the street name e City is the city or town e Locality is the locality name PostalCode is the complete postcode For Brazil Note Not all of these address elements are used in every country Other single line formats may also be acceptable for many countries The matching accuracy for single line input is comparable to that of structured address input The performance of single line input addresses
45. sponse Element Description Geocoder MatchCode Indicates how closely the input address matches the candidate address For more information see Result Codes for International Geocoding on page 31 Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 28 Response Element GeocodeAddressGlobal Description IsCloseMatch Indicates whether or not the address is considered a close match An address is considered close based on the Close match criteria options on the Matching tab Y Yes the address is a close match N No the address is not a close match MultiMatchCount For street address geocoding the number of matching address positions found for the specified address For intersection geocoding the number of matching street intersection positions found for the specified addresses Status Reports the success or failure of the match attempt null Success F Failure Status Code If the geocoder could not process the address this field will show the reason e Internal System Error e No Geocode Found e Insufficient Input Data e Multiple Matches Found e Exception occurred e Unable to initialize Geocoder e No Match Found Status Description If the geocoder could not process the address this field will show a description of the failure Problem explanation Returned when Status Code Internal System Error Geocoding Failed Returned when Status Code No Geocode Found No
46. street level Output The geocoder returns the latitude longitude standardized address and result indicators Result indicators describe how well the geocoder matched the input address to a Known address and assigned a location they also describe the overall status of a match attempt Address Output The address may be identical to the input address if the input address was accurate or it may be a standardized version of the input address or it may be a candidate address when multiple matches are found Table 6 Address Output for Poland Response Element Description AddressLine1 First line of the address AddressLine2 Second line of the address Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 21 GeocodeAddressGlobal Response Element Description ApartmentLabel The type of unit such as apartment suite or lot ApartmentLabel Input The type of unit such as apartment suite or lot as it was input ApartmentNumber Unit number ApartmentNumber nput Unit number as it was input City The municipality name City Input The municipality name as it was input For Japan the municipality subdivision sub city Country The three letter ISO 3166 1 Alpha 3 country code For Poland the country code is POL Addresses for countries that do not have a dedicated geocoding stage return the country code associated with the input address For example Vatican City addresses return VAT in the Co
47. street segments to use in street level geocoding The distance is specified in the units you specify in the OffsetUnits option The default value varies by country For most countries the default is 7 meters The offset distance is used in street level geocoding to prevent the geocode from being in the middle of a street It compensates for the fact that street level geocoding returns a latitude and longitude point in the center of the street where the address is located Since the building represented by an address is not on the street itself you do not want the geocode for an address to be a point on the street Instead you want the geocode to represent the location of the building which sits next to the street For example an offset of 50 feet means that the geocode will represent a point 50 feet back from the center of the street The distance is calculated perpendicular to the portion of the street segment for the address Offset is also used to prevent addresses across the street from each other from being given the same point The following diagram shows an offset point in relation to the original point Offset Poa _Original Point Street coordinates are accurate to 1 10 000 of a degree and interpolated points are accurate to the millionths of a degree Option OffsetFromCorner Specifies the distance to offset the street end points in street level matching The distance is specified in the units you specify in the Offse
48. t suffix does not match the data suffix Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 10 GeocodeAddressGlobal Specifying Unit Information in an Address When you use the G NAF database the geocoder recognizes several formats of unit types such as unit suite floor and flat address prefix in an address as illustrated below e Unit 5 6 Macleay Street Full unit description used in conjunction with unit value and address number U 5 6 Macleay Street Abbreviated unit description used in conjunction with unit value and address number 5 6 Macleay Street No Unit abbreviation with unit number and address number separated by a forward slash notation Exact matches on unit and address are placed first in the list of returned candidates Specifying Level Information in an Address If you use the G NAF database the geocoder can return level information for some addresses Level information identifies the floor or level of a multi storey building The G NAF database includes level information for some states Level information may be associated with unit information but not necessarily If the G NAF database contains multiple records with the same level the level information is returned only if the input address contains unique content such as a unit number If the G NAF database has level information for an address the geocoder returns that information with the matched candidate The correct level
49. tUnits option This value is used to prevent addresses at street corners from being given the same geocode as the intersection Note Offset is not supported for the United Kingdom GBR or Japan JPN The default value varies by country e 12 meters Australia AUS Austria AUT Germany DEU Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 13 GeocodeAddressGlobal Parameter Description 7 meters For other supported countries the default offset is 7 meters The following diagram compares the end points of a street to offset end points SOS 30 Street Segment End With Corner Offset Street Segment End Option OffsetUnits Specifies the unit of measurement for the street offset and corner offset options One of the following Feet e Miles e Meters Kilometers The default is Meters Option CoordinateSystem A coordinate system is a reference system for the unique location of a point in space Cartesian planar and Geodetic geographical coordinates are examples of reference systems based on Euclidean geometry Spectrum Technology Platform supports systems recognized by the European Petroleum Survey Group EPSG Each country supports different coordinate systems Depending on the country you have one or more of the following options EPSG 4326 Also known as the WGS84 coordinate system EPSG 27200 Also known as the NZGD49 coordinate system Spe
50. tes are returned from both the standard database is preferred Default The results from a custom database have a U at the end of the result code Results from an address database have an A at the end of the match score For example S5HPNTSCZA is a match score that comes from an address database while S5HPNTSCZU comes from a custom database For more information see Result Codes for International Geocoding on page 31 The name of one or more database resources to use in the search process Use the database name specified in the Management Console s Database Resources tool Geocoding Guide for Poland REST 20 Spectrum Technology Platform 10 0 SP1 GeocodeAddressGlobal Parameter Description You can specify multiple database resources If you specify more than one database list them in order of preference The order of the databases has an effect when there are close match candidates from different databases The close matches that are returned come from the database that is first in the search list Close matches from lower ranked databases are demoted to non close matches You can also use the order of the databases to perform fallback processing if you have an both an address point database and a street level database installed for the country List the address point database first and the street database second If the address cannot be geocoded to the address point level the geocoder will attempt to geocode it to the
51. tions Geocoding Options Table 14 Geocoding Options for Poland Parameter Description Option SearchDistance The radius from the input coordinates in which to search for an address Street segments and points within the radius are considered The default search radius is 150 meters and the maximum search radius is 1600 meters Option Units The units in which the search distance is specified One of the following Feet e Miles e Meters e Kilometers Option OffsetFromStreet Indicates the offset distance from the street segments to use in street level geocoding The distance is specified in the units you specify in the OffsetUnits option The default value varies by country For most countries the default is 7 meters The offset distance is used in street level geocoding to prevent the geocode from being in the middle of a street It compensates for the fact that street level geocoding returns a latitude and longitude point in the center of the street where the address is located Since the building represented by an address is not on the street itself you do not want the geocode for an address to be a point on the street Instead you want the geocode to represent the location of the building which sits next to the street For example an offset of 50 feet means that the geocode will represent a point 50 feet back from the center of the street The distance is calculated perpendicular to the portion of the street segment for t
52. ult Codes for International Geocoding Table 21 Reverse Geocoding R Result Codes Reverse Geocoding Code Description RS8A Point parcel level precision for reverse geocoding Candidate returned from address dictionary RS5A Interpolated street candidate for reverse geocoding Candidate returned from address dictionary RS4A Street centroid candidate for reverse geocoding Candidate returned from address dictionary If the reverse geocoded candidate comes from a user dictionary the letter U is appended to the result For example RS8U indicates a point parcel level reverse geocode match from a custom user dictionary Non match Codes The following result codes indicate no match was made N No close match NX No close match for street intersections e ND Spectrum Technology Platform could not find the geocoding database for the given postal code or municipality state province eee Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 51 Notices Copyright 2015 Pitney Bowes Software Inc All rights reserved MapInfo and Group 1 Software are trademarks of Pitney Bowes Software Inc All other marks and trademarks are property of their respective holders USPS Notices Pitney Bowes Inc holds a non exclusive license to publish and sell ZIP 4 databases on optical and magnetic media The following trademarks are owned by the United States Postal Service CASS CASS Certifie
53. untry field regardless of whether VAT or ITA Italy was passed as the country code Similarly addresses in Martinique return MTQ rather than FRA in the Country field Country Input The three letter ISO 3166 1 Alpha 3 country code as it was input For Poland the country code is POL Addresses for countries that do not have a dedicated geocoding stage return the country code associated with the input address For example Vatican City addresses return VAT in the Country field regardless of whether VAT or ITA Italy was passed as the country code Similarly addresses in Martinique return MTQ rather than FRA in the Country field Data Country The meaning of county varies by country e POL Poland District poviat The district povia name Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 22 GeocodeAddressGlobal Response Element Description Data Country The county name or equivalent as it was input The meaning of county varies by country e POL Poland District poviat The district povia name FirmName Name of the company or a place name FirmName Input Name of the company or a place name as it was input FormattedInputStreet Input TE SVEetASItWAS MRU Geocoder MatchCode HouseNumber The building number for the matched location HouseNumber Input The building number for the matched location as it was input HouseNumberHigh The highest house number of the range in
54. unty varies for different countries e POL Poland District poviat One of the following Y Yes a candidate must match the county to be considered a close match N No a candidate does not have to match the county to be considered a close match Option MustMatchStateProvince Specifies whether candidates must match the state or province or equivalent to be considered a close match e POL Poland Province voivodship One of the following Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 18 GeocodeAddressGlobal Parameter Description Y Yes a candidate must match the state or province to be considered a close match N No a candidate does not have to match the state or province to be considered a close match Option MustMatchPostalCode Specifies whether candidates must match the postal code to be considered a close match If you do not require exact match on postal codes the geocoder searches a wider area for a match While this results in slower performance the match rate is higher because the request does not need to match exactly when it compares match candidates Y Yes a candidate must match the postal code to be considered a close match N No a candidate does not have to match the postal code to be considered a close match This is a Reverse geocoding option that applies to Greece Russia Ukraine and any Option SortCandidatesUsingLocale q other country that supports dual
55. use number of the range in which the address resides HouseNumberLow The lowest house number of the range in which the address resides HouseNumberParity Indicates if the house number range contains even or odd Spectrum Technology Platform 10 0 SP1 numbers or both E Even 0 Odd Geocoding Guide for Poland REST 42 ReverseGeocodeAddressGlobal Response Element Description B Both Unknown Language For reverse geocoded candidates the two character language code is returned LastLine Complete last address line city state province and postal code LeadingDirectional Street directional that precedes the street name For example the N in 138 N Main Street Data Locality The meaning of locality varies by country Generally a locality is a village in rural areas or it may be a suburb in urban areas When used a locality typically appears on the lastline of the address with the postcode POL Poland Not used NumberOfCandidateRanges Indicates the number of ranges of which the candidate is a member A candidate may be a part of multiple ranges if the candidate is a street instead of a building NumberOfRangeUnits Indicates the number of units included in the range A unit is an address within a building such as an apartment or office suite PostalCode The postcode for the address The format of the postcode varies by country Postcode data is not available for every country Postal
56. which the address resides HouseNumberLow The lowest house number of the range in which the address resides HouseNumberParity Indicates if the house number range contains even or odd numbers or both E Even Oo Odd B Both U Unknown The second street in an intersection address as it was input IntersectionStreet2 Input Spectrum Technology Platform 10 0 SP1 Geocoding Guide for Poland REST 23 Response Element IsCloseMatch Language LastLine Latitude LeadingDirectional LeadingDirectional Input GeocodeAddressGlobal Description Indicates whether candidate is a close match For reverse geocoded candidates the two character language code is returned Complete last address line city state province and postal code Latitude of the candidate Street directional that precedes the street name For example the N in 138 N Main Street Street directional that precedes the street name as it was input Data Locality Data Locality The meaning of locality varies by country Generally a locality is a village in rural areas or it may be a suburb in urban areas When used a locality typically appears on the lastline of the address with the postcode e POL Poland Not used The locality as it was input e POL Poland Not used LocationPrecistion Longitude Longitude of the candidate NumberOfCandidateRanges Indicates the number of ranges of which the candidate is a member A c
Download Pdf Manuals
Related Search