MapMarker Plus 13.1 Release Notes

Transcription

1 MapMarker Plus 13.1 Release Notes These Release Notes accompany the MapMarker Plus 13.1 release. This provides information on new features, behavioral changes in the software, fixes for customer-reported issues, and known issues that may require your attention. This document should be used in conjunction with the MapMarker 13 User Guide and Developer Guide. All of these documents are available at: Corporate Headquarters: Phone: Fax: Sales: Government Sales: Technical Support: Pitney Bowes MapInfo Corporation. All rights reserved. MapInfo and the MapInfo logo are trademarks of Pitney Bowes MapInfo Corporation and/ or its affiliates. October 2007 Table of Contents New Features Operating Requirements Changes with MapMarker Plus Fixes to Customer-Reported Issues Known Issues and Clarifications

2 New Features MapMarker Plus 13.1 is a data release and includes a new Address Dictionary (October 2007data vintage) as described in the Address Dictionary Update section. Following is a summary of the new software features that were introduced with the MapMarker Plus 13.0 software release. Single line address geocoding. MapMarker can now geocode input addresses in which address components are entered on a single line. For example: "1 Global View, Troy, NY". This is described in chapter 3 of the MapMarker 13 User Guide in the topic "Using Single Line Addresses in Geocoding". Address range geocoding: Some business locations are identified by address ranges. For example, a shopping plaza could be addressed as Front St. MapMarker now can geocode these types of address ranges. This is described in chapter 3 of the MapMarker 13 User Guide in the topic Address Range Geocoding. Geographic geocoding (city, county, state): If the input address consists of a valid combination of city, county, and state (but no further address information), you can still geocode to the city, county, or state centroid. This is described in chapter 3 of the MapMarker 13 User Guide in the topic Geographic Geocoding. Geographic Fallback Preferences: If MapMarker cannot match a record to the level or precision you have requested (such as street level), it can now fallback to City, County, or State. These new preferences are described in chapter 3 of the MapMarker 13 User Guide in the topic "Fallback Preferences". Prefer Matching ZIP Code over Matching City: When multiple close matches are generated, MapMarker selects the City close match over the ZIP Code close match by default. But you can use a new preference to accept a close match on postal code in preference to a close match on city, This is described in chapter 3 of the MapMarker 13 User Guide in the topic "Multiple Match Preferences". Report DPV expiration date (new API method): The MapMarker Java API has a new method that can be used to report the DPV expiration date. This is described in the MapMarker 13 Developer Guide in the topic Determining DPV Availability. In the Desktop Application, the select Help > About to see the DPV expiration date. Reduced Memory Usage Option: You can choose to run MapMarker with a smaller memory footprint. This is described in the MapMarker 13 Developer Guide in the topic: Configuring MapMarker for Reduced Memory Usage. Quick Initialization Option: You can configure MapMarker to startup more quickly. Faster startup may be important if you typically use MapMarker to geocode single addresses rather than geocoding a large number of addresses. This is described in the MapMarker 13 Developer Guide in the topic: Configuring MapMarker for Quick Startup. Additional information in Help About box: The Help About dialog box displays complete MapMarker version information, including the data vintage. Address Dictionary Update The MapMarker Plus 13.1 Address Dictionary has been updated with the data generated from the following sources: Address data from the USPS ZIP + 4 database (vintage October 2007) Street geometry from Tele-Atlas, Inc. Dynamap 2000 Street Network Files (vintage October 2007) ZIP + 4 Centroids from Tele Atlas, Inc. Dynamap /ZIP + 4 Centroids (vintage October 2007, USPS currentness For MapMarker Plus 13.1, the total size of the Address Dictionary files for all states plus Puerto Rico Is approximately 3.29 GB. The Address Dictionary is updated quarterly to comply with USPS CASS standardization requirements. The CASS expiration date for MapMarker Plus 13.1 is January 28, MapMarker Plus 13.1 Release Notes 2

3 Operating Requirements This section describes the software and hardware requirements for running MapMarker Plus Operating Systems MapMarker runs on the following operating systems: Java API Windows 2000 Advanced Server with SP4 Windows XP Professional with SP2 Windows 2003 Enterprise Edition Windows Vista Ultimate Edition Solaris 2.9, 2.10 HP-UX 11.0 Red Hat Linux kernel version 2.6 SUSE Linux 9x C API Windows 2000 with SP 4 Windows XP Professional with SP2 Windows 2003 Enterprise Edition Solaris 2.9, 2.10 HP-UX 11.0 Desktop Application Windows 2000 with SP4 Windows XP Professional with SP2 Windows 2003 Enterprise Edition Windows Vista Ultimate Edition Java Virtual Machine MapMarker requires a Java Virtual Machine (JVM) to run. The following JVMs are supported: JVM v or 1.5 MapMarker Plus 13.1 ships with: Sun JRE v _09 (for Microsoft Windows and Sun Solaris) HP JRE _04 (for HP-UX) Sun JRE 1.5.0_11 (for Linux) During the installation, you do not have the option of installing the JVM that ships with MapMarker or using one that you already have installed on your computer. Under high loads, MapMarker server may experience performance degradation with JVM v _04 or earlier. For this reason, we recommend that you use JVM 1.5.0_05 or later when high server performance is required. MapMarker Plus 13.1 Release Notes 3

4 Database Support Microsoft Data Access Components 2.8 is required to use MapMarker with a SQL database. This component is installed automatically when you install the MapMarker Desktop Application, either on a standalone workstation or on a client machine. The MapMarker Desktop Application installer and the client setup program both install the Jet 4.0 database engine for use with Microsoft Access. The Jet 4.0 package and the MDAC 2.8 installer together install a number of ODBC drivers for use with MapMarker. The following ODBC databases and drivers are supported. In some cases, you must download and install the appropriate driver that suits your needs. SQL Server 2005 SQL Server 2000 Microsoft Access 2007 (Link to download: driver for Microsoft Access 2007) Microsoft Access 2000 MapMarker also supports the following Oracle drivers: Oracle 10G Release 1and 2 Oracle 9i Release 2 You must install the Oracle driver separately. To use the driver, you must have the Oracle 9i client installed. Supported Web Servers The following Web servers are supported: Apache Tomcat 5.5 Oracle 10G Application Server BEA WebLogic 9.1 IBM WebSphere 6.0 Supported MapInfo Products MapMarker Plus 13.1 can integrate with the following MapInfo products: MapInfo Professional MapInfo AnySite (USA) MapInfo Target Pro (USA) MapMarker Canada Envinsa MapMarker Geocoding Extender for Oracle MapMarker Geocoding Extender for SQL Server Note You cannot install the same major version of MapMarker Plus USA and the standard version of MapMarker on the same workstation. However, you could install different major versions of MapMarker Plus and standard. For example, MapMarker 12 standard version could co-exist with MapMarker Plus 13. Minimum Hardware and Memory Requirements The minimum system requirements for MapMarker on a full installation of the Desktop Application and Developer Product (SDK) are: 800 Mhz Pentium processor or equivalent 256 MB RAM 5 GB available disk space (including 4GB for entire U.S. Address Dictionary) More specifically, the disk space requirements are as follows: MapMarker Plus 13.1 Release Notes 4

5 0.5 GB for DPV data (available with MapMarker Plus) 25 MB for the MapMarker software (100 MB if installed on a shared installation client since the JRE must also be installed) 100 MB for the JRE 20 MB for Tomcat web server 13 MB for the MapMarker SDK (with the Developer Product) Recommended Hardware and Memory Requirements For optimal performance of a full installation of both the Desktop Application and Developer Product (SDK) we recommend: 2.5 Ghz processor 1 GB RAM 10 GB available disk space Changes with MapMarker Plus 13.1 You may notice the following changes in MapMarker Plus 13.1 compared to earlier versions of the product. Integrating MapMarker USA and MapMarker Canada In MapMarker Plus 13.1, the MapMarker Server (mm_serve.exe) and MapMarker Geocoder Control (mapmarkr.ocx) are now installed in C:\Program Files\Common Files\MapInfo\MMOCX. This means that you no longer need to perform any manual configuration steps to integrate MapMarker USA and MapMarker Canada. Uninstalling MapMarker To properly uninstall MapMarker, you must run the Uninstaller. If you do not run the Uninstaller, but instead delete the MapMarker directories, the MapMarker product will not properly uninstall and you will not be able to routinely re-install the product. To uninstall MapMarker on Windows, always use the Add or Remove Program tool. On non-windows environments, always run the uninstall application provided on the product media. This is described in the topic Uninstalling MapMarker in the User Guide. Note If you simply delete directories, this action also deletes the Uninstaller application itself, so you will not be able to recover easily. If you did delete MapMarker directories and need to re-install the same version of the product, call Technical Support to help resolve this issue. See the topic Getting Technical Support in the Introduction chapter of your MapMarker User Guide or Developer Guide. CASS Report Generation Requires DPV DPV confirmation is required for CASS reports. If you choose Produce a CASS Report in CASS geocoding preferences, the Use DPV mode check box is automatically checked. Enhanced ZIP + 4 and DPV Requirement If you are using DPV mode, and the address does not DPV confirm (with Y, S, or D confirmation code), then the USPS requires us to return ZIP Code and carrier route only for mailing-related information. That is, MapMarker does not return the Delivery Point, Check Digit, RecordType, or DefaultFlag. MapMarker Plus 13.1 Release Notes 5

6 DPV Expiration If DPV expired on your system, MapMarker still functions normally except that you cannot use DPV and cannot create a CASS report. However, you can still geocode with CASS rules. This has been clarified in the DPV Data Expiration topic of the Desktop User Guide. You can also see the DPV expiration date when you select Help > About in the MapMarker Desktop Application. Exact Match Requirement More Strictly Enforced This behavioral change was made in response to Incident Number T23116 from the Pitney Bowes MapInfo incident tracking database. MapMarker Plus 13.1 now considers the street type as part of the Exact Match criteria. So if you require an Exact Match on Street Name and attempt to geocode the following address: 1 Global Rd, Troy NY you do not receive any close match candidates, because the input address has the wrong street type (Rd instead of Vw). This change in behavior is more consistent with the commonly understood interpretation of "exact match". MapMarker 12.x would correct the wrong street type and return an Exact Match candidate. That behavior was confusing since it did not meet the expected definition of "exact". If you do want MapMarker to return more candidates, you can relax the match restrictions or use CASS mode to correct the address. Intersection Geocoding If your data contains intersections separated by a single ampersand (&, or the word "And", you may receive unexpected results. To avoid this problem, do not include ampersands or the word "And" in your input data. Fixes to Customer-Reported Issues Pitney Bowes MapInfo has worked to address problems and bugs that have been reported by customers. Following is a list of customer-reported incidents that have been addressed in MapMarker Plus The leading 'T' numbers are the Incident Numbers that Pitney Bowes MapInfo uses to track these customer issues. In some cases, the description is a consolidation of several related Incident Numbers. All of these items have been fixed in MapMarker Plus T23981: DPV and LACS Link are not automatically enabled when creating a CASS report. This has been corrected in the Desktop application. When you select CASS report, the DPV and LACS Link check boxes are now automatically selected. Also, when CASS report is selected, the DPV and LACS Link check boxes can not be unchecked. T24036: Batch command line geocoding performs geographic geocoding only, even if the batch script calls for street or postal geocoding. This has been fixed. T23742: On Microsoft Windows Vista, MapMarker crashes when you click the scroll bar after a Quick Find geocode operation. This has been fixed. T24407: Variations in address style (such as E Central Texas EXPY as opposed to E Central TX EXPY) return slightly different Lat/Long coordinates. This has been fixed in the October 2007 data, and the same coordinates are now returned for both address styles. T24408: Close candidate is not returned for address like: 2120 N NC 71 Hwy, Maxton NC. However, the close candidate is returned if Hwy is omitted from the input address. This has been fixed and the close candidate is now returned for these address variations. T24409: A known address, such as 90 Weaver ST, Rocky Mount VA, is not geocoded as expected. This has been fixed in the October 2007 data, and the correct candidate is now returned. T24410: A known address, such as 5600 FM 2410, Killeen TX, returns a bad close match candidate. This has been fixed and faulty close match candidate is no longer returned. MapMarker Plus 13.1 Release Notes 6

7 T31169 (Knowledge Base): In DPV mode, some addresses return a S0 result code and fail to geocode. This is because USPS added a new ZIP Code and the July 2007 data did not include that postal information. This has been fixed in the October 2007 data, and the ZIP Code is now recognized. Known Issues and Clarifications This section provides information and workarounds related to several known issues. This also includes issues specifically related to Windows Vista and UNIX/Linux platforms. Microsoft Windows Vista-Related Issues, p. 7 UNIX / Linux-Related Issues, p. 8 Shared Installation Location of Files, p. 8 Log File for Cancelled or Failed Install, p. 8 Using JVM 1.6 on page 8 MapInfo Streets Plus Shipped with MapMarker Plus, p. 9 S8 Georesult Codes and Address Interpolation, p. 9 Permissions on Geoappl Testing Application, p. 9 Unable to Open Some.TAB Files, p. 9 Locating Support and Contact Information, p. 9 Microsoft Windows Vista-Related Issues You must always have administrator rights on the target machine to install MapMarker. This is true on all operating platforms. Windows Vista imposes some additional restrictions on installing and running MapMarker. This section provides some background on Microsoft Vista security-related issues and gives specific information on installing and running MapMarker on Windows Vista. Windows Vista uses UAC (User Account Control). When UAC is turned off, the Administrator can install MapMarker and run MapMarker programs with no additional requirements. However, when UAC is turned on, you must meet both of the following conditions to install MapMarker, Start the MapMarker Server, or Stop the MapMarker Server. You must be an Administrator, and You must run the application with administrator credentials applied. When an administrator launches the installer (setup.exe), UAC asks the user if they want to allow the program to execute. When the user clicks Allow, administrator credentials are automatically applied for the user while the installation executes. For other programs, such as starting or stopping the MapMarker server or installing the server as a Windows Service, administrator credentials must be explicitly applied. Starting and Stopping the MapMarker Server: To start or stop the server using administrator credentials, right-click the shortcut for the operation that you wish to perform and from the menu that appears, select Run as administrator. If you did not install shortcuts, run the commands as described in the topic Starting the MapMarker Server in Chapter 2 of the MapMarker Version 13.1 Developer Guide from an Administrator Command Prompt. Note To open an Administrator Command Prompt, access the Start Menu and select All Programs > Accessories. Right-click the shortcut titled "Command Prompt" and from the menu that appears, select Run as administrator. The command prompt that opens allows commands to be executed with administrator credentials applied Installing and Removing the MapMarker Server as a Windows Service: To install or remove the server as a Windows Service, first open an Administrator Command Prompt as described in the Note above. From the Command Prompt, run the commands to install or remove the service, as described in the topic Running the Web Application as a Windows Service in Chapter 2 of the MapMarker Version 13.1 Developer Guide. MapMarker Plus 13.1 Release Notes 7

8 Generating reports, log files, and updating tables: CASS reports, log files, and tables (.tab files) must be directed to a writable location. Windows Vista with UAC enabled does not allow users to write to the default Programs folder. If the user cannot write output to the designated directory, the action fails without notification. To solve this problem, create the log file and other output in a location where the user always has write permissions (such as the user s Desktop or Documents Folder). To set the log file in the Desktop Application, specify the full path to to a writable location for the log file on the Log File tab of the Geocode dialog box. See the Log File Preferences topic in Chapter 3 of the MapMarker Version 13.1 User Guide for additional information. As an additional option, the user can right-click on the Desktop Application shortcut and start the application with administrator credentials by selecting Run as administrator. With these credentials applied, the user can then create CASS reports, log files, or tables in the default Programs folder or any other location. Using ODBC Data source: You must have administrator privilege to create a new ODBC data source. The user also must set up their ODBC connections in advance. Shortcut not Removed on Windows Vista: When uninstalling on Windows Vista, the shortcut may not be removed properly. The program files do uninstall properly, but the shortcut may be left behind. UNIX / Linux-Related Issues On UNIX/Linux platforms, there are some installation and startup issues related to administrator rights. Administrator Rights Required for Installation: For UNIX and Linux installations, you must have administrator rights on the target machine to install MapMarker. If you attempt to install on a machine where you do not have administrator rights, you receive an error message. Starting the Tomcat Server: On UNIX/Linux platforms, the Tomcat server must be started and stopped by a user with administrator rights. Reinstall Failure after Improper Uninstall: To properly uninstall MapMarker, you must run the Uninstaller.If you did not run the Uninstaller, but instead deleted the MapMarker directories, you will not be able to routinely re-install the product. For more details, see Uninstalling MapMarker on page 5. Shared Installation Location of Files After the administrator installs the Desktop Application as a Shared application, each client user must then run the client desktop installation (ClientSetup.exe). The client users also must be able to access to the shared data. By default, the data is installed in the folder: MapMarker_USA_v13_Data. Under that folder, the DesktopInstaller folder contains the ClientSetup.exe. After completing the Shared installation, the administrator can share the MapMarker_USA_v13_Data folder (and the subordinate DesktopInstaller folder). Client users then have access to everything that they need to perform a client installation and access shared data. Log File for Cancelled or Failed Install When the installation fails or is cancelled, a log file is created that provides some insight into what happened. This is useful in the silent install scenarios (install, modify, update, or uninstall), because it directs the user to what must be changed. On Microsoft Windows, the log is created on the user's desktop. On UNIX/Linux systems, it is created in the user's home directory or at the root directory ( / ). Using JVM 1.6 Using JVM 1.6, intersection geocoding may, in rare circumstances, fail to return candidates. This incident has been recorded as T MapMarker Plus 13.1 Release Notes 8

9 MapInfo Streets Plus Shipped with MapMarker Plus MapInfo Streets Plus is shipped on separate media and included in your MapMarker Plus product box. This was not clear in the User Guide. S8 Georesult Codes and Address Interpolation It is possible to return an S8 candidate from geocoding when address point interpolation is not turned on. If the candidate is itself an address point, an S8 result code is returned whether address point interpolation is turned on or not. This corrects an issue where geocoding without address point interpolation returned an S5 result code for candidates that were address points. This is the only instance that an S8 result code can be returned without using address point interpolation. A candidate cannot be promoted to S8. Nor can an S7 result be returned, unless you use address point interpolation. Permissions on Geoappl Testing Application The geoappl application is a C-based test program that can geocode a sample input file. This program is included with the Developer SDK and located in the sdk/additional_tools/geoeng/test directory of your MapMarker Plus 13.1 installation. You can run the program as follows: geoappl [infile] [outfile] [mapmarker data path] However, on HP UNIX machines, the geoappl program does not run unless you do both of the following: assign execute permissions to the geoappl program and the libraries located in the sdk/additional_tools/geoeng/lib directory ensure that the user can write to the directory specified for the output file (outfile in the above syntax) Unable to Open Some.TAB Files MapMarker Plus 13.1can not open a.tab file if the.tab file includes the date/time feature. Locating Support and Contact Information The serial number is located on a sheet of stickers in the MapMarker package. You also need the unlocking code to install the MapMarker features and data you purchased. Call (800) option 3, between 8 am and 7 pm, EST, Monday through Friday, and the MapMarker License Authorization desk will provide your unlocking code. Have your product serial number ready when you call. MapMarker Plus 13.1 Release Notes 9