MapMarker NZL 4.5 Server Release Notes Data

Transcription

1 MapMarker NZL 4.5 Server Release Notes Data Asia Pacific/Australia: Phone: Fax: Technical Support: pbinsight.com.au These Release Notes accompany the MapMarker NZL Geocoder. This geocoder component is integrated with Spectrum Technology Platform. This updated geocoder from Pitney Bowes Software is part of our international family of geocoders. These Release Notes provide information on the basic features and behavior of the MapMarker New Zealand geocoder. These should be used in conjunction with related product documentation. See Address Dictionary on page 2 for the current data vintage information. United States: Phone: Fax: Sales: Government Sales: Technical Support: Technical Support Fax: pbinsight.com Canada: Phone: Fax: Sales: Technical Support: Technical Support Fax: pbinsight.ca Europe/United Kingdom: Phone: Fax: Technical Support: pbinsight.co.uk In these release notes: MapMarker Features New Features and Enhancements Address Dictionary Data Source and Coverage Street Level Geocoding Postal Geocoding Geographic Geocoding Reverse Geocoding Fixes to Customer Reported Issues Pitney Bowes Software Inc. All rights reserved. MapInfo, Group 1 Software, and MapMarker are trademarks of Pitney Bowes Software Inc. All other marks and trademarks are property of their respective holders. January 2013

2 MapMarker Features MapMarker NZL provides a broad range of address location and geocoding features. See the New Zealand Post web site for information about the New Zealand postal system. This includes a link to the Address and Postcode Finder. MapMarker NZL includes the following capabilities. A standard street/segment Address Dictionary and a parcel/point Address Dictionary with rooftop precision for each unique street address. These dictionaries are is based on the Critchlow Ltd. data source, which includes data licensed by Land Information New Zealand. Street level geocoding. Handles single-line, double-line, and multiline address input. Intersection geocoding. Locality aliasing is supported. Unique Identifier (UFI) is returned for street geocoded candidates Supports Standard, Relaxed, Exact, and Custom Match Modes to provide a simple way of setting match restrictions (constraints). A variety of street types, numbered street names, common words, and abbreviations are handled by the geocoder. Postal level geocoding. Geographic level geocoding. Reverse geocoding returns the address for the given X/Y coordinates. After successful geocoding, MapMarker NZL v4.5 returns matching candidates with standardised address fields, latitude/ longitude, result codes that indicate the category and precision of match, and additional information. The returned address may be a standardised version of the input address or an alternative candidate address if the input address was inaccurate or incomplete. The following sections more fully describe the MapMarker NZL v4.5 features and capabilities. Address Dictionary Street Level Geocoding Postal Geocoding Geographic Geocoding Reverse Geocoding New Features and Enhancements The MapMarker NZL v update is primarily a data refresh. See Data Source and Coverage on page 3. The one significant software enhancement for MapMarker NZL v4.5 is Improved Reverse Geocoding Results. Improved Reverse Geocoding Results Reverse geocoded candidates now return the exact latitude / longitude coordinates of the candidate, not just the input coordinates. Along with this, the coordinate system (EPSG code) and the location precision value (a numeric value of 1, 2, or 16) are also returned for reverse geocoded candidates. Address Dictionary The MapMarker NZL street range (segment) address dictionary is used to match your address records and to assign coordinate values to your input addresses. MapMarker NZL also includes a point level address dictionary with approximately 2 million discrete address points derived from many official sources. MapMarker NZL v4.5 Release Notes 2

3 Both the street range and point address dictionaries for MapMarker NZL v4.5 have a vintage of November 2012 ( ). See Data Source and Coverage on page 3 for more details. Data Source and Coverage The MapMarker New Zealand data is based on the Critchlow Ltd. data source, vintage November 2012 ( ). This data source provides full national coverage for publicly accessible roads. The street range dictionary contains street name, town, municipality, and postcode information. It also contains suburb, alias, and house number information. The point address dictionary covers more than 2 million discrete address points. Together, the street range and point address dictionaries provide the most complete and accurate address and location data sources for New Zealand. The s Data Coverage table summarises the scope of MapMarker NZL coverage. s Data Coverage Feature Coverage Discrete address points (Point address dictionary). Roads with Address Ranges spanning the 30 largest urban metro areas. Roads commonly used for addressing (excludes forestry roads, accessways walking tracks etc.) 2,114,341 22,895 km. Together with Discrete address points, approximately 80% of the population is covered in urban areas. 105,028 km Data Sources used for Critchlow Address data include the latest available datasets from Land Information New Zealand (LINZ) and New Zealand Post as well as all territorial authorities (City and District Councils). The responsibility for allocating road names and property numbers within New Zealand rests with territorial authorities. These territorial authorities can also change a road name or property number. Whenever a council allocates or changes a road name or property number, they are required to advise LINZ. Critchlow Ltd. maintains their address data based on these authoritative sources. Street Level Geocoding MapMarker New Zealand performs street level geocoding based on the following input address components: street name, town, suburb, and postcode. Street geocoding is possible with street name and postcode only. The geocoder returns a result code for every returned candidate. The code represents the success or failure of the geocoding operation and conveys information about the quality of the match. Each character of the code provides information on how precisely the geocoder matched each address component. Result Codes Returned Geocoded records return an alphanumeric result code showing the category and precision of match. Result codes are returned in Additional Fields. For example, the returned XML for a candidate displays the result code as follows: <KeyValuePair> <Key>RESULT_CODE</Key> <Value>S5HPNTSCZA</Value> </KeyValuePair> MapMarker NZL v4.5 Release Notes 3

4 For street level geocoding, the S result code indicates the type of match found. The first two characters of the S result code indicate the type of match found as shown in the table of S Result Codes Match Precision. For Postal geocoding, Z result codes are returned. See Postal Geocoding on page 10. For Geographic geocoding, G result codes are returned. See Geographic Geocoding on page 10. For Reverse geocoding, R result codes are returned. See Reverse Geocoding on page 11. S Result Codes Match Precision Result Geocoding Precision S8 S5 S4 SX Indicates point/parcel level precision (highest accuracy available). S8 candidates come from the Point Address Dictionary. Candidate located at interpolated street address. Candidate located at the street segment centroid. S4 candidates come from the Street Range (Segment) Address Dictionary. Candidate is located at street intersection. SX candidates come from the Street Range (Segment) Address Dictionary. S4 and S5 geocode results are followed by additional characters, indicating details of the match precision. These characters appear in the following order, immediately after the S#. S Result Codes Matching Details Character Description H P N T S C Z A U Exact match on house number. Street prefix direction. Exact match on street name. Exact match on street type. Street Suffix direction. Exact match on town name. Exact match on postcode. Address is returned from the Address Dictionary. Address is returned from the User Dictionary. If any of the fields do not have an exact match, then its position is replaced with a dash. UFI and Meshblock Returned Depending on the type of returned candidate, MapMarker NZL can return the Meshblock number and Unique Identifier (UFI). MapMarker NZL v4.5 Release Notes 4

5 Candidate Result Code Returns Segment Candidates (S7, S5, S4, RS5, RS4). See Reverse Geocoding for information on the R result codes. Point Candidates (S8, RS8) Meshblock and UFI Meshblock and UFI These codes are returned in Additional Fields. For example, the returned XML for a segment candidate includes the Unique Identifier (UFI) and Meshblock ID number as follows: <KeyValuePair> <Key>KEY_UFI</Key> <Value> </Value> </KeyValuePair> <KeyValuePair> <Key>NZL_MESHBLOCK_ID</Key> <Value>MB </Value> </KeyValuePair> Note that the for MapMarker NZL v4.5, the Segment ID is identical to the Unique Identifier (UFI). Multiline Address Input The Address Input Fields table describes the input fields for MapMarker New Zealand. Address Input Fields Input Field Description MainAddress AddressNumber: AreaName1 AreaName3 AreaName4 Postcode: Street Address House Number Region Town Suburb (Town can be entered in AreaName4) Postal Code (four-digit) Input example: Following is a typical input address with MainAddress, Postcode, and Suburb. This example also shows how unit type (such as flat) and unit value (such as flat number) are handled. MainAddress: Flat 2/31 Kings Road Postcode: 1041 Suburb: Mount Roskill Returned candidate: The following candidate is returned. AddressNumber: 31 MainAddress: KINGS PostThoroughfareType: ROAD unittype: FLAT unitvalue: 2 Postcode: 1041 AreaName1 (region): Auckland AreaName3 (town): Auckland AreaName4 (suburb): Mount Roskill MapMarker NZL v4.5 Release Notes 5

6 country: NZL Result Code: S8HPNTS-ZA UFI: Meshblock: MB X: Y: Input example with town and swapped: If town is entered in the suburb input area, the geocoder will still return the correct candidate. It this example, the town Glenorchy is entered in the suburb (AreaName4) input area. MainAddress: 314 Routeburn Road Postcode: 9372 Suburb: Glenorchy Returned candidate: The following close match candidate is returned. The town of Glenorchy is returned in AreaName3 and the suburb Kinloch is returned in AreaName4. AddressNumber: 314 MainAddress: ROUTEBURN PostThoroughfareType: ROAD Postcode: 9372 AreaName1 (region): Glenorchy AreaName3 (town): Glenorchy AreaName4 (suburb): Kinloch country: NZL Result Code: S8HPNTSCZA UFI: Meshblock: MB X: Y: Similarly, the same close match candidate is returned if the suburb is entered in the town input area. However, in that case the result code is S8HPNTS ZA with a dash in position 8 indicating that the town name was not exactly matched. Single-Line Address Input Single-line address input is supported. You can enter addresses in a number of single-line formats, such as the following. Other variations are also accepted. StreetAddress;Town StreetAddress;Postcode] StreetAddress;Town;Postcode StreetAddress;Postcode;Town Postcode; StreetAddress Postcode; Town; StreetAddress Town, Postcode, StreetAddress Postcode; Town where: StreetAddress can be Street Name and House Number (with Street Type immediately before or after the Street Name) Postcode is the complete postcode, and Town is the city or town (AreaName3). Fields may be separated with commas, spaces, semicolons, or colons. These delimiters do not affect geocoding. The matching accuracy for single-line addresses is comparable to that of formatted (structured) address input. The performance of unformatted address input may be slower than that of structured address input. Input example: The following single-line input example includes the street address and postcode. 56 NAMATA ROAD;ONE TREE HILL;AUCKLAND;2001 MapMarker NZL v4.5 Release Notes 6

7 Returned candidate: A close match candidate (S8 result) is returned. MainAddress: NAMATA AddressNumber: 56 Postcode: 1061 PostThoroughfareType: ROAD AreaName1 (region): Auckland AreaName3 (town): Auckland AreaName4 (suburb): One Tree Hill country: NZL Result Code: S8HPNTSCZA UFI: Meshblock: MB X: Y: Intersection Geocoding Intersection geocoding is supported. Use && as the delimiter to designate street intersections: Street 1 && Street2 Input example: The following example illustrates multiline input, but single-line input can also be used. Note that the suburb (AreaName4) of Mount Roskill has been input as the town (AreaName3) but the correct close match candidate is still returned. MainAddress: Admiral Beatty Av && Hardley Av Town: Mount Roskill Returned candidate: Any of these input examples returns a close match candidate with an SX result code: MainAddress: ADMIRAL BEATTY AVENUE && HARDLEY AVENUE Postcode: 1041 AreaName1: Auckland AreaName3: Auckland AreaName4: Mount Roskill country: NZL Result Code: SX X: Y: Postal and Geographic Fallback You can use Postal geocoding or Geographic geocoding as fallback options if a Street geocoding operation fails to return close match candidates. See Postal Geocoding on page 10 and Geographic Geocoding on page 10. Aliases for Suburbs MapMarker NZL supports locally used suburb names in addition to the officially recognised suburb names. Input example: The following input uses the alias of Rosedale instead of the official suburb name of Hargest. MainAddress: 212 Ward Street Postcode: 9810 Suburb: Rosedale Returned candidate: The following candidate is returned. The official suburb name (Hargest) is returned in Areaname4 and the alias (Rosedale) is returned in an Additional Field. MainAddress: WARD AddressNumber: 212 postthoroughfaretype: STREET unitvalue: SS MapMarker NZL v4.5 Release Notes 7

8 Postcode: 9810 AreaName1 (Region): Invercargill AreaName3 (Town): Invercargill AreaName4 (Suburb): Hargest Aliased_Suburb: Rosedale country: NZL Result Code: S8HPNTS-ZA UFI: Meshblock: MB X: Y: MapMarker NZL v4.5 also returns Rural Delivery (RD) route information in the suburb field. This improvement was introduced with the previous data refresh. For example, the address: 29A GORDONS ROAD RD 1 Waiheke Island Auckland 1971 returns RD 1 is in the suburb name field, representing Rural Delivery 1. Thoroughfare Types New Zealand Thoroughfare types and their common abbreviations are recognised and fully supported on input and output. Common Words and Abbreviations in Addresses MapMarker NZL v4.5 recognises common words, directionals, house number indicators, 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 recognised in input addresses. Match Modes MapMarker New Zealand includes several Match Modes that allow you to easily control the level of matching precision. You can select Standard, Exact, or Relaxed, or Custom Match Modes. Less variance (Exact Mode or Standard Mode) provides the highest quality matches. More variance (Relaxed Mode) can return matches on badly formatted or incomplete input addresses, but requires additional processing time. You can also select Custom Mode to require exact matching based on exact match (Must Match) constraints. See Custom Match Mode Constraints on page 9. MapMarker NZL v4.5 Release Notes 8

9 The Match Modes table describes the Standard, Exact, and Relaxed Match Modes. Match Modes Mode Standard Mode Exact Mode Relaxed Mode Custom Mode Description This is the default geocoding mode for the New Zealand v4.5 geocoder. For MapMarker NZL, this is equivalent to Must Match Street, House Number, and Country. This provides strict matching rules. In general, this will return fewer close matches than would be returned in Standard mode. This provides less strict matching rules. None of the Must Match constraints are enforced. Relaxed Mode also allows for minor misspellings in street addresses, suburb, or town names. Corrections can be made in the returned candidates. In general Relaxed Mode will return more matches than would be returned in Exact mode. This allows you to individually apply Must Match criteria. These Custom constraints are described in the table of Custom Constraints. Custom Match Mode Constraints Custom Match Mode allows you to select exact match (Must Match) constraints. Custom Constraints Custom Constraint Must Match Street Must Match House No. Must Match Post Code Must Match Town Description If selected, a candidate must match the street name for it to be considered a close match. By default, street name must be matched. If selected, a candidate must match thehouse number for it to be considered a close match. By default, house number must be matched. If selected, a candidate must match the postcode for it to be considered a close match. If selected, a candidate must match the town (areaname3) for it to be considered a close match. Matching Options You can control several options that determine the type and number of candidates returned and the information that is returned with the candidates. Close Matches Only You can specify whether to return only those matches that are considered close. The close match criteria can be controlled by selecting Match Modes or Custom Match Mode Constraints. If you do not specify Close Matches only, additional candidates may be returned as non-close matches. Maximum Number of Candidates You can specify the maximum number of candidates to be returned. Close matches will be returned at the top of the list, followed by non-close matches (if you allow non-close matches). MapMarker NZL v4.5 Release Notes 9

10 Maximum Number of Ranges You can specify the maximum number or address ranges to be returned for each candidate. Maximum Number of Range Units You can specify the maximum number of candidate range units to be returned per candidate range. Postal Geocoding New Zealand uses a four-digit postal code. The first digit represents the geographic region. The second and third digits represent the postal sort area. The last digit represents a specific urban area, rural delivery or PO box lobby. If the input address contains a postcode, you can geocode your records based on the postcode and return a postal centroid. Matches in the Z category indicate that a postal match was made. This could be because a street level match was not possible and you allowed the geocoder to fall back to Postal Code, or because you chose to geocode the postal level. The New Zealand Post web site includes an Address and Postcode Finder. Postal Geocoding Result Codes Result Z1 Match to four-digit Postcode centroid. Geocoding Precision Input example: Following is a typical input postcode. Postcode: 9679 Returned candidate: Postal geocoding produces a close match Z1 candidate with postal information and X/Y coordinates. No AreaName information is returned for postal geocoding or postal fallback. Postcode: 9679 Result Code: Z1 X: Y: Geographic Geocoding If the input address contains of a valid combination of town, suburb, and state with no further address information, you can geocode to the city or suburb centroid. Matches in the G category indicate that a match was made at the geographic (town or suburb) level. This could be because street level match was not possible and you allowed the geocoder to fall back to Geographic Area, or because and you chose to geocode to geographic area (Geographic Geocode). Geographic Geocoding Result Codes Result G4 Geocoding Precision areaname4 (suburb) locality/minor town centroid match. Input example: For example, you can geocode the suburb of Wanganui. Suburb: Wanganui MapMarker NZL v4.5 Release Notes 10

11 Returned candidate: Geographic geocoding (or geographic fallback) returns a close match G3 candidate. AreaName1: Wanganui AreaName3: Wanganui AreaName3: College Estate Result Code: G4 X: Y: Reverse Geocoding MapMarker NZL v4.5 provides reverse geocoding. If you provide X/Y (Longitude/Latitude) coordinates, MapMarker New Zealand returns the closest address for the given X/Y location based on the available Address Dictionaries. Reverse geocoding includes the geographic fallback option. S Result Codes Match Precision Result Geocoding Precision RS8A RS5A RS4A Indicates point/parcel level precision (highest accuracy available). RS8A candidates come from the Point Address Dictionary. Candidate located at interpolated street address. Candidate located at the street centroid. Input example: The following example specifies the X and Y coordinates. X: Y: Returned candidate: This returns a candidate with an RS8A result code. MainAddress: BURBANK AddressNumber: 58 Postcode: 2102 postthoroughfaretype: Avenue AreaName1: Auckland AreaName3: Manurewa AreaName4: Manurewa Result Code: RS8A UFI: Meshblock: MB Fixes to Customer Reported Issues Single line intersection address with geographic fallback causes exception. I If geographic fallback is enabled, single line intersection addresses fails with an exception error. For example, an input address of CORNER Lincoln Road & Clarence Street Christchurch 8002 throws an exception if geographic fallback is turned on. MapMarker NZL v4.5 Release Notes 11