MapMarker UK User Guide - Pitney Bowesreference1.mapinfo.com/.../english/4.0/MM_UK_v4_UserGuide.pdf · User Guide 3 Table of Contents ... Welcome to MapMarker UK v4.5, one of the

MapMarker UKversion 4.5

USER GUIDE

Information in this document is subject to change without notice and does not represent a commitment on the part of the vendor or its representatives. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, without the written permission of Pitney Bowes Software Inc., One Global View, Troy, New York 12180-8399.© 2010 Pitney Bowes Software Inc. All rights reserved. Pitney Bowes Business Insight, MapInfo, Group 1 Software and MapMarker are trademarks of Pitney Bowes Business Insight, a division of Pitney Bowes Software and/or its affiliates. All other marks and trademarks are property of their respective holders.UK and EMEA:Phone: 44 1753 848200Fax: 44 1753 621140 Technical Support: 44 1753 848229 www.mapinfo.co.ukAmericas:Phone: (518) 285-6000Fax: (518) 285-6070Sales: (800) 327-8627Government Sales: (800) 619-2333Technical Support: (518) 285-7283Technical Support Fax: (518) 285-6080www.mapinfo.comAsia Pacific:Phone: 61. 2.9437.6255Fax: 61.2.9439. 1773Technical Support: 1800 648 899www.mapinfo.com.auContact information for all Pitney Bowes Software Inc. offices is located at: http://www.mapinfo.com/contactusAdobe Acrobat® is a registered trademark of Adobe Systems Incorporated in the United States.February 2010

http://www.mapinfo.com

http://www.mapinfo.co.uk

http://www.mapinfo.com.au

http://www.mapinfo.com/contactus

Table of Contents

Chapter 1: Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10What Is Geocoding? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11What Is MapMarker? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

MapMarker Desktop Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11Beyond the Desktop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Understanding the MapMarker UK Address Dictionaries . . . . . . . . . . . . . . . . . . . . . . .12MapMarker UK Address-Point Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12MapMarker UK CodePoint Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

MapMarker Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Updated Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14Street Level Geocoding (Including Address Cleaning) . . . . . . . . . . . . . . . . . . . . . . . . .15Postcode Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15Single Line Address Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Single Close Match Returned with Range Results . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Result Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Developer Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Integration with MapInfo Professional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

MapMarker UK Documentation Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17Getting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Chapter 2: Installing MapMarker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Installation Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20Shared Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21About the Address Dictionary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21

Operating Requirements and Performance Recommendations. . . . . . . . . . . . . . . . . .22Operating Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Hardware and Memory Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22JVM Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Optimizing Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23Installing MapMarker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Install Using the Graphical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23Installing Silently . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

Modifying the MapMarker Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29Modify Using the Graphical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29Modify Silently . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

Upgrading the MapMarker Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30Upgrade Using the Graphical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

User Guide 3

Upgrade Silently. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31Uninstalling MapMarker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31

Uninstall Using the Graphical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31Uninstall Silently. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Client Workstation Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32Starting MapMarker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Starting the Desktop Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33

Chapter 3: Geocoding with MapMarker UK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Geocoding Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35Understanding the Geocoding Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Supported File Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37Geocoding Flexibility and Trade-offs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38Optimizing Geocoding Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39Specify Input Address Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39Specify Output Address Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40

Output Column Type/Width Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Output Field Size and Column Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41Setting Startup Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

Running MapMarker – Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Opening and Running a Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Running a Project from a Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44Opening a Table or Text File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

Defining Properties of Delimited Text Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45Delimited File Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Selecting Input and Output Address Columns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50Selecting Input Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50Selecting Output Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53

Adding a Column. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Geocoding Your Table Automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56Geocoding Your Table Interactively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57Making the Most of Interactive Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

Changing Matching Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60Editing Your Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60

Remote Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Street Address Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60

Formatted Address Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61Unformatted (Single Line) Address Entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65

Postal Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66Postal Geocoding Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67

Displaying Geocoded Records in MapInfo Professional. . . . . . . . . . . . . . . . . . . . . . . .68Re-Geocoding a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69

User Guide 4

Using Geocoding Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69Geocode Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70

Geocode Precision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Street Level Geocoding Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Type of Rows to Geocode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Range to Geocode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Attribution Bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Log File Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72Match Restrictions Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73

Exact Match On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Fallback Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74Multiple Match Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75

Saving TAB Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76Creating and Saving a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76

Creating a Project-Based Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77Multiple Pass Batch Geocoding Strategy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79

Chapter 4: Match Settings and Strategies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Using Match Settings to Control Geocoding Precision. . . . . . . . . . . . . . . . . . . . . . . . .81Choosing Match Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81

Maximizing the Match Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81Maximizing Geographic Accuracy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82Balancing Match Rate and False Positives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82

Picking Your Strategy: An Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82First Pass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83Second Pass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83Third Pass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83 One Pass Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83

Impact of Relaxing Match Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84Relaxing Postcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84Relaxing Town Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84Relaxing Street Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84Relaxing House Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84

A Closer Look at Multiple Matches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85

Chapter 5: Specialized Geocoding Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Geocoding dBASE Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88Geocoding Delimited and CSV Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88Using Quick Geocode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88Geocoding with Quick Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89

Street Geocoding with Quick Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89Expand Ranges as Candidates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Copying Information from the Quick Find Candidate List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

User Guide 5

Unformatted (Single Line) Address Entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91Postal Geocoding with Quick Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93Quick Find Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93

Batch Geocoding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94Creating a Batch Geocoding File from a TAB File . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95Manually Creating a Batch Geocoding File Base on TAB File. . . . . . . . . . . . . . . . . . . .95Manually Creating a Project-Based Batch File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97Batch Geocoding Considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98

Batch File Contents for TAB and Other File Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Running the Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Table Settings and Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Input and Output Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Table Attribution with MapMarker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98Opening the Table for Attribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99Selecting an Attribution Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100Binding Attributes – Output Point Attribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100Binding Attributes – Column Value Attribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

Adding Attributes to Your Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103Adding Attributes By Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103Adding Attributes Using Batch Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103Stopping Attribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104Clearing Attribute File Selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105Tips for Using Attributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Chapter 6: Geocoding Remote Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Supported Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108Remote Tables and Spatial Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

Mappable Tables and the MapInfo Map Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108Supported Spatial Index Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

Preparing to Geocode Remote Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109Creating a Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109Preparing the Remote Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109Creating a Map Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110Making a Remote Table Mappable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110

Accessing a Remote Table for Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110Writing Geocoding Output to Another Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112

Relationship Between Source and Results Tables . . . . . . . . . . . . . . . . . . . . . . . . . . .112Setting Up for Related Table Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113Remote Table-to-Table Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113Optimizing MapMarker for Related Table Geocoding . . . . . . . . . . . . . . . . . . . . . . . . .115Remote Database Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116

Additional Considerations for Remote Table Geocoding . . . . . . . . . . . . . . . . . . . . . .116

User Guide 6

Sort by Postal for Faster Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Geocoding Unmatched Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Transaction Control with ODBC Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Remote Database Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Rollback Segment Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Supported Unique Index and Primary Key Data Types by Database . . . . . . . . . . . . .118

Chapter 7: Result Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119MapMarker UK Result Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

Single Match (S category) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120Multiple Candidates Match (M category) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122Postal Centroid Match (Z category) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123

Appendix A: MapMarker User Interface Reference . . . . . . . . . . . . . . . . . . . . . . 124MapMarker Menu Commands and Toolbar Buttons . . . . . . . . . . . . . . . . . . . . . . . . . .125

About MapMarker command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125Arrange Icons command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126Batch Add Attributes command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126Cascade command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126Choose Font command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126Clear File Selections command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126Close command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126Close Project command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127Create Batch File command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127Create Project-based Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127Create/Save Project command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127Exit command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127Geocode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128Help Topics command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128Logfile command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128Open Browser List command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128Open ODBC Table command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129Open Project command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129Open Table command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129Quick Find command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129Quick Geocode command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130Recent File List command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130Select Attribute Files command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130Select Columns command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130Status Bar command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131Stop Attribution command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131Summary command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

User Guide 7

System Preferences command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131Tile command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131Toolbar command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132

MapMarker Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132About MapMarker dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133Add Columns dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133Automatic Geocode dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134Bind Attribute Table Columns to Output Columns dialog. . . . . . . . . . . . . . . . . . . . . . .135Datum Preferences dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137Describe Table Relationships dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138Dictionary Preferences dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139Fallback dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140Filter Tables dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140Font dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141Geocode dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142Geocoding Summary dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143GeoResult dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144Interactive Geocode dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145Log File dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147Match Restrictions dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148Modify Table Structure dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149Multiple Match dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150Open Project dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151Open Table dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152Quick Find dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153Related Table dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155Save As dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155

Save Batch File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Save Project File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Select Attribute Tables dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156Select Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157Select input columns from your table dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159Select output columns from your table dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160Select Project Files dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162Select Table dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163

User Guide 8

Select Table Type dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164Startup Preferences dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164Text File Wizard (Step 1 of 3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166Text File Wizard (Step 2 of 3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167Text File Wizard (Step 3 of 3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168

Appendix B: Creating a Map Catalog Manually . . . . . . . . . . . . . . . . . . . . . . . . . 170Manually Creating a MapInfo Map Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171Adding Rows to the MapInfo_MapCatalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172

Spatial Index Types for SPATIALTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175Per-Record Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175Symbol, Pen, Brush Clause Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175

Specifying Point Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Specifying Line Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Specifying Fill Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

User Guide 9

1
Introduction
Welcome to MapMarker UK v4.5, one of the premier address matching and geocoding offerings from Pitney Bowes Business Insight.

In this chapter:

What Is Geocoding?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11What Is MapMarker? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11Understanding the MapMarker UK Address Dictionaries. . . . . . .12MapMarker Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14MapMarker UK Documentation Set. . . . . . . . . . . . . . . . . . . . . . . . .17Getting Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

Chapter 1: Introduction

What Is Geocoding?Geocoding is the process of assigning geographic coordinates to data that contain addresses. The coordinates assigned to each address turn each record into a geographic object that can be potentially displayed on a map in either MapInfo Professional or via MapXtreme.

Location data can be leveraged in many ways. See Location Intelligence Products and related parts of the Pitney Bowes Business Insight web site for details on how your organization can use location information to make better decisions

What Is MapMarker?MapMarker UK v4.5 is a powerful geocoding tool produced by Pitney Bowes Software Inc. MapMarker UK enables you to assign geographic coordinates to large tables of UK-based address records in a single session. This is a key step toward mapping and analyzing your business data. MapMarker UK adds geographic coordinates to every record in your database that it matches against its comprehensive Address Dictionary.

MapMarker UK assigns coordinates to an address based on how well it matched in the Address Dictionary. The precision of the match can vary. For each address you geocode, you may get back a single perfect, street-level match, a list of street-level match candidates from which you choose the best match, or a less precise postcode match.

To identify the match precision, MapMarker UK also returns a result code for each address that it geocodes. The precision that you require for your geocoded records depends on how you plan to use your data.

In addition to being a powerful geocoder, MapMarker UK is also a suite of tools that allows you to standardize your British addresses, add spatial information and create points for your records, develop standalone or client/server custom geocoding applications, and embed MapMarker UK functionality in existing applications.

The MapMarker server enables multiple simultaneous geocoding requests to be served from a single MapMarker engine. The server product includes APIs that enable developers to write client/server or standalone geocoding applications.

Several MapMarker UK v4.5 dictionaries are described in this documentation. See Understanding the MapMarker UK Address Dictionaries on page 12 for more information. These dictionaries have basically the same address coverage and geocoding behaviour, but provide different levels of geocoding precision. The Address-Point dictionary provides geocoding precision to the building location (roof top) while the CodePoint Dictionary provides postcode centroid geocoding.

MapMarker Desktop ApplicationThe MapMarker UK Desktop Application can be installed on a single machine, or on a network to be shared by other users. The Desktop Application gives you a great deal of control over the geocoding process.

Developer Guide 11

http://www.pbinsight.com/products/location-intelligence/applications/americas-geocoding/

Understanding the MapMarker UK Address Dictionaries

Following is a partial list of MapMarker UK Desktop Application features:

• Supports a number of different file formats, including MapInfo TAB files, DBF files, CSV, and delimited text files (TXT).

• Geocode interactively (you make the final decision if it is a match) to maximize the number of matches and to control error rate.

• Geocode a portion of your table using the Quick Geocode feature.• Geocode a large database of addresses in batch mode.• Geocode to points, street address centroids, or postal centroids, depending on the address

input, user preferences, and available address dictionary.• Identify result codes quickly tell how the address match was made and how precise the match is.• Geocode remote tables via ODBC.

Beyond the DesktopIn addition to the MapMarker UK Desktop Application, MapMarker UK is available as a server and developer tool. Using the Java API, developers can write client/server or standalone geocoding applications. The MapMarker UK server enables multiple simultaneous geocoding requests to be served from a single MapMarker UK engine. The MapMarker UK developer tools include an XML API that enables you to write geocoding applications.

Understanding the MapMarker UK Address DictionariesYou can purchase and license MapMarker UK v4.5 with the choice of address dictionaries. The MapMarker UK v4.5 dictionaries are all derived from Royal Mail® sources. The dictionaries all have extensive address coverage but there are differences and geocoding behaviour and the levels of geocoding precision. Your choice of which MapMarker UK v4.5 dictionary to purchase depends on the requirements of your application.

Note You can purchase and license any or all of the address dictionaries, but you can install only one at a time.

The following sections describe the MapMarker UK v4.5 dictionaries in more detail.

MapMarker UK Address-Point Dictionary on page 12

MapMarker UK CodePoint Dictionary on page 13

MapMarker UK Address-Point DictionaryThe Address-Point (AP) dictionary contains street addresses and is delivered by Ordnance Survey®. This is based on Royal Mail® Postcode Address File (PAF®).

Candidate location will be usually to a resolution of 0.1 meters from the building/parcel delivery point. The Address-Point dictionary is suitable for applications that demand this highest available level of accuracy, including routing applications.

12 MapMarker UK v4.5


The AP dictionary provides a greater level of geocoding precision than can be delivered by the CodePoint dictionary. This high level of precision is reflected in S8 and S7 result codes. See Result Codes in Chapter 7 on page 119 for a description of all MapMarker UK v4.5 result codes.

The Address-Point dictionary is licensed by Government Office Region (GOR).The 12 GORs are as follows. Scotland, Northern Ireland, and Wales are treated as GOR equivalents for the purpose of representing UK statistics.

For more information on the Ordance Survey Address-Point data source, see http://www.ordnancesurvey.co.uk/oswebsite/products/addresspoint/.

While the Ordance Survey data source does not contain addresses for Northern Ireland, the Address-Point dataset shipped with MapMarker UK v4.5 is supplemented with Royal Mail® postcode address data for Northern Ireland. This Northern Ireland data has postcode centroid (result code S3) precision only.

MapMarker UK CodePoint DictionaryThe MapMarker UK v4.5 CodePoint Postal Address File (PAF) dictionary provides postcode centroid geocoding. The MapMarker UK v4.5 CodePoint dictionary is suitable for most applications involving address matching, validation, etc.

Government Office Regions

Region Number Name Abbreviation

1 London GL

2 East of England EE

3 West Midlands WM

4 East Midlands EM

5 South West SW

6 South East SE

7 North West NW

8 North East NE

9 Yorkshire and The Humber YH

10 Wales WA

11 Scotland SC

12 Northern Ireland NI

Developer Guide 13

http://www.ordnancesurvey.co.uk/oswebsite/products/addresspoint/

MapMarker Features

The CodePoint dictionary is derived from Royal Mail® and covers street addresses for the UK (Great Britain and Northern Ireland). The CodePoint dictionary is licensed for the entire dataset, rather than by region.

For more information on the Royal Mail data source, see: http://www.royalmail.com/portal/rm/jump2?mediaId=400085&catId=400084.

The postcode centroid precision provided by the CodePoint dictionary is reflected in S3 result codes. See Result Codes in Chapter 7 on page 119 for a description of all MapMarker UK v4.5 result codes.

MapMarker FeaturesSee the MapMarker UK v4.5 Release Notes for a summary of new features, address dictionary updates, and behavioral changes that you may notice with MapMarker. The Release Notes also describe fixes to customer-reported issues and known issues that customers should be aware of. The MapMarker UK v4.5 Release Notes are located at the Pitney Bowes Business Insight Product Documentation site.

The major features for MapMarker UK v4.5 are summarized below.

• The updated installer simplifies the installation and provides more choices and feedback during installation. See Updated Installer for more detailed information.

• The MapMarker Java-based geocoder introduces a number of improvements in geocoding accuracy, consistency, and performance.

• A Desktop Application is available. This is described in MapMarker Desktop Application on page 11. The MapMarker UK v4.5 User Guide illustrates the Desktop Application. Context sensitive online help is provided with the Desktop Application.

• Postcode geocoding and fallback.• Single line address input is accepted for geocoding. See Single Line Address Input on

page 16.• Several data dictionaries are available. See Understanding the MapMarker UK Address

Dictionaries on page 12 for information the available dictionaries.• Single close match with range results. Multiple delivery points within the same street are

returned as a single close match, with the individual delivery points included as ranges under the returned candidate. See Single Close Match Returned with Range Results on page 16.

• The Sample Application has been redesigned for greatly improved usability and to more fully demonstrate the range of MapMarker UK v4.5 capabilities.

Updated InstallerThe installer has been completely revised. You can select features for installation, select and install the JVM, modify your installation to add or remove features, upgrade your installation to point releases, and uninstall. You can also use graphical interface and silent procedures for all installation scenarios. The updated MapMarker UK v4.5 installer accommodates:

• Typical and custom installs• Silent installation and modification• Selecting and installing the JVM


http://reference.mapinfo.com/

http://reference.mapinfo.com/

http://www.royalmail.com/portal/rm/jump2?mediaId=400085&catId=400084


• Installing the sample application• Selecting default and custom locations for installing software and data• Choosing shortcut locations• Uninstalling MapMarker

Note: Note You must have administrator rights to install MapMarker software. This is true for all operating systems.

The MapMarker UK v4.5 installer installs either the Address-Point dictionary or the CodePoint dictionary, depending on which dictionary you purchased and licensed. See MapMarker UK Address-Point Dictionary on page 12 and MapMarker UK CodePoint Dictionary on page 13 for a description of these address dictionaries.

Note You cannot install both the Address-Point and CodePoint dictionaries on the same machine.

See Installing MapMarker in Chapter 2 on page 19 for a complete description of the installation procedure.

You can install both the MapMarker UK v4.5 and MapMarker GBR v4 products on the same machine as long as they do not use the same port numbers. By default, 8095 is the default startup port number and 8007 is the shutdown port number.

Street Level Geocoding (Including Address Cleaning)If you select the street level geocoding operation, MapMarker UK v4.5 will match your full address record against its comprehensive Address Dictionary This process will correct misspelled street addresses and suburb names. It will also correct postcode information, or add postcodes if your data does not already include them. After MapMarker completes the address cleaning step, it will geocode your records in accordance with the other preferences you have set.

Addresses that are geocoded to a street level return S result code. If the Address-Point dictionary is used, S8 or S7 result codes are typically returned. These return codes indicate a very high level of precision. (parcel/point precision). The Address-Point dictionary returns S3 when a parcel level match is not possible (such as when a house number or building name is not provided for input). For Northern Ireland addresses that has been added to the Address-Point dictionary, candidates are located at the postcode centroid level and these will have an S3 result code.

If the CodePoint dictionary is used, candidates are always located at the postcode centroid and these will have an S3 result code. See Result Codes in Chapter 7 on page 119.

Postcode GeocodingIf you choose Postcode Geocoding, MapMarker will geocode your records based on the postcode. You can also fallback to Postcode geocoding if a street level match was not possible.

See Postal Geocoding on page 66 for a description of the postcode structure and an example of postcode geocoding.

See Chapter 3: Geocoding with MapMarker UK for a description the UK postal system and examples of postal geocoding.

Developer Guide 15

MapMarker Features

Single Line Address InputMapMarker UK v4.5 can geocode input where all address components appear on a single line rather than in separate fields. You can use delimiters (comma, semicolon, colon) between the address elements, but this is not required.

For more information and examples of geocoding single line address input, see Unformatted (Single Line) Address Entry on page 65.

Single Close Match Returned with Range ResultsMapMarker UK v4.5 treats addresses within the same street as single close matches. Individual addresses, building names, companies, and other delivery points on the same street are returned as ranges. So for example, if a street has 10 addresses/delivery points, MapMarker UK v4.5 returns a single close match with each individual delivery point available as a range. The ranges are sorted based on matching closeness of house number, building name, etc.

Previous versions of MapMarker UK potentially returned multiple close matches (one for each delivery point on the street). If you prefer that behaviour in your application, use the Java API to set KEY_ADDRESS_RANGE_CANDIDATES to true.

Note By default, the sample application returns a single close match for each street address. If you want the sample application to return separate candidates for each unique delivery point, click Custom Constraints and select Ranges As Candidates.

Result CodesMapMarker UK returns a result code for each record it attempts to match. This enables you to see whether a match was made, which dictionary was the source of the match, and how precisely each address component matched. For more information on result codes, see Result Codes in Chapter 7 on page 119.

Developer ToolsThe MapMarker UK server edition includes the Java API and XML (.NET Framework) API. Using the Java API or XML API, developers can write client/server or standalone geocoding applications.

Integration with MapInfo ProfessionalMapInfo Professional users can run MapMarker UK or Envinsa 4.0 as a geocoding service from within MapInfo Professional 8.5 or later. This direct connection enables users to take advantage of MapMarker geocoding capabilities within the powerful MapInfo Professional mapping and analysis environment.

See Displaying Geocoded Records in MapInfo Professional on page 68.



MapMarker UK Documentation SetThe documentation set for MapMarker UK Server provides resources to help you make the most of this geocoding product. The set includes:

• MapMarker UK v4.5 User Guide in PDF format.• MapMarker UK v4.5 Developer Guide in PDF format.• MapMarker UK v4.5 Release Notes updated information on new features, behavioral changes in

the software, fixes for customer-reported issues, and known issues. To see these Release Notes and other MapMarker UK documentation, go to the Product Documentation page on the Pitney Bowes Business Insight web site.

• Java API documentation for MapMarker UK Server, which is located in \docs under the directory where you installed the server. See index.html in your country folder for an alphabetical index of all classes with their methods and properties.The path to index.html is: C:\Program Files\MapInfo\MapMarker_UK_v4\docs\GBR\index.html.

Getting Technical SupportPitney Bowes Business Insight offers a free support period on all new software purchases and upgrades, so you can be productive from the start. remember to include your serial number, partner number or contract number when contacting Technical Support.

Europe/Middle East/Africa:

Support: +44 1634.880.141 (option 1)Fax: +44 1634.880.383 E-mail: [email protected]: Monday - Friday from 9am to 5pm GMT, excluding company holidays.www.mapinfo.co.uk

Germany

Support: +49 (0) 6142.203.400Fax: +49 (0) 6142.203.444E-mail: [email protected]: Monday - Friday from 9 am to 5pm MEZ, excluding company holidays.www.mapinfo.com.de

The Americas:

Support: +1 800.552.2511 (option 1)Fax: +1 518.285.6080 E-mail: [email protected]: Monday - Friday from 8am to 7pm EST, excluding company holidays.http://www.pbinsight.com/support

Developer Guide 17

http://www.mapinfo.de

http://www.pbinsight.com/support/product-documentation/m/details/mapmarker-mapmarker-plus-us

http://www.pbinsight.com/support

http://www.mapinfo.co.uk

mailto:[email protected]



Getting Technical Support

Asia Pacific:

Support: 1.800.648.899Fax: +61 02.9923.6141E-mail: [email protected] Hours: Monday - Friday from 8am to 6pm Australian EST, excluding company holidays.www.mapinfo.com.au


http://www.mapinfo.com.au


2
Installing MapMarker
This chapter contains instructions for installing MapMarker United Kingdom and describes other issues related to installation.

In this chapter:

Installation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20Operating Requirements and Performance Recommendations .22Installing MapMarker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23Modifying the MapMarker Installation . . . . . . . . . . . . . . . . . . . . . .29Upgrading the MapMarker Installation . . . . . . . . . . . . . . . . . . . . . .30Uninstalling MapMarker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31Starting MapMarker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32

Installation Overview

Installation OverviewMapMarker UK is available as a Desktop and Server edition. The features available for installation are determined by the edition that was purchased. The features available during installation are as follows:

MapMarker UK Desktop Edition The Desktop edition includes the Desktop Application, which includes the graphical user interface for geocoding addresses and the licensed MapMarker UK Address Dictionary.

The Desktop Application runs on Microsoft Windows only.

MapMarker UK Server Edition The Server edition enables multiple simultaneous geocoding requests to be served from a single MapMarker UK engine. It also includes the tools necessary for developing MapMarker UK solutions using the Java API or XML API. These tools include the MapMarker UK SDK, native code libraries, and examples. A preconfigured Apache Tomcat servlet is provided to run MapMarker UK as a geocoding server.

Note The MapMarker UK Desktop product and MapMarker UK Server product are sold and licensed separately. The Server product does not include a Desktop license.

The MapMarker installer program can be used for the following purposes:

• New installation. See Installing MapMarker on page 23.• Modifying existing installation to add or remove features. For example you could add new data or

add a feature to an existing installation. See Modifying the MapMarker Installation on page 29.

• Upgrading existing installation. You can easily upgrade when a point release or minor release is available. For example, you can upgrade from version v4 to a subsequently available point release with the same set of features that are already installed. See Upgrading the MapMarker Installation on page 30

• Uninstalling. See Uninstalling MapMarker on page 31.

Note You must have administrator rights to install MapMarker software. This is true for all operating systems.

Installation ComponentsAll the components you need for installing MapMarker UK v4.1 are on the provided media. The data is included is either the Address-Point, or CodePoint dictionary, depending on which dictionary you purchased and licensed. See Understanding the MapMarker UK Address Dictionaries on page 12.

the Address-Point dictionary can be licensed in their entirety or for any subset of Government Office Regions (GOR). See MapMarker UK Address-Point Dictionary on page 12. The table of Government Office Regions on page 13 shows a complete list of GORs.

The Codepoint dictionary is licensed as a single dictionary. See MapMarker UK CodePoint Dictionary on page 13.

Note: Contact Technical Support for your serial number and data unlocking code. See Getting Technical Support on page 17.


Chapter 2: Installing MapMarker

You can install both the MapMarker UK v4.1 and MapMarker GBR v4 on the same machine as long as they do not use the same port numbers. By default, 8095 is the default startup port number and 8007 is the shutdown port number. Contact Technical Support for assistance if you want to run both of these MapMarker UK products on the same machine.

Shared InstallThe MapMarker UK data can be shared among a group of users who wish to run the MapMarker UK Desktop Application. To do so, the system administrator does a shared installation of MapMarker UK. This must include the Desktop Application feature and the Address Dictionary in a common network location. Once the shared installation is complete, the system administrator must share the data folder across the network.

After the system administrator has made the shared data available across the network, client users can browse to that location and run the Desktop Application installer (desktop\ClientSetup.exe) to install the MapMarker UK Desktop Application on their workstations. Client users can then run the MapMarker UK Desktop Application and access the shared Address Dictionary.

About the Address DictionaryThe MapMarker Address Dictionary is installed during the installation of the MapMarker software. The Address Dictionary must be stored on a local hard drive or a network drive. By default, the dictionary resides in the data directory under the MapMarker program directory.

The MapMarker UK v4.1 installer will install the Address-Point or the CodePoint dictionary depending on which dictionary you purchased and licensed. See MapMarker UK Address-Point Dictionary on page 12 and MapMarker UK CodePoint Dictionary on page 13 for a description of these address dictionaries.

As part of the installation, the data dictionary properties file (GBR_DataManagerSettings.properties) will be configured to use the installed dictionary file. The data dictionary properties file is located in:

<Install_Folder>\sdk\tomcat\webapps\mapmarker40\WEB-INF\classes

If you licensed and installed the Address-Point dictionary, this dictionary is installed in:

<Install Folder>\MapMarker_UK_\data\AP

If you licensed and installed the Address Layer 2 dictionary, this dictionary is installed in:

<Install Folder>\MapMarker_UK_\data\AL2

If you licensed and installed the CodePoint dictionary, this dictionary is installed in:

<Install Folder>\MapMarker_UK_v4\data\PAF

For the Address-Point dictionary, you can install all or only a portion of the data set that you purchased. To install only a portion of the purchased data set, uncheck regions that you do not want to install when you reach the Choose Install Set dialog. You can install other licensed regions at a later time.

User Guide 21

Operating Requirements and Performance Recommendations

Operating Requirements and Performance RecommendationsNote the following recommendations in order to maximize the performance of your MapMarker installation.

Operating Requirements

Optimizing Performance

Operating RequirementsThis section describes the basic software and hardware requirements for MapMarker. See your version-specific Release Notes for more detailed descriptions and information on supported software and hardware.

These guidelines may change for subsequent versions of MapMarker UK v4.1.x. See the product Release Notes for updated operating requirements for your specific version of MapMarker. These MapMarker UK Release Notes are available on the PBBI Documentation web site. Navigate to the MapMarker UK EMEA v4 category to locate the MapMarker UK UK documentation.

Hardware and Memory Requirements

The minimum system requirements for MapMarker United Kingdom are:

• 1 Ghz Pentium® processor or equivalent• 1 GB RAM• 5 GB available disk space (including 1 GB for Address Dictionary)

For optimal performance we recommend:

• Dual core processor or better• 2GB RAM• 10 GB available disk space.

Supported Operating Systems

MapMarker United Kingdom runs on:

• Microsoft Windows• Solaris• HP-UX• Red Hat Linux• SUSE Linux

See the product Release Notes for detailed information on supported operating systems for your specific version of MapMarker United Kingdom. These MapMarker UK Release Notes are available on the PBBI Documentation web site. Navigate to the MapMarker UK EMEA v4 category to locate the MapMarker UK UK documentation.


http://www.pbinsight.com/support/product-documentation/details/mapmarker-mapmarker-plus-us

http://www.pbinsight.com/support/product-documentation/details/mapmarker-mapmarker-plus-us


JVM Requirements

MapMarker United Kingdom requires a Java Virtual Machine (JVM) to run. MapMarker UK v4.1 ships with:

• Sun JRE v. 1.5.0_09 (for Microsoft Windows and Sun Solaris)• HP JRE 1.5.0._04 (for HP-UX)• Sun JRE 1.5.0_11 (for Linux)

See the product Release Notes for detailed JVM support information for your specific version of MapMarker United Kingdom.

Optimizing PerformanceTo get the most from MapMarker geocoding capabilities, consider these guidelines for optimizing performance.

• Use the fastest processor available to you. We recommend 2.5 Ghz dual processor or better• Have enough memory so that the operating system can allocate some memory to your disk

cache. We recommend 1 GB RAM or better• Have at least 10 GB available disk space• Sort your table by postal code (if available) before geocoding.• Choose exact match criteria for all (house number, street name, town, postcode).• Store the Address Dictionary on a local hard drive.

Installing MapMarkerThis section describes the typical MapMarker installation procedures for Microsoft Windows users and for UNIX/Linux users. The graphical installer interface guides you through the procedure. You can also install silently, without user interaction.

Install Using the Graphical Interface

Installing Silently

Install Using the Graphical InterfaceFollow these steps for typical installation using the graphical installer program:

1. Begin the installation procedure as follows, depending on whether you are installing on Windows or on UNIX/Linux:• On Microsoft Windows, place the MapMarker installation media into your drive. The

installation should start automatically. Click Install Product in the list of options. In the Install Product dialog box, click Install MapMarker UK. Proceed to step 2.If the installation does not automatically run, from the Windows 2000/2003/XP Start menu, choose Run. From the Run dialog, type D:\SETUP.EXE in the Open command box (where D is the drive letter of your CD drive).

• On Solaris, Linux, or HP-UX, run the shell script from the root of the CD using the command:

User Guide 23


sh startinstall.sh Proceed to step 2.To bypass the startinstall.sh script, go to the /instdata folder of the CD, and run executable appropriate for your operating system. For example, on a Linux operating system:sh linux/install.bin

2. In the Introduction dialog, click Next to display the What’s New dialog box. This provides a brief summary of new features for MapMarker United Kingdom and provides data vintage information.

3. Click Next to display the License Agreement dialog box.4. After reading the License Agreement, click the "I accept the terms of the License Agreement"

button, and then click Next to display the Licensing dialog. 5. In the Licensing dialog, type your MapMarker UK serial number and unlocking code. The serial

number is located on a sheet of stickers in the MapMarker UK package. The unlocking code enables the installer to create a license file for your system that gives you access to the MapMarker UK features and data you purchased. Call +44 1753 848200 or e-mail [email protected]. Please have your serial number when you call or include the serial number with e-mail requests.After entering the serial number and unlocking code, click Next.If you entered valid serial number and unlocking codes, you will see the Choose Install Set dialog box. If you did not enter the correct codes, you will receive an error message and have the opportunity to re-enter the serial number and unlocking code.

Note During installation, the license file is copied into the MapMarker Data folder. The license file remains in that folder after an uninstall.

6. In the Choose Install Set dialog box, the default Typical Install Set shows the software and data features available for installation. To see a description of each feature, click on the feature to highlight it. A description of the selected feature appears in the Description box.

Note Depending on data that you purchased and licensed the appropriate Address Dictionary set will be installed in the Data folder.



Check the boxes for the features that you want to install and clear the check boxes of the features that you do not want to install.After choosing the features to install, click Next to display the Choose Install Folders dialog box.

7. In the Choose Install Folders dialog box, select the locations to install MapMarker software and data.

You can use the default locations or click Choose to display the Browse for Folder dialog, where you can navigate to the desired location. Click OK in the Browse for Folder dialog when you are finished.If you decide after selecting an alternative location that you would prefer the default location, click Restore Default in the Choose Install Folder dialog box.When you have selected the software and data install folders, click Next.

User Guide 25


8. If you selected the Desktop Application feature in the Choose Install Set dialog (in step 6), the Desktop Application Settings dialog appears. If you are not installing the Desktop Application, skip to step 10.In the dialog, choose whether the installation is for this workstation only or whether the installation is shared by others on the network.

Select The installation is for this workstation only if you want a local installation of MapMarker UK software and data. This is not shared with other users. Select The installation will be shared if this workstation of MapMarker UK serves as a host that provides a group of users on the same network a common location for the software and data. Users who wish to access the shared software and data that resides on the host workstation must do a separate client installation. See Client Workstation Install on page 32 for more information.After choosing a workstation only or shared installation, click Next to continue.

9. If you chose a shared installation (step 8), the dialog asks if you want to install the MapMarker UK Desktop Application on this workstation (the host workstation). If you chose that the installation would be for this workstation only, proceed to step 10.If you plan to use the MapMarker UK application on this workstation (the one on which you are doing the Shared installation), check Install the Desktop Application on this workstation. If you are installing the software only for other users to access, do not check this box. Click Next to continue.

10. The Desktop Application Settings dialog now shows the path to the shared data folder. Confirm or correct the path to the Shared Data Folder. Universal Naming Convention (UNC) paths are preferred (for example: \\ruready-W1\MapMarker UK_GBR_v4\Data). This ensures that users running MapMarker UK on other machines are able to access the shared data. If the network



share name or shared folder does not already exist, it must be created before you can use the MapMarker UK application.

Note The install program does not ensure that the data folder is shared to others on the network or is visible on the network. The person doing the installation is responsible for entering a valid path to the data folder and making this data folder accessible.

After you have confirmed the shared data folder, click Next to continue. 11. In the Choose Java Virtual Machine dialog box, do one of the following:

• Select the Install a Java VM specifically for this application button to install the Java virtual machine that comes with MapMarker.

• Select the Choose a Java VM already installed on this system button to select a Java virtual machine that you already have installed on the computer. Then select the Search for Others button to have the installer search your computer for an installed JVM. After the search is completed, the dialog box will be populated with a list of the JVMs that were found on your workstation. This may take some time.

The Choose Java Virtual Machine dialog box appears as follows.

See your MapMarker version-specific Release Notes for complete information on operating requirements and recommendations, including information on the supported and recommended JVMs.After selecting the JVM, Click Next to display the Choose Shortcut Folder dialog box. If you select a JVM that is already installed on your system, and that JVM is invalid or cannot be found, you will receive an error message.

12. In the Choose Shortcut Folder dialog box, choose where you want to create the product icons. You can create a new Program Group, place the icons in an existing Program Group, or make other choices. After making your selection, click Next to continue.

13. In the Pre-Installation Summary dialog box, review the disk space requirements and your install selections. To edit any selections, click the Previous button to go back to the earlier dialogs.

User Guide 27


14. When you are satisfied with your installation choices, click Install. A progress dialog reports progress as the software and data is installing.An installation of MapMarker and the entire Address Dictionary may be time-consuming. To verify that the installation is progressing, check the directory where the data is targeted to reside. You should see new files being added as the process continues.

15. When the installation is finished, the Install Complete message appears. Click Done to exit the installer.

Installing SilentlyYou can install MapMarker United Kingdom without using a graphical interface and without user interaction. This allows you to install MapMarker in environments that do not provide a graphical user interface.

To perform a silent install, use the properties file located in the root folder on the CD. This file defines the values for the installer to use when installing in silent mode. The file is named:

silentinstall.properties

You must edit the file to suit your particular needs. This file includes extensive comments to assist you in this process. By default, the file is initially configured to install the engine, samples, and licensed data. After editing this file, you can then launch the silent install and pass this properties file to the installer program.

To edit the silentinstall.properties file:

1. Copy the silentinstall.properties template file to a a location on the target machine and open the file in a text editor.

2. In the properties file, specify information for the install properties and set the software and data features that you want to install. The file contains instructions for changing each of the values. You must specify the following:• Install location of the application files and data• Java Virtual Machine• Shortcuts/links location• Features to install

3. To launch the silent install, use the following command line arguments:On Unix/Linux (where media/CDROM represents the location of the installation media and /tmp represents the location of the silentinstall.properties file)./media/CDROM/startinstall.sh -f /tmp/silentintsall.properties

On Windows operating systems (where D: represents the drive location of the installation media and C:\tmp represents the location of the silentinstall.properties file).start /w D:\instdata\windows\install.exe f C:\tmp\silentinstall.properties

Note You must use an absolute path for the properties file.



Modifying the MapMarker InstallationAfter you have installed MapMarker, you can run the Install program to modify the MapMarker installation. When modifying the installation, you can add features that you did not originally install or remove features that you did install.

Note Some things cannot be modified, such as the paths for software and data.

If MapMarker is already installed on your system, the install program will open to the Introduction dialog. This bypasses the Licensing dialog box, since you have already accepted the License Agreement. You can then proceed to modify your installation

Modify Using the Graphical Interface

Modify Silently

Modify Using the Graphical InterfaceTo modify your MapMarker United Kingdom installation, do the following:

1. Start the installer as described in step 1 of Install Using the Graphical Interface on page 23.2. At the Introduction dialog box, click Next.3. Enter or confirm your serial number and unlocking code. This information will already be

populated in the dialog box. If you purchased new features (such as additional data), you will have a new unlocking code and must enter this in the Licensing dialog box.

4. The Install Set dialog box will appear and show a checked box for every MapMarker feature that is installed. This is where you can either install features that you previously chose not to install or uninstall selected features. Do the following:a. Uncheck any feature that you want to remove. For example you can uncheck and remove the

Sample Application that you previously installed. Click Next.b. Check features that you want to install. You will see only features that are licensed to you,

based on your unlocking code. Click Next.5. The Pre-installation Summary dialog box will show a list of product features that will be installed.

If you chose to install new features, they will be listed. If you chose to uninstall any features, those features will be absent from the list of product features.

6. After verifying the product features, click Install.7. The Install Complete dialog box will confirm your actions. Click Done.

Modify SilentlyYou can modify MapMarker United Kingdom without using a graphical interface and without user interaction. To perform a silent modify, edit the silentinstall.properties file to suit your needs. See Installing Silently on page 28 for information on the location and use of the properties file.

The FEATURE_LIST variable of the silentinstall.properties file must include all of the features that you want to install, and none of the features that you want to exclude. For example, if you already had installed data for London (region GL) and wanted to add the East of England (EE) and South East (SE) regions, make sure that the FEATURE_LIST indicates all of those choices – not just the regions that you are adding.

User Guide 29

Upgrading the MapMarker Installation

See the table of Government Office Regions on page 13 for a complete list of GORs.

You cannot use the silent modify procedure to change any of the following settings.

• Program paths• JVM• Shortcuts and links

To make these changes, you must uninstall then reinstall MapMarker.

Upgrading the MapMarker InstallationMajor releases can be upgraded when point releases become available. Similarly, one point release can be upgraded to the next point release. When performing an upgrade, the installer upgrades all of the currently installed MapMarker features to the new version. All settings and configuration will remain unchanged.

If you want to add or remove features or change settings, you must first upgrade and then run the installer again to modify your installation (see Modifying the MapMarker Installation). Alternatively, you may uninstall and then re-install MapMarker if you have changes that cannot be performed using the Modify option.

Note You cannot upgrade from one major release to another major release. In that case you must perform a new installation of MapMarker UK v4.1. You will be able to perform a minor upgrade. For example, you could upgrade from version 4.1 to version 4.2, if an upgrade version is released.

For any given country, you can have different versions of major releases on the same workstation, but you cannot have different point releases installed on the same workstation. We recommend that you contact Technical Support if you want to use more than one version of MapMarker.

Upgrade Using the Graphical Interface

Upgrade Silently

Upgrade Using the Graphical InterfaceTo upgrade MapMarker United Kingdom version 4.1 to a point release (if and when an upgrade is available), do the following:

1. Start the installer as described in step 1 of Install Using the Graphical Interface on page 23.2. Continue with step 2 through step 4 as described in Install Using the Graphical Interface. In

the Pre-Installation Summary dialog box, click Install to begin the upgrade.3. When the Upgrade Complete dialog box appears, click Done.



Upgrade SilentlyYou can upgrade MapMarker United Kingdom version 4.1 to a point release without using a graphical interface and without user interaction. Start the silent installer as described in Installing Silently on page 28. Because this is an upgrade, If there are any changes to the installation reflected in the properties file they will be ignored.

Uninstalling MapMarkerWhen uninstalling MapMarker, you have two options, a complete uninstallation or removal of certain features only. A complete uninstall will remove the MapMarker program directories, groups, and icons. Files and folders created after the installation will not be removed or affected in any way.

You can uninstall specific features (rather than a complete uninstall) if you use the graphical interface uninstall. The silent uninstall always does a complete uninstall.

Uninstall must be done using the same mode (graphical interface or silent) as the previous installation, modify, or upgrade. So if your previous install, modify, or upgrade was performed using the graphical interface, then the uninstall will be run using the graphical interface.

Uninstall Using the Graphical Interface on page 31

Uninstall Silently on page 32

Uninstall Using the Graphical InterfaceTo uninstall MapMarker United Kingdom, follow this procedure.

1. Begin the uninstall procedure as follows, depending on whether you are uninstalling on Windows or on UNIX/Linux:• On Microsoft Windows, from the Control Panel Add or Remove Programs utility. Select

MapMarker United Kingdom v4 and click the Change/Remove button. Proceed to step 2.• On Solaris, Linux, or HP-UX Run the shell script from the root of the CD using the command:

sh /opt/MMv4/Uninstall_MapMarker_UK_v4/Uninstall_MapMarker_UK_v4

where /opt/MMv4 is the directory into which MapMarker United Kingdom was installed.2. In the Uninstall MapMarker United Kingdom v4 dialog, click Next.3. Select Complete Uninstall or Uninstall Specific Features, then click Next.4. If you selected Complete Uninstall in step 3, the uninstall program will run immediately and

MapMarker United Kingdom v4 will be completely uninstalled.If you selected Uninstall Selected Features in step 3, uncheck the product features that you want to uninstall, then click Uninstall to uninstall those features only.

5. When the uninstall completes, click Done.

User Guide 31

Client Workstation Install

Uninstall SilentlyIf your previous installation, modify, or upgrade of MapMarker was performed silently, the uninstall will run silently as well. Launch the uninstall by running the command appropriate for your operating system shown in step 1 of Uninstall Using the Graphical Interface. Remember, a silent uninstall will always perform a complete uninstall of MapMarker.

Client Workstation InstallIf the system administrator has done a Shared installation of MapMarker UK and shared the program folder and data folder across the network, users on the network can run client installations on their local workstations. Client users can then run the MapMarker UK Desktop Application and access the shared Address Dictionary.

For instructions on doing a Shared installation, see Shared Install on page 21.

To set up a client workstation to access MapMarker UK from a shared installation, follow these steps:

1. Browse to the location of the shared installation of MapMarker UK on the network server. (You may need to check with the System Administrator for the location.)

2. From the shared machine, run the setup program (ClientSetup.exe) in the desktop folder of the MapMarker UK program directory. The Welcome dialog appears.

3. In the Welcome dialog, click Next to display the Destination Folder dialog.4. You can click Next to accept the default destination folder or click Change to display the Change

Current Destination Folder dialog and navigate to another location. Click OK in the Change Current Destination Folder dialog when you have specified the new location, then click Next to display the Ready to Install the Program dialog.

5. At the Ready to Install the Program dialog, click Install.6. When the installation wizard completes, click Finish.

All the components necessary to run the MapMarker UK Desktop Application using the shared Address Dictionary are installed. This includes MDAC and the Microsoft Jet engine with their desktop ODBC drivers.

To uninstall the client application, from the Control Panel select the Add or Remove Programs utility. Select MapMarker UK 40 Desktop and click Change/Remove.

Starting MapMarkerAfter successfully installing MapMarker UK v4.1 you can start the Desktop Application.

Starting the Desktop Application



Starting the Desktop ApplicationIf you installed the Desktop Application feature of MapMarker UK, you can start the MapMarker UK Desktop as follows:

• From the Start Menu or the program group where you installed the MapMarker UK icons, click the icon named MapMarker Desktop. The Desktop Application starts.If you chose not to install icons, open the directory where you installed MapMarker UK, and in the subdirectory named desktop double-click on the file mapmarkr.exe. The Desktop Application starts.

User Guide 33

3
Geocoding with MapMarker UK
After you have prepared your address data, you are ready to geocode your table. This chapter describes how to run MapMarker UK and how to start geocoding your records. This chapter also describes the basic geocoding workflow and illustrates the major MapMarker UK geocoding features.

In this chapter:

Geocoding Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35Understanding the Geocoding Process. . . . . . . . . . . . . . . . . . . . .37Running MapMarker – Overview. . . . . . . . . . . . . . . . . . . . . . . . . . .43Opening and Running a Project . . . . . . . . . . . . . . . . . . . . . . . . . . .43Opening a Table or Text File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44Selecting Input and Output Address Columns . . . . . . . . . . . . . . .50Geocoding Your Table Automatically . . . . . . . . . . . . . . . . . . . . . . .56Geocoding Your Table Interactively . . . . . . . . . . . . . . . . . . . . . . . .57Making the Most of Interactive Geocoding . . . . . . . . . . . . . . . . . .59Street Address Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60Postal Geocoding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66Displaying Geocoded Records in MapInfo Professional . . . . . . .68Re-Geocoding a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69Using Geocoding Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69Saving TAB Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76Creating and Saving a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . .76

Chapter 3: Geocoding with MapMarker UK

Geocoding TerminologyMapMarker UK products use a common set of geocoding terms. We use these terms consistently in the MapMarker UK documentation, and describe the terms more fully where appropriate.

Geocoding Terminology

Term Definition

address Information that identifies the location of a site, for example, a home or business.

address dictionary The search dictionary used for matching addresses during geocoding.

address interpolation A mathematical means of estimating an address location based on a street segment and the address ranges associated with that segment. This method of interpolation assigns coordinates to address records in relation to the position of address point candidates in the data, providing greater positional accuracy to the geocoded points.

candidate An address record that is a potential match to the input address information.

A candidate is returned by the geocoding process. See also geocoding.

centroid A point at the calculated center of a polygon, often used to attach attribute information to an area. The centroid is used for labeling and geocoding, for example.

For an irregularly shaped area, region, or polygon, the centroid is derived mathematically and is weighted to locate the point at the approximate "center of gravity."

close match If an input address corresponds closely to one or more known records in the address dictionary, then the returned candidates are considered close matches. The specified matching criteria may include house number, street name, town, locality, or postcode.

geocoding The process determining the X and Y coordinates of a location by its address.

Developer Guide 35

Geocoding Terminology

match strategy An approach to geocoding a table that achieves the desired geocoding results. For example, if geocoding hit rate is more important than accuracy, then looser match criteria would ensure that more records in the table are geocoded.

Or if you required greater accuracy, you could use stricter geocoding criteria, such as an exact match on street name and house number.

must match Must Match options are used for deciding whether returned candidates are close matches. A Must Match option does not eliminate non-close matches.

postal geocoding Candidate coordinates are based on postal codes. This is faster but not as accurate as street level geocoding. Also, postal geocoding of rural areas is generally less accurate than that of urban areas.

postcode A unique identifier for postal mailing zones.

post-directional The letters following a street name that give a direction to the address.

Not every address has a post-directional component.

post-type Street type that follows the street name. These are also known as street suffixes.

Not every address has a post-type component.

pre-directional The letters preceding a street name that give a direction to the address.

Not every address has a pre-directional component.

result code An alphanumeric code that describes the type and accuracy of the geocoding match.

MapMarker UK returns a result code (georesult) for each record it attempts to match. These codes allow you to determine the success and precision of the geocoding match. Result codes are described in more detail in Result Codes in Chapter 7 on page 119.

street level geocoding Candidate coordinates are interpolated along a street segment. This is a highly accurate level of geocoding.

Geocoding Terminology (continued)

Term Definition



Understanding the Geocoding ProcessMapMarker UK is based on a model of relative matching that is governed by a set of weights that scores each portion of the address against candidate records (possible matches) in the Address Dictionary. The resulting scores are summed and the candidate’s total score is used to determine the best match or matches. An exact match is made when a candidate scores well above that of other candidates. If there is no clear best match, several (non-close) candidates may be returned.

If a record is not geocoded, you can still attempt to match that record during interactive geocoding where you can pick what you consider the best match from a list of candidates.

The basic MapMarker UK workflow is to open your MapInfo Table or other input file, specify which columns contain address information, and then geocode your records. MapMarker UK automatically matches your records to those in its Address Dictionary, determines if there is a match, and assigns the geographic coordinates.

The following topics provide an overview of the supported file formats, basic steps, input, and expected output.

Additional topics in this chapter provide more detail.

• Supported File Formats on page 37• Geocoding Flexibility and Trade-offs on page 38• Optimizing Geocoding Performance on page 39• Specify Input Address Columns on page 39• Specify Output Address Columns on page 40• Output Field Size and Column Names on page 41• Setting Startup Preferences on page 42

Supported File FormatsMapMarker UK supports (opens and writes) files in the following data formats:

• TAB – MapInfo TAB files• DBF – dBASE format• CSV – comma-delimited text files (Desktop only)• TXT – other delimited text file (Desktop only)

Delimited text files can use various delimiters (comma, semicolon, tab, slash, or other). If you open a CSV file, a comma delimiter is assumed.

See Opening a Table or Text File on page 44 for instructions on opening an input file in MapMarker UK. See Defining Properties of Delimited Text Files on page 45 for information on managing delimited text files.

See the following topics:

Geocoding Flexibility and Trade-offsOptimizing Geocoding PerformanceSpecify Input Address ColumnsSpecify Output Address ColumnsOutput Column Type/Width Requirements

Developer Guide 37

Understanding the Geocoding Process

Output Field Size and Column NamesSetting Startup Preferences

Geocoding Flexibility and Trade-offsMapMarker UK uses a relative matching system that gives you a great deal of control over geocoding accuracy and scope.

The optimal level of geocoding depends on your application and goals. You may require highly accurate address matching, or possibly a close positional matching is suitable for your purposes. Or you may want to retrieve as many records as possible in an area (postcode) without concern for exact address matching.

There are trade-offs that you must consider with respect to how you intend to use the geocoded data. When setting up a geocoding session, consider questions such as the following:

• What level of matching accuracy are you looking for: a unique address match or close match?• What level of geographic accuracy do you need for your geocoded points: street-level centroid or

postcode centroid?• Is your goal to geocode as many records as possible?

The answers to these questions are driven by how you intend to use the geocoded records. When determining the location of a new retail store, you need to know the distribution of current and potential customers. In this case, you would need to geocode as much of the customer base as possible but you might not need an exact street address match for each customer. Geocoding to postcode centroid would be suitable for this analysis.

Street level geocoding with strict matching preferences would be useful for cases in which it is necessary to know exactly where your customers are. For example, if you are a utility service coordinator and need to know exactly where your customers are in relation to neighborhood gas lines, the positional accuracy of each customer is of critical importance to you.

In addition, the matching routine uses the geocoding preferences that are set for the table to determine whether certain matching conditions are required or not. For example, you could require a match on street name and postcode, but not require an exact match on the town or house number. This could produce a good combination of hit rate with the relatively few erroneous matches (false positives) and good performance.

For an overview of geocoding match strategies, see Choosing Match Strategies on page 81.

• Supported File Formats on page 37• Optimizing Geocoding Performance on page 39• Specify Input Address Columns on page 39• Specify Output Address Columns on page 40• Output Field Size and Column Names on page 41• Setting Startup Preferences on page 42



Optimizing Geocoding PerformanceMapMarker UK has been optimized for high performance. Follow these guidelines to achieve even faster performance.

• Use the fastest processor available to you. We recommend 2.5 Ghz dual processor or better.• Have enough memory so that the operating system can allocate some memory to your disk.

cache. We recommend 1 GB RAM or better.• Have at least 10 GB available disk space.• Use approved address formats in your input data. • Use postcodes in your input data. This can improve performance significantly depending on

other factors.• Sort your input table by postcode before geocoding.• Choose exact match criteria for all (house number, street name, town, and postcode).• Do not create points automatically.• Remove indexes on any table output columns before geocoding


• Supported File Formats on page 37• Geocoding Flexibility and Trade-offs on page 38• Specify Input Address Columns on page 39• Specify Output Address Columns on page 40• Output Field Size and Column Names on page 41• Setting Startup Preferences on page 42

Specify Input Address ColumnsMapMarker UK reads the addresses stored in your table and matches it against address records in the Address Dictionary. MapMarker UK then assigns geographic coordinates (geocodes) each address that it can process.

You must specify the columns that contain your addresses. The Select Input Columns dialog is the first area where you specify that information. For street level geocoding, you must have at least one street address column plus one column for town or postcode. For postcode centroid matching, you do not need to specify a street address or town.

MapMarker UK can also geocode single line addresses, where all address components appear on a single line rather than in separate fields. That strategy is described in Unformatted (Single Line) Address Entry on page 65.

For instructions on selecting input columns, see Selecting Input Columns on page 50.


Supported File FormatsGeocoding Flexibility and Trade-offsOptimizing Geocoding PerformanceSpecify Output Address ColumnsOutput Column Type/Width RequirementsOutput Field Size and Column NamesSetting Startup Preferences

Developer Guide 39


Specify Output Address ColumnsMapMarker UK can store longitude/latitude coordinates and geocoding result codes in your table. For supported output file formats, you can either prepare the table ahead of time by adding columns to store this information, or specify that MapMarker UK automatically creates the columns for you. For ODBC (remote) tables, you or your database administrator must add the columns before you run MapMarker UK. For information on ODBC tables, see Geocoding Remote Tables in Chapter 6 on page 107.

Note The longitude/latitude columns are required if you do not want MapMarker UK to create points automatically. A result code column is optional, but it is recommended.

If you want MapMarker UK to return the matching address for you to compare with your input address, you must provide columns for that information. For supported file formats, you can either prepare your table ahead of time, or create the columns by clicking Modify Columns on the Select input columns from your table or Select output columns from your table dialogs. For remote tables, add the columns before opening the file in MapMarker UK.

MapMarker UK can also return attributes (such as demographic data) from other tables during geocoding, so you must first prepare columns from the Select Input Columns dialog as described in Specify Input Address Columns on page 39.

For instructions on selecting output columns, see Selecting Output Columns on page 53.


Supported File FormatsGeocoding Flexibility and Trade-offsOptimizing Geocoding PerformanceSpecify Input Address ColumnsOutput Column Type/Width RequirementsOutput Field Size and Column NamesSetting Startup Preferences

Output Column Type/Width Requirements

The following table lists the type and width requirements for output columns.

Output Column Type (Width)

Result Code char(13)

Long (X) Decimal (11,6) or Float

Lat (Y) Decimal (10,6) or Float

Firm char(30)

Address char(64)

Address2 char(64)




Supported File FormatsGeocoding Flexibility and Trade-offsOptimizing Geocoding PerformanceSpecify Input Address ColumnsSpecify Output Address ColumnsOutput Field Size and Column NamesSetting Startup Preferences

Output Field Size and Column NamesMapMarker UK can return output information (such as firm names, apartment numbers, and suites) that exceeds the recommended width of the output fields for Street and Firm. When this happens, MapMarker UK truncates the information in the respective output field.

In the Input Column and Output Column dialogs, if a field name is too long to be seen in its entirety in the list box, hold the cursor over the field name to display a popup box with the full name of the field.


Supported File FormatsGeocoding Flexibility and Trade-offsOptimizing Geocoding PerformanceSpecify Input Address ColumnsSpecify Output Address ColumnsOutput Column Type/Width RequirementsSetting Startup Preferences

Town char(30)

DefaultFlag char(1)

Output Column Type (Width)

Developer Guide 41


Setting Startup PreferencesMapMarker UK has Startup preferences that apply to all of your geocoding sessions. This allows you to start MapMarker UK with a consistent appearance and behavior. These Startup preferences are available on the System Preferences dialog.

To display the System Preferences dialog, click System Preferences on the Options menu, and then click the Startup tab.

You can use any and all preferences available in this dialog. For the file open choices, if you select either Show for MapInfo or dBASE files or Show for ODBC tables, the Open dialog appears automatically when you start MapMarker UK. If you select both options, MapMarker UK prompts you with another dialog at startup to choose which type of table you want to open.

You may also control which of the setup dialogs, if any, display on startup. Choose from:

• Show Select Column Dialog On Open (selected by default)• Select Attribute Files After Selecting Columns • Show Geocode Dialog After Selecting Columns (selected by default)

By selecting all three options, when you start MapMarker UK, it walks you through the geocode and attribution setup phase. The settings are saved to the table as metadata and used as new defaults when you open the table again.


Supported File FormatsGeocoding Flexibility and Trade-offsOptimizing Geocoding PerformanceSpecify Input Address ColumnsSpecify Output Address ColumnsOutput Column Type/Width RequirementsOutput Field Size and Column NamesSetting Startup Preferences



Running MapMarker – OverviewMapMarker UK geocodes your records to street level, or postcode centroid either automatically (making a match without user interaction) or interactively (allowing you to decide the match from a list of suggestions). You can use a number of strategies to geocode your records. A basic scenario is to run MapMarker UK and follow these steps:

1. Open the table to be geocoded and identify the columns that contain specific address components (see Selecting Input and Output Address Columns on page 50.

2. Geocode your records automatically to match as many records as possible. See Geocoding Your Table Automatically on page 56.

3. Geocode remaining unmatched records interactively by choosing from a list of candidates. See Geocoding Your Table Interactively on page 57.

4. Display geocoded records in Pitney Bowes Business Insight mapping software. See Displaying Geocoded Records in MapInfo Professional on page 68.

5. Analyze the result codes. See Result Codes in Chapter 7 on page 119.

After opening an input table, you must identify the input columns that contain address information to use for matching purposes.

Opening and Running a ProjectA project preserves settings preferences and restores these settings the next time the project is opened. A project file overrides any existing metadata settings associated with a TAB file.

To create or save a project, see Creating and Saving a Project on page 76. That topic also describes the specific items that are saved with a project.

To open an existing project:

1. From the MapMarker UK menu, select File > Projects > Open Project. 2. Navigate to the folder that contains the project, select the project name (with a PROJ file

extension), and click Open.

Developer Guide 43

Opening a Table or Text File

Note You can open only one project at a time.

After opening the project you can geocode using the column mappings and geocoding preferences that were saved with the project. Or you can you make changes before proceeding with geocoding.

Running a Project from a Batch FileYou can run a project from a command line batch file. For this syntax see Creating a Project-Based Batch File on page 77.

Opening a Table or Text FileThe following steps describe how to select and open your input file. See Supported File Formats on page 37.

Note This procedure applies to opening local files. For instructions on opening remote tables, see Accessing a Remote Table for Geocoding on page 110.

1. Start MapMarker UK from the Windows Start menu or Shortcut menu.

2. Select File > Open Table, click or click the secondary mouse button to display a shortcut menu. The Open Table dialog appears. Select the folder that contains your tables and click Open.

3. From the File of type drop-down list, select one of the following file types:• MapInfo Tables (*.TAB)• DBF Files (*.DBF)• Comma-delimited text (*.CSV)• Other delimited files



All files associated with the selected file type will appear. See Supported File Formats on page 37 for a description of MapMarker UK supported input file formats.

4. Select the file that you want and click Open. If you open a MapInfo TAB file, you will now identify address input and output columns. Continue with Selecting Input and Output Address Columns on page 50If you open a text file (CSV, TXT, or possibly other file extension), the Text File Wizard appears. Continue with Defining Properties of Delimited Text Files

Defining Properties of Delimited Text FilesAfter you open any CSV or TXT input file, the Text File Wizard appears. This wizard allows you to define the properties of the input file.

Note The wizard creates or modifies a format file that governs the properties of its associated text file. The format file is created in the same folder that contains the input file. If this folder is not writable, the format file is created in My Document\MapMarker UK GBR\ folder. The format file is given the same name as the associated text file, but with an FMT file extension. In most cases you will not have to examine or maintain the format file in any way.

Developer Guide 45


The following steps follow one likely scenario and show how to use the Text File Wizard for a comma-delimited text file This example assumes that you are opening the file for the first time and the first row of the table is used for column titles (rather than data).

First, open the text file as described in Opening a Table or Text File on page 44. Use the File of Type drop-down list to select TXT file extensions.

1. Step 1 of the Text File Wizard displays the Input Table dialog with the name of the CSV or TXT file that was previously opened, as described in Opening a Table or Text File on page 44. The list box area of the dialog will display up to the first 20 records of the opened file.

Text File Type: If the text file is a delimited file, the appropriate button will be selected in the wizard. Delimited is also selected if the opened file is a CSV file.

Delimiter Type: If the delimiter is recognized it will be selected and the other choices are disabled. For example, with a CSV file a comma delimiter is recognized and the other group selections are disabled. Semicolon, tab, or slash can also be used as delimiters. If one of these standard delimiters is not recognized in your text file, you can select Other and type the delimiter character. For example, your text file might use a pipe symbol (|) as a delimiter. Not all characters and symbols can be used as delimiters. You will receive an appropriate message if you try to specify a disallowed character.



First Line Used for Column Titles: You can use the first line of the text file as column titles or as data.To use the first line as column titles, check the First Line Used for Column Titles check box. This will replace the generic FIELD_1, FIELD_2... labels and use the first row of the text file to name the columns. If First Line Used for Column Titles is not checked, the first line will be used as data just as any other line in your text file. In this example, we will assume that the first line of the text file is used for column titles.When you have finished with step 1of the wizard, click Next to go to step 2 of the wizard.In this dialog box, you can select the matching format file and define some format elements of the input table, as follows:a. Specify whether to use an existing format file, with the same name as the text file but with an

FMT file extension.b. Optionally select Browse if you want to select an different format file. • Specify whether the text file is delimited or fixed-width. If you opened a CSV file, the

Delimited button is already selected and the other choices are disabled.c. Specify the delimiter type. If you opened a CSV file, this group will be disabled, since a

comma delimiter is assumed. For text files, you can also select Semicolon, Tab, or Slash as a delimiter or select Other and type a delimiter character. For example, you might use a pipe symbol (|) as a delimiter.

Some characters and symbols cannot be used as delimiters. You will receive an appropriate message if you try to specify a disallowed character.

d. Specify whether to use the first line of the file for a column title. Examine the preview of the file in the list box to help determine this.

e. Click Next to go to step 2 of the wizard.

Developer Guide 47


2. Step 2 of the text file wizard allows you to examine the fields (columns) in the input table and change the field name.

Click a field name to see all the relevant information for that field. You can also change the name of fields. For example, you could change the name of the first field from Business to Organization Name. The name change is committed after you proceed to step 3 of the wizard. Some fields cannot be changed, depending on they type of file that you opened.Click Next to update your changes to go to step 3 of the wizard.



3. Step 3 of the text file wizard allows you to select the output file. This file contains the output columns in which MapMarker UK will store the address components, result codes, and coordinate information for each matched record after you geocode.Typically, the output file uses the same base name as the input file with _out appended to the file name. This prevents you from accidentally overwriting the data in the original input file. Click OK.

Note By default, the output file is created the same folder that contains the input file. If this folder is not writable, the output file is created in My Documents\MapMarker UK\ folder. If the output file already exists, you can choose to overwrite or change the file name.

4. Click OK.5. Select the input columns from your table. See Selecting Input Columns on page 50.6. Select output columns. Standard address column names will be named with the OUT_ prefix (for

example, OUT_Town and OUT_Postcode) and these column names will be pre-populated in output column selections. See Selecting Output Columns on page 53.

Delimited File Guidelines

The Text File Wizard helps you manage how delimited files are interpreted and used in MapMarker UK. The following guidelines may help you when using the Text File Wizard.

• If you use the first line of the file for column titles (see First Line Used for Column Titles: on page 47), you can change these column titles in step 2 of the wizard. This change is committed when you proceed to step 3 of the wizard.

• Settings are remembered when you subsequently open the file. If you subsequently want to change the way first line is interpreted, you must delete the appropriate FMT file and re-run the wizard. For a description of the FMT file, see the see the Noteon page 45 with Defining Properties of Delimited Text Files

Developer Guide 49

Selecting Input and Output Address Columns

• If you want to ignore the first row in the text file (that is, not use it for either column title or data), you should remove the row from the data file. When you geocode, you can specify which rows to geocode, so you can select or skip row 1. See step 3 of Geocoding Your Table Automatically for an example of selecting a range of rows to geocode.

• Delimited text files can be geocoded automatically or interactively. See Geocoding Your Table Automatically on page 56 and Geocoding Your Table Interactively on page 57.

Selecting Input and Output Address ColumnsAfter opening your input file, you are ready to identify the address input address columns and output address columns. These are the columns that contain address information to use for the purposes of geocoding matching.


Selecting Input Columns on page 50

Selecting Output Columns on page 53

Selecting Input ColumnsFor MapMarker UK, the typical input address columns are:

MapMarker UK Input Address Columns

Input Address Example

Company Royal Mail

AddressStreet Stratford Road

Address2 (optional secondary address line)

Locality Shirley

Town Solihull

Postcode B90 3AA



The following steps describe how to identify the address input columns in your input file. After identifying the input columns, you can begin geocoding, either interactively or automatically.

1. Choose the table you wish to geocode. Click Open. 2. Click OK. A progress bar appears as your table is being updated. Then a browser window

appears, displaying the Table. You will see a dialog box titled: Select input columns from your table.

Developer Guide 51


3. Select the input columns that contain the appropriate address components. The available columns are listed on the left side of the dialog. Unformatted Address EntrySelect this button to add multiple columns from your table into a single input field. Drag each column name into the Address Fields area and make sure they are in the desired order. You can drag column names to rearrange them or use the <CLEAR> label to remove a column name.

Formatted Address EntrySelect this button to map each address column from your table into a separate input field. Drag each column name into an appropriate input field. Use the <CLEAR> label to remove a column name.MapMarker UK attempts to choose the address columns for you. It can make some determinations for fields, but if this is the first time this table has been opened in MapMarker UK, be sure to verify these columns.



Note After you have geocoded the table, the column settings are saved to the table as metadata and used for future geocoding sessions.

4. When you are finished selecting input columns, click Next. You are now ready to select output columns. See Selecting Output Columns.

Selecting Output ColumnsAfter you have selected input columns, you will see a dialog box titled: Select output columns from your table.

1. Select columns in your output table where you want MapMarker UK to store the address components, result codes, and coordinate information for each matched record. From the list of

Developer Guide 53


at the left, drag column names to the appropriate output address column. Use <Clear> selection to clear a column selection.

To avoid overwriting your input data, use output columns that have different names than the corresponding input columns. If your output columns and input columns have the same name, you receive a Warning message when you click Finish in step 3.

2. If you do not want MapMarker UK to create points for your table, clear the check box marked Create points in MapInfo table. In that case, you must select longitude and latitude columns to proceed with geocoding. (Create points is not available if you are geocoding a text file rather than a TAB file.)

3. Once you have provided all the information in the Select output columns from your table, click Finish. You are then returned to the Geocode dialog box.If your output columns and input columns have the same name, you will receive a Warning message when you click Finish. To avoid overwriting your input data, click No at the Warning message, and specify output columns that have different names than the corresponding input columns. If you need to add a uniquely named output column, click Modify Columns and follow the instructions in Adding a Column on page 55.

After selecting the input and output columns, you can begin geocoding, either interactively or automatically.


Geocoding Your Table Automatically on page 56

Geocoding Your Table Interactively on page 57



Adding a Column

You may need to add a column to either your input or output table. For example, you may want to add a uniquely named column to an output table so that you do not overwrite your input data during geocoding.

1. After opening a table and accessing the Select input columns from your table dialog, click Modify Columns. This opens the Modify Table Structure dialog.

2. Click Add Field to add a new field (and add a new column to the table). The Columns list box displays a new default 10-character column named Field# (where # is the column number in the table).

3. In the Column Information group, define the Name, Type, and Width of the new column containing the new attributes. If you are adding a new output column, this column should have a unique name but have the same type and width as the corresponding input column. For example, if the input table Placename column is defined as type Character with a width of 50, you could define and Output_Placename column with the same type and width parameters. For example:

Developer Guide 55

Geocoding Your Table Automatically

4. Click OK when done editing the new column information.5. A message appears telling you that the table must be closed and re-opened for update. Click

Yes to continue.

Geocoding Your Table AutomaticallyAfter you have opened a table and selected input and output columns, you are ready to geocode the table. To geocode automatically:

1. If the Geocode dialog is not automatically displayed upon leaving the Select Output dialog, do one of the following:• Select Table > Geocode from the MapMarker UK menu.

• Click .• Click the secondary mouse button, and select Geocode from the pop-up menu.

2. In the Geocode operations group, select Clean addresses and geocode (for street geocoding) and select Automatic from the Method drop-down list.Alternatively, you could geocode to postcode only.

3. Select the Range to Geocode and Row Numbers to geocode. By default, MapMarker UK automatically geocodes the unmatched rows. For previously geocoded tables, you may be able to improve matching by re-geocoding records that had a georesult below a specified level.

4. Set additional geocoding preferences by selecting the appropriate tabs and check boxes. For an explanation of these preferences, see Using Geocoding Options on page 69. In particular, see Match Restrictions Dialog on page 73 to apply a range of restrictive or looser match criteria, and Fallback Dialog on page 74 to permit a less precise geocoding match if the original criteria do not produce a match.

5. Click Geocode to begin geocoding. The Automatic Geocode dialog appears showing a progress bar that updates the match count every 25 records.



6. At the completion of the geocoding run, the Cancel button changes to Done. Click Done to leave the Summary dialog.Optionally, you can open the Log File dialog.The log file contains a history of the geocoding pass, including the number of matched, unmatched and previously matched records, and the number of matched records by result code. For more information on the location and use of the log file, see Log File dialog on page 147.

7. At any time during a session, you can see a summary of the geocoding results for a table by selecting View > Summary.

Note The summary is for the active table. If you run multiple tables in a single session, click on the appropriate browser title bar to make it active then select View > Summary. This will provide a summary information for the desired table,

You can also view the log file at any time by selecting View > Log file.


Automatic Geocode dialog on page 134

Geocoding Your Table Interactively on page 57

Geocoding Your Table InteractivelyAfter you have opened a table and selected input and output columns, you are ready to geocode the table. MapMarker UK allows you to geocode records interactively by choosing from a list of potential candidates. MapMarker UK attempts to geocode the row first. If it fails to find a single close match, the record is then displayed in the Interactive dialog so that you can decide what action to take.

Using interactive geocoding, you can examine potential matches, expand the search for a match, move back up the table to an earlier record, and correct your records directly from the MapMarker UK dialog.

Note You can also double-click a selected candidate to see any ranges associated with that candidate.

1. To geocode interactively, do one of the following:• Select Table > Geocode from the MapMarker UK menu.

• Click .• Click the secondary mouse button, and select Geocode from the pop-up menu.

2. In the Geocode operations group, select Clean addresses and geocode (for street geocoding) and select Interactive from the Method drop-down list.

3. Select the range and type of rows to geocode.4. Set additional geocoding preferences by selecting the appropriate tabs and check boxes. For an

explanation of these preferences, see Using Geocoding Options on page 69. In particular, see Match Restrictions Dialog on page 73 to apply a range of restrictive or looser match criteria. Fallback settings are ignored during interactive geocoding.

Developer Guide 57

Geocoding Your Table Interactively

5. Click Geocode. The Interactive Geocode dialog appears and shows the first unmatched record and a list of suggested matches. The match columns indicate the number of matches (Num), result codes (Code), Address, and Coordinates.

Blue question marks (in the Num column) indicate multiple non-close matches. Blue check marks indicate multiple close matches, and a green check mark indicates a single close match. Non-close matches do not have a check mark. See the table of Candidate Close Match Indicators on page 145.You can double-click a selected candidate to see any ranges associated with that candidate.

6. If you agree that one of the suggested candidates is a good close match, highlight this match and click Geocode. MapMarker UK assigns coordinates from that row and moves on to display the next unmatched record.

7. Select Ignore if MapMarker UK offers no match suggestions or if you do not agree with the choices in the match list.When you click Ignore, a dialog is displayed asking if you want to mark the record as “Non-geocodable.” This means that you do not want MapMarker UK to attempt to match this record during future geocoding passes. This is useful when you know the record does not geocode and you do not want it to display again in future geocoding passes. You have several choices in this dialog:• Click Yes to have MapMarker UK mark the record with the result code NG (non-geocodable).

This dialog is displayed each time you click Ignore. • Click Yes to All if you want to mark all future “Ignore” records in this geocoding session as

NG. The dialog is not displayed again during the session.• Click No if you do not wish to mark the record as NG. The dialog is displayed each time you

click Ignore on a record.• Click No to All if you do not want to mark any “Ignore” records as NG. The dialog is not

displayed again during the session.



8. To change the interactive matching conditions, click Options. The tabs, Match Settings and Multiple Match appear. Make the necessary changes to increase the potential for a match.

Note Fallback settings are ignored during interactive geocoding.

For more information on controlling these geocoding match settings and preferences, see:Match Restrictions Dialog on page 73Fallback Dialog on page 74Multiple Match Dialog on page 75

9. Click Search to search the Address Dictionary using the new matching conditions.10. Edit the record by entering new text that may increase the likelihood of a match. Click Search to

bring up a new list of suggestions that may better match the edited record. Add the edits into your table by selecting the Write selected address below to database on Geocode check box. Choose the match from the list and click Geocode. MapMarker UK geocodes the record and updates your table with your edits.

11. When the interactive geocoding pass is complete, a Geocoding Summary is displayed showing the results of the session.Optionally, you can open the Log File dialog.The log file contains a history of the geocoding pass, including the number of matched, unmatched and previously matched records, and the number of matched records by result code. For more information on the location and use of the log file, see Log File dialog on page 147.

12. At any time during a session, you can see a summary of the geocoding results for a table by selecting View > Summary.

Note The summary is for the active table. If you run multiple tables in a single session, click on the appropriate browser title bar to make it active then select View > Summary. This will provide a summary information for the desired table,

You can also view the log file at any time by selecting View > Log file.


Interactive Geocode dialog on page 145

Making the Most of Interactive Geocoding on page 59

Geocoding Your Table Automatically on page 56

Making the Most of Interactive GeocodingInteractive geocoding allows you to control the matching process because you can accept or ignore a potential match from the list of suggestions that MapMarker UK generates for the record.


Changing Matching Conditions on page 60

Editing Your Records on page 60

Developer Guide 59

Street Address Geocoding

Changing Matching ConditionsMapMarker UK follows the settings in the Geocode dialog or responds to your changed settings as you progress through the interactive pass. To increase the list of suggested matches, you can use less restrictive matching criteria. You can do this at the beginning of an interactive pass or change the settings for each record by clicking Options on the Interactive Geocode dialog on page 145.

You can also return to a previous record in the table by selecting Back and changing settings as needed. This feature can help you maximize the potential for a match.

Editing Your RecordsInteractive geocoding also allows you to correct your record to improve the possibility of a match. If you choose, your table can be updated to reflect the newly edited record, all from within the Interactive Geocode dialog.

By manually correcting the fields to put the firm, street, and town into their proper locations, the record is more logical and MapMarker UK can make better suggestions on possible matches. After editing the record, click Search to display a new list of match candidates.

To write these changes to the base table, select the Write modified address above to Input Fields on Geocode check box and click Geocode to confirm the match.

Note Your edits overwrite the address data in the respective fields, so be sure not to alter the fields containing the correct address data.

Remote Tables

Note that when you geocode remote tables interactively, MapMarker UK cannot overwrite the Input Address fields of the source table. Therefore the check box Write modified address above to Input Fields on Geocode is unavailable in the Interactive Geocode dialog when using remote tables.

Street Address GeocodingIf you provide a street address, and either a town or a postcode, you can perform an address geocode. MapMarker UK v4.5 will match your full address record against its comprehensive Address Dictionary. Minor misspellings in street addresses and suburb names are corrected in the returned candidates. MapMarker UK v4.5 will also correct postcode information or add postcodes if your input does not already include them.

MapMarker will geocode your records in accordance with the preferences you have set. See Using Geocoding Options on page 69 for information how the Desktop application allows you to control preferences and constraints.


Formatted Address Entry

Unformatted (Single Line) Address Entry



Formatted Address EntryYou can enter address information using separate fields. Each address element entered in an appropriate field.

The Company input field can contain the name of a business, organization, agency, or institution.

The Street input field can contain some or all these elements:

• building name *• unit information • house number• street name *

At least one of the asterisked * elements must be present in the Street Address.

You must also provide input in one or more of these fields:

• Locality• Post Town• Postcode – This can be the full postcode but can also be just the post district as long as other

street information or post information is present. Providing both town and postcode can produce better results than postcode alone.

Example: Geocode Address – Company, Street, Town

Consider an example in which your input table includes the following address:

Company: Pitney Bowes MapInfo LtdStreet: Minton PlacePost Town: Windsor

This returns a close match candidate when geocoded by MapMarker UK v4.5.

This example illustrates use of the MapMarker UK v4.5 Address-Point dictionary. Therefore the result code is an S8 (highest level of point precision)

If the same address was geocoded with MapMarker UK v4.5 CodePoint product, the same close match candidate would be returned but the result code would be an S3 (postcode centroid precision)

Similarly, the following addresses also return close matches. The Address-Point dictionary returns point precision results with S7 or S8 result codes if possible, or an S3 result code if point precision is not possible. The CodePoint dictionary always returns postcode centroid precision with S3 result codes.

Minton Place, Windsor (building name and town)

Minton Place, SL4 1EG (building name and postcode

18 High Street, Slough (house number, street name, and town)

Code Address Coordinate

S8 Pitney Bowes MapInfo Ltd Minton Place, Victoria Street, WINDSOR, SL4 1EG

496566.6 176621.9

Developer Guide 61


Flat 69 Victoria Street, Windsor, SL4 1EH (unit information street name, town, and postcode)

Flat 69, SL4 1EH (unit information and postcode)

61, SL4 1EH (house number and postcode)

Example: Geocode Address – Locality Alias

Consider an example in which your input table includes the following address. This uses a locality alias (Rycote). A locality alias is not technically part of a correct postal address, but can be used for input if the correct town or postcode is not known.

Street: Rycote LaneLocality: Rycote

Using the Address-Point dictionary, multiple close match candidates are returned. The first several close matches are shown below:

You have several options for dealing with multiple close matches. See Multiple Match Dialog on page 75.

Example: Geocode Address – Historic Postcode

Consider an example in which your input table includes the following address. This uses Locality Alias (Hilton) and an Historic Postcode.

Street: Printfield Terrace, Locality: Hilton (Locality Alias)Postcode: AB2 2AJ (Historic Postcode)

Using the Address-Point dictionary, the geocoding results appear as:

The new, official postcode is returned in place of the historic postcode.


S8 Interoute, Rycote Lane; Thame, OX9 2JB 468883.7 205349.1

S8 Rycote Lane; Thame, OX9 2BY 469151.5 205536.5

S8 Menlo Industrial Park, Rycote Lane; Thame, OX9 2BQ 469079.2 205411.2


S3 Printfield Terrace; Aberdeen, AB24 41J 392720.0 808512.0



Example: Geocode Address – PO BOX Input

MapMarker UK v4.5 handles PO Box addresses. Consider an example in which your input table includes the following address. This PO BOX address includes the PO BOX number plus the town and postcode.

Street: PO BOX 9220Post Town: BirminghamPostcode: B16 8UW


If the same address was geocoded with MapMarker UK v4.5 CodePoint product, the same close match candidate would be returned but the result code would be an S3 (postcode centroid precision)

The PO BOX can be specified in a number of ways. The acceptable formats for PO BOX include the following. These formats are not case sensitive.

PO BOX

P.O. BOX

P.O.BOX

PO.BOX

POST BOX

POST BOX Number

POST BOX No

POST BOX #

POST OFFICE BOX.

POBOX

POB

POSTBOX

P.BOX

PBOX

P BOX

BOX


S8 PUBLIC HEALTH & EPIDEMIOLOGY, CENTRE FOR CHILDHOOD CANCER SURVIVOR STUDIES, PO BOX 9220; EDGBASTON, BIRMINGHAM, B16 8UW

404836.0 286158.7

Developer Guide 63


Example: Geocode Address – Northern Ireland Addresses

The MapMarker UK v4.5 Address-Point and CodePoint dictionaries include the same Northern Ireland data, accurate to the postcode centroid level.

Note The Address-Point source data source does not include Northern Ireland addresses, however the MapMarker UK v4.5 Address-Point dictionary is augmented with Royal Mail® postcode data for Northern Ireland. This Northern Ireland data has postcode centroid (result code S3) precision only. Therefore, Northern Ireland addresses are geocoded to the same precision level with Address-Point or CodePoint dictionaries.


Street: 6 Royal AvePostcode: BT1 1DAPost Town: Belfast


Example: Geocode Address – Fallback to Postal

MapMarker UK v4.5 supports Fallback to postcode match when automatically geocoding tables. This means that if MapMarker UK cannot match a record to the level or precision that you have requested (such as street level), it can fall back to use less precise matching criteria. See Fallback Dialog on page 74 to select the fallback option.

Note Fallback settings are ignored during interactive geocoding, and fallback is not supported by Quick Find.

Consider an example in which your input table includes the following address with Exact Match Street names, Town, and Full Postcode selected:

Street: 20 StratfordPostcode: B90 3LTLocality: ShirleyPost Town: Solihull

Since the street type (road) was missing and Exact Match street name was specified, no initial close match is found (although non-close matches are possible). However, the fallback to postcode is successful and a Z3 close match candidate is returned.


S3 Abbey National PLC, 6 Royal Avenue; Belfast, BT1 1DA 146198.0 529839.0


Z3 20 Stratford; Shirley, Solihull, B90 3LT 411484.0 280063.0



Unformatted (Single Line) Address EntryMapMarker UK can geocode single line addresses, in which all address components appear on a single line rather than in separate fields.

Each line of your single line input data must appear in the order:

<Street Address> <Locality> <Town> <Postcode>

Not all of these address elements are required. If you omit the any of these elements, MapMarker UK still attempts to geocode the address based on the information you provided.

You can use delimiters (comma, semicolon, or slash) between each component of the address, but this is not necessary. For example, if your input table had an Address column with the following entry:

Stratford Road, Shirley, Solihull, B90 3LT

The delimiters are recognized and the address is parsed as:

If delimiters are missing in the input address, MapMarker UK recognizes spaces as separators and still successfully geocodes the address.

Example: Geocode Address – Unformatted Address Entry

For example, the following single line address includes unit information, street name, town and postcode.

Flat 69 Victoria Street, Windsor, SL4 1EH


Note If you double-click the candidate, you will see the expanded ranges for this address.

The following single line addresses can also be geocoded successfully. The result codes will vary depending on the geocoding precision.

18 High Street, Slough (House number, street name, and town)

61 Victoria Street, SL4 1EH (House number, street name, and postcode)

Street Address Stratford Road

Locality Shirley

Town Solihull

Post Code B90 3LT


S3 Victoria Street, Windsor, SL4 1EH 496533.00 176566.0

Developer Guide 65

Postal Geocoding

MapInfo Ltd, Victoria Street, Windsor (building name and town)

Note Single line input is supported in Quick Find geocoding. See Unformatted (Single Line) Address Entry on page 91.

for more information on Single Line geocoding.

Whether you identify address input columns in your input file, or use single line style input addresses, you can geocode your data automatically or interactively.

• Geocoding Your Table Automatically on page 56• Geocoding Your Table Interactively on page 57

Postal GeocodingAs an alternative to street-level geocoding, you can specify for MapMarker UK to geocode your records to the appropriate postal centroid. This is called Postal geocoding. This is a fast method of geocoding because it eliminates the need to match based on street address. This method matches the postcode in your table with the postcode in the Address Dictionary. MapMarker UK geocodes to the most precise postcode found.

Use postal centroid matching when you have a large database that you want to geocode quickly and you are less concerned with spotting the points to street level.

Postcode Structure Each postal code has two parts, separated by a space.

The first part of the postal code (outward code) contains 2-4 characters, and includes the Postcode area and Postcode district.

The second part of the postal code (inward code) is always a digit followed by two letters. The inward code includes the Postcode sector and Unit postcode. In the inward part of the code, the letters C, I, K, M, O and V are never used and the number zero is never used.

The MapMarker UK v4.5 Desktop Application can geocode to either the Post District (partial postcode) or Full postcode.

Example: Postal Geocode – Close match candidate based on postcode.


Street: Stafford RoadPostcode: B90 3LT

If you select Geocode to postcode only on the Geocode tab, a Z3 close match postal candidate is returned. This is a close postal match even though the correct street name (Stratford) was misspelled as Stafford.

See Geocoding with Quick Find on page 89 for examples of Postal geocoding with Quick Find.


Z3 Stratford Road; Shirley, Solihull, B90 3LT 411484.0 280063.0



Postal Geocoding OptionsWhen you are geocoding a table, you can set the Match Restrictions and require exact match on either Post district or Full Postcode. See Exact Match On on page 73. After setting the Match Restrictions, use the Geocode tab to geocode your table.

After opening your table and selecting columns, follow these steps to geocode to postal centroids:

1. In the Geocode dialog, from the Geocode operations group select Geocode to postcode only. 2. Choose the range and type of rows you want to geocode. 3. Click Geocode.

4. When through, click Done to view the log file or return to the MapMarker UK menu.

Note Your input must include valid street names in order to successfully geocode to postcode centroids.

Developer Guide 67

Displaying Geocoded Records in MapInfo Professional

Displaying Geocoded Records in MapInfo ProfessionalAfter MapMarker UK geocodes your records, you can display them in MapInfo Professional or MapX to analyze your data geographically.

1. Close your table in MapMarker UK and open it in MapInfo Professional or add it to your MapX geoset. The points are displayed with color-coded symbols that represent the level of geocoding precision for the record, as described below.• Magenta stars: all records matched to a single address point. No interpolation is required

(S8 result code)• Orange stars: all records geocoded an interpolated point along the candidate’s street

segment (S7 result code)• Blue stars: all records geocoded to a shape path centroid (S4, M4 result codes) • Yellow stars: all records geocoded to apostcode centroid (S3, M3 and Z3 result codes)

See Result Codes in Chapter 7 on page 119 for an explanation of the types of result codes.2. Add other map layers such as MapMarker UK Streets or postcode boundaries to give your points

a geographic reference. For example, a you could create a map that showed postal districts, major roadways, cities, and your customer data geocoded to postcode centroids (represented by yellow stars). This gives you a powerful way to visualize your data with a location information.



Re-Geocoding a TableAfter you have geocoded a table, existing records may be updated or new records may be added, so you may need to geocode again. New or previously ungeocoded records (records that do not have result codes) can simply be re-geocoded. By default. MapMarker UK automatically geocodes only unmatched records. This means that for a large database, previously matched records are not re-matched, thus saving time.

Records that already contain coordinates, but are incorrect (due to a change in address for example), should be identified and the result codes should be deleted. MapMarker UK treats any record without a result code as an unmatched record and attempts to find a match. MapMarker UK also re-geocodes records with “N” or “ND” codes.

Your records may already include geometry objects (such as points) that were added from another source (such as from MapInfo Professional). MapMarker UK can create or replace the points for matched geocoded records if you specify Create Points when you map output columns. See step 2 in Selecting Output Columns. MapMarker UK deletes existing points for records that it cannot match.

Using Geocoding OptionsThis section discusses geocoding matching options that are available from the tabs in the Geocode dialog. These preferences affect the conditions under which MapMarker UK attempts to match a record. This includes automatic or interactive geocoding, exact matching settings, fallback options, how to handle multiple matches, log file setup, and table attribution.

Geocoding options and preferences give you a great deal of control over the accuracy and precision of your geocoding operation. Among the capabilities are:

• Specify the level of geocoding precision, automatic or interactive geocoding, and the range of records to geocode.

• Specify criteria that must be matched (match restrictions) to return a close match candidate.• Specify Fallback to postcode match to broaden the possible candidate list in case a close match

is not initially identified. • Determine how to choose candidates when multiple candidates are identified as close matches

(Do not match or Accept first match).• Geocode only records that were not previously geocoded, or that were geocoded below a

specified precision level (for example less than an S5 result code).

Changing match settings can affect the hit rate of successfully geocoded records. It can also affect the time it takes for MapMarker UK to geocode a table, as well as the precision with which the geocoded record is displayed on a map. It is important to keep in mind your intended use of geocoded data when setting these conditions. These settings are set for individual tables and the information is stored in the table’s metadata.

Accept or change any of the matching criteria to fit your needs. For example, by deselecting Exact Match requirements, MapMarker UK can potentially match more records, but may return some false positives.

Developer Guide 69

Using Geocoding Options

To set geocoding preferences for a table:

1. On the Table menu, click Geocode. The Geocode dialog appears.2. Choose the settings you want from any of the geocoding preferences tabs: Geocode, Log File,

Match Settings, Fallback, or Multiple Match. 3. Click Apply to set the changes or Geocode to geocode immediately.

For information on each of the tabs, see:

Geocode Dialog on page 70

Log File Dialog on page 72

Match Restrictions Dialog on page 73

Fallback Dialog on page 74

Multiple Match Dialog on page 75

Geocode DialogThe Geocode dialog allows you to select a variety of preferences that control the method, precision, range, and levels of geocoding.

Geocode Precision

Geocoding precision is a measure of how close a match is to the true location of the record you want to geocode. By default, MapMarker UK will attempt to geocode to the street address level (Clean addresses and geocode button). You still can have the option of falling back to a postcode match if a street address cannot be matched. See Fallback Dialog on page 74.

You can also select Geocode to postcode only to geocode to the postal centroid level. In that case, the best possible match is to a postal centroid, even if an address contained street information.



Street Level Geocoding Method

The geocoding Method list allows you to select Automatic or Interactive geocoding for street address geocoding.

For automatic geocoding, the operation continues until all records are processed or the operation is cancelled. For interactive geocoding, MapMarker UK geocodes records automatically, but stops on each record for which it cannot make a single match. You can then choose the best match from a list of candidates.

Type of Rows to Geocode

The Unmatched Rows selection means that MapMarker UK attempts to geocode addresses in your input table only if those addresses have not previously been matched (rows for which the GeoResult field: blank or N). Addresses that already have been geocoded are not re-geocoded. Unmatched Rows is the default selection.

You can click All Types to geocode all rows, regardless of whether they have been previously geocoded. You can also click Georesult less than and select a level of geocoding from the drop-down list. This re-geocodes addresses that were originally matched below the given level of precision. Use Georesult less than only with a table that has already been geocoded. If you use this option with a table that has not been geocoded, MapMarker UK geocodes all of the rows regardless of this selection.

Range to Geocode

The All Rows selection means that MapMarker UK attempts to geocode all rows in your input table. You can also select Row Numbers and select a range of row numbers for geocoding.

Attribution Bindings

MapMarker UK has the ability to add information from one table to another, either before, during, or after the geocoding process. This ability is called attribution binding.

To begin the process of attribution binding (or simply to display or modify existing attribute bindings), click Configure Attribution. This displays the Bind Attribute Table Columns to Output Columns dialog.

Table attribution described fully in the topic Table Attribution with MapMarker on page 98.

For related information, see:

Using Geocoding Options on page 69Log File Dialog on page 72Match Restrictions Dialog on page 73Fallback Dialog on page 74Multiple Match Dialog on page 75

Developer Guide 71


Log File DialogThe log file is a text file that MapMarker UK generates during geocoding that contains setup and processing information about the geocoding session. If you do not specify another name, the log file is named mapmarkr.log and contains the results of the session, including number of matches, non-matches, previously matched records, and the number of matched records by result code. MapMarker UK appends new information to the top of the log file after each geocoding pass.

By default, the log file is written to the mapmarkr.log file in the user’s My Documents area (typically C:\My Documents\MapMarker_UK\). MapMarker UK batch files are also written to this area by default.

The maximum file size for the log file is 1 MB.

Note By default, the error files IgnoredErrors.txt and ODBCErr.log are created in:

Documents and Settings\All Users\Application Data\MapInfo\MapMarker\UK\4.0

On the Geocoding dialog, select the Log File tab to control log file options.

To specify a different log file name, select the Specify Log File Name check box in the Log File tab of the Geocode dialog. You may enter a path as well as a name for the log file (for example, c:\temp\UK_addr.log). If the path specified is invalid, MapMarker UK creates mapmarkr.log in the My Documents\MapMarker UK folder.

In Windows 2000/2003/XP, you must close the log file from a previous session before you can open the table it refers to in MapMarker UK. If you do not, a message that the table may not have read/write access is displayed. Close the table in the text editor to proceed.


Using Geocoding Options on page 69Geocode Dialog on page 70)Match Restrictions Dialog on page 73)Fallback Dialog on page 74 Multiple Match Dialog on page 75)



Match Restrictions DialogThe Match Restrictions tab lets you specify how precisely MapMarker UK matches input addresses against the Address Dictionary. By adjusting match settings, you can control whether MapMarker UK requires a very precise match, an looser match, or an intermediate level of matching. The best choice for you depends on the nature of your data and the requirements of your application.

Exact Match On

Use the Require Exact Match On criteria to fine-tune your control over geocoding matching preferences. You can specify precise matching criteria based on house number, street name, town, and postcode. If all specified criteria are not met, then the geocoded candidate is not considered a close match.

Exact Match Restrictions

Exact Match Description

House number When the House Number box is checked, candidate house numbers must be exactly matched to return a close match. When the House Number box is unchecked, MapMarker UK can make a close match even if the house number match is not exact.

Street name When the Street Name box is checked, candidate street names but be exactly matched to get a geocoding match. When the street name box is unchecked, MapMarker UK will accept similar street names as a match.

This requires an exact match on all elements of the street name. Also, blank input values for these elements will not match non-blank values in the candidate records.

Developer Guide 73


Fallback DialogIf MapMarker UK cannot match a record to the level or precision that you have requested (such as street level), it can fall back to use less precise matching criteria. Select the Fallback tab to control these fallback options.

Town When the Town box is checked, MapMarker UK requires a town match. When this box in unchecked, the townname does not have to match.

Postcode When Postcode is checked, you can match to Post District or the Full Postcode. For Full Postcode, the complete postcode must be exactly matched to get a close match. However, if the postcode is omitted from input, (or an invalid postcode is entered) you may still get multiple close matches.

A Post District match requires a match on the first part of the postcode (usually the first three characters) and a match on Street name. If the Street name is not matched, you will not get a close match candidate even if the Post District does match.

If neither Postcode match restriction is selected, then a close match can be made regardless of the postcode input.

Clear Output Columns if No Match

If checked, clears existing output values for a record if a match cannot be made. For example, your table may contain longitude and latitude values obtained from another source, and you want to maintain that information if MapMarker UK cannot match the record. If not checked, the output information is kept intact even if a geocoding match is not made.

Exact Match Restrictions (continued)



For example, you can fall back to match to the full postcode if you have selected the Fallback to postcode match check box in the Fallback tab. By default, MapMarker UK does not fallback to postcode centroid.

Note Postal fallback is supported when automatically geocoding tables. Postal fallback is not supported by Interactive geocoding or by Quick Find geocoding.


Using Geocoding Options on page 69Geocode Dialog on page 70 Log File Dialog on page 72Match Restrictions Dialog on page 73Multiple Match Dialog on page 75

Multiple Match DialogIf MapMarker UK determines that more than one match candidate exists for a record, it follows the instructions in the Multiple Match tab. Multiple match candidates are potentially strong matches, but none of them stands out enough from the others to be considered the definitive match.

Select the Multiple Match tab to control the multiple match options.

The Multiple Match Options table describes multiple match preferences and how they are used to filter multiple match results. See also, A Closer Look at Multiple Matches on page 85.

Multiple Match Options

Multiple Match Option Description

Do Not Match Click this option to disallow any matches for the record if multiple matches occur.

Accept First Click this option to accept the first candidate for the match.

Developer Guide 75

Saving TAB Files


Using Geocoding Options on page 69Geocode Dialog on page 70Log File Dialog on page 72Match Restrictions Dialog on page 73Fallback Dialog on page 74

Saving TAB FilesWhen you save a TAB file, MapMarker UK saves your geocoding settings and stores them as metadata in your table. These settings include columns mappings and geocoding preferences (such as match settings and fallback settings). The next time you open the TAB file in MapMarker UK, you can proceed directly to geocoding. You can view the settings by opening the TAB file in a text editor and examining the section called Metadata.

You can save a TAB file and its associated metadata as a MapMarker UK project. A project preserves additional settings and preferences and supersedes any settings in the associated TAB file. See Creating and Saving a Project.

You can also save a delimited text file and its associated metadata as a MapMarker UK project.

Note You must use a project to perform batch geocoding of a delimited text file. For more information on batch geocoding, see Batch Geocoding on page 94.

Creating and Saving a ProjectAfter you open an input file and perform column mappings, you can save the file as a project (PROJ file extension). A project preserves the settings used for geocoding a table, including column mappings and geocoding preferences. When you use a project, the project information supersedes the information stored in the table’s metadata.

You can also create a project based on an ODBC input. However, there are limitations on running an ODBC-based project from a batch file. See the Note in the discussion of Batch Geocoding on page 94.

When you open a project, settings and preferences are restored, including:

• column mappings• settings on the Geocode dialog (Geocode, Log File, Match Settings, Fallback, and Multiple

Match tabs)• table attribution settings, if any• System Preferences on the Dictionary and Datum tabs.• relevant ODBC file names, locations, and settings

To save a project, first open the input file, perform column mappings, and set geocoding preferences as you normally would. See Opening a Table or Text File on page 44 and subsequent topics. Then follow these steps:



1. From the MapMarker UK menu, Select File > Projects > Create/Save Project. In the Save Project File As dialog box, type a project name. A PROJ file extension is used.

When you subsequently open the project, settings and preferences are restored. For example, if you had created a project with changes to the default geocode, match settings, and fallback preferences, all of these settings are restored when you open the project.

You can create multiple projects based on the same TAB or text input file. By creating unique projects based on the same input data, you can design, preserve, and manage multiple geocoding strategies customized to suit your needs. For example, you could create a project named ExactMatch that performs geocoding based on the Exact Match rules and preferences that you specify and another project named PostCodeMatch that requires less restrictive postcode matching only.

To open and run a previously saved project, see Opening and Running a Project on page 43.

You can also run a project from the command line using a project-based batch file. See the following topics:

Creating a Project-Based Batch File on page 77

Creating a Batch Geocoding File from a TAB File on page 95

Creating a Project-Based Batch FileAfter creating a MapMarker UK project, you can create a batch file to execute the project. Using a project-based batch file is the only way to perform batch geocoding of a CSV or TXT file.

Note For TAB files, you can create a a batch file without creating a project. This procedure is described in Creating a Batch Geocoding File from a TAB File on page 95. However you can also use the project-based batch file approach for TAB files.

Developer Guide 77

Creating and Saving a Project

First create the MapMarker UK project, as described in Creating and Saving a Project on page 76. To create a batch file that executes a MapMarker UK project, follow these steps:

1. From the MapMarker UK menu, select File > Create Project-based Batch File.2. In the Select Project Files dialog, navigate to the directory that contains the project file. Select

the project file that you want to run in batch and click Add to move it into the Selected Projects column. You can run multiple projects from the same batch file. See Multiple Pass Batch Geocoding Strategy on page 79.

3. Click OK to open the Save Batch File As dialog. Use the Save in drop-down selection to navigate to the directory where you want to save the batch file. Accept the default file name or change the name of the BAT file. Click Save.

You can also create a project-based batch file manually, as described in Manually Creating a Project-Based Batch File on page 97. That topic also shows an example of what the batch file looks like.

A project-based batch file points to the MapMarker UK executable and runs the project file. The location of the input file, names of columns, and geocoding preferences are encapsulated in the project (PROJ) file itself. A project-based batch file might appear as follows:

"C:\Program Files\MapInfo\MapMarker_UK_v4\desktop\mapmarkerUK.exe" /Proj=C:\My Documents\MapMarker UK\Projects\ExactMatch.proj



Multiple Pass Batch Geocoding StrategyFor a project based on TAB file, you can use a batch file to run multiple geocoding passes on the same TAB file. For example, the batch file could run the "Exact" match project on an input address file TAB file followed by a "Relaxed" match project on the same TAB file. This strategy allows you to perform batch geocoding based on precise Must Match criteria, then perform a less restrictive second pass on addresses that did not geocode during the first pass.

There is one important guideline for using this strategy on TAB files. While the Exact match project would typically geocode all records (All Types in the Geocode dialog), the Relaxed match project should geocode Unmatched Rows only. This ensures that the output from the Relaxed match geocoding pass does not overwrite the output from the initial Exact match pass.

For a project based on a delimited or text file (CSV or TXT), you cannot do multiple batch geocoding passes of the same address file because the initial output file will be overwritten. That is, a UK_CustomerAddress_out.csv file created by the Relaxed match batch geocoding pass will overwrite the identically named output file that was initially created by the Exact match pass. Therefore, project-based batch files that use CSV or TXT files should specify different input files.

Developer Guide 79

4
Match Settings and Strategies
In this chapter:

Using Match Settings to Control Geocoding Precision . . . . . . . .81Choosing Match Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81Picking Your Strategy: An Example . . . . . . . . . . . . . . . . . . . . . . . .82Impact of Relaxing Match Conditions . . . . . . . . . . . . . . . . . . . . . .84A Closer Look at Multiple Matches. . . . . . . . . . . . . . . . . . . . . . . . .85

Chapter 4: Match Settings and Strategies

Using Match Settings to Control Geocoding PrecisionThe Geocode dialog includes tabs that allow you to control the Match Restrictions, Fallback, and Multiple Match settings for a geocoding pass. This is where you set MapMarker UK to be as strict or relaxed as you need by selecting or clearing the appropriate check boxes.

Each of the settings affect the match rate, performance, and the positional accuracy of the geocoded point. You must decide the settings that best fit you strategy and needs. See Choosing Match Strategies on page 81.

Default Settings The default settings, which generally give you the best compromise among match rate, accuracy, and performance, are:

• By default, MapMarker UK is set to Must Match Town and Must Match Post district. See Match Restrictions dialog on page 148.

• Do not fall back to postcode match. Uncheck this setting in the Fallback dialog. See Fallback dialog on page 140.

• Do not match if there are multiple match candidates. Uncheck the setting in Multiple Match dialog. See Multiple Match dialog on page 150.

Choosing Match StrategiesYou can use several matching strategies, including:

• Maximizing the Match Rate on page 81• Maximizing Geographic Accuracy on page 82• Balancing Match Rate and False Positives on page 82

You can choose one method or use them in combination.

Maximizing the Match RateTo generate the highest match rate possible, relax the match restrictions on house number, street names, town, and postcode in the Match Restrictions tab by unchecking those boxes. Relaxing the matching conditions tells MapMarker UK to broaden the area in which it searches for a match.

To maximize the potential for a match, tell MapMarker UK what to do if it does not find a match. These settings include Fallback to postcode match (in the Fallback tab) and Accept First (in the Multiple Match tab See Fallback dialog on page 140 and Multiple Match dialog on page 150.

While this strategy likely yields false positives, this may be the best match solution when you have large databases that need to be geocoded. You must decide if the percentage of false positives affects your analysis.

Note You can evaluate false positives if you have MapMarker UK use output columns to store the returned street, town, and postcode values. See Selecting Input and Output Address Columns on page 50. Look for false positives by comparing the input address with the output address.

Developer Guide 81

Picking Your Strategy: An Example

To further reduce the number of false positives without sacrificing hit rate, analyze the result codes after a geocoding session and re-geocode interactively. See Result Codes in Chapter 7 on page 119 for more information on result codes.

Maximizing Geographic AccuracyIf positional accuracy of the geocoded records is the most important aspect for you, choose a strategy in which MapMarker UK returns the lowest number of erroneous matches. To do this, you must require MapMarker UK to find exact matches for all portions of the address—house number, street name, town, and postcode. Also, do not accept the first of multiple matches or fall back to postcode centroid. The unmatched records will then remain ungeocoded.

The strictest matching conditions require an exact match on house number, street name, town, and postcode. In that case, MapMarker UK is looking for an exact street address match within the town and postcode in your input address.

Choose this scenario when your analysis requires precise locations for your records. To increase the number of matches, your next step might be to use interactive geocoding. Interactive geocoding is explained in Making the Most of Interactive Geocoding on page 59.

Balancing Match Rate and False PositivesYou may want to use a balanced strategy between match rate and geographic accuracy. That is, you may want to geocode as many records as possible automatically, but at the same time want to minimize the number of erroneous matches (false positives). Rather than generate false positives, you could leave those records ungeocoded so that you can geocode them interactively later. You may want to analyze your data at a local level where the location of each record on a map is important.

MapMarker UK may return false positives when it:

• finds a street that sounds like the input street. • finds the same street in another town (if must match town is relaxed).• finds the street but with a different house number (if must match house number is relaxed).

MapMarker UK, however, contains a sophisticated matcher that usually finds the correct address.

MapMarker UK default settings reflect this balanced strategy—exact match is required for town and post district, but is relaxed for house number and street name.

Picking Your Strategy: An ExampleThe following scenario outlines a three-pass geocoding session based on the strategy of maximizing the match rate. See Maximizing the Match Rate on page 81 for an overview of that strategy. You want to generate the highest match rate for a large database while minimizing false positives. The goal during the session is to set the conditions for that strategy in the first pass, then follow with an interactive session to pick up additional matches, and finally, a third pass to geocode any remaining records.



First Pass on page 83

Second Pass on page 83

Third Pass on page 83

One Pass Settings on page 83

First PassGeocode the table automatically with the settings that generate the highest match rate with the fewest false positives:

• Require exact match on all criteria.• Do not accept first of multiple matches.• Do not fallback to postcode centroid matching.

All records geocoded during this pass are exact or close matches that geocode to the street level. Depending on the cleanliness of your data, the majority of your table is processed during this pass. This pass generates the least number of false positive matches.

Second PassFor this pass, geocode all unmatched rows interactively with the following settings:

• Relax the settings for house number and street name.• Do not accept first of multiple matches.• Do not fallback to postcode matching.• Edit the input address where necessary (such as to correct obvious input errors) to increase the

likelihood of a match.

Each match in this pass is geocoded to town and postcode accuracy. Since you are in interactive mode, you confirm every match and therefore you can minimize the number of false positives.

You can also change the match settings, expand the Search, map the match candidates, and edit the record to find additional matches.

Third PassDo a final geocoding pass on unmatched rows by geocoding with:

• all constraints relaxed• for multiple matches, accept the first match• fallback to postcode

One Pass SettingsIf you do not want to geocode your table interactively, combine the first and third passes using the following settings in the Options dialog:

• Require exact match on town and postcode. Relax house number and street name match.• Do not accept first of multiple matches.

Developer Guide 83

Impact of Relaxing Match Conditions

• Select Fallback to postcode match.

Impact of Relaxing Match ConditionsConsider the following when you change the Match Restrictions in the Geocode dialog.

See Match Restrictions Dialog on page 73 for a detailed description of the choices in this dialog.


Relaxing Postcode on page 84

Relaxing Town Name on page 84

Relaxing Street Name on page 84

Relaxing House Number on page 84

Relaxing PostcodeWhen Postcode match is relaxed, MapMarker UK searches a wider area for a match. While this causes slower performance, the match rate is higher because MapMarker UK does not need to exactly the full postcode when it compares match candidates.

We recommend that you relax the full postcode match but use the Must Match Post district constraint. This will ensure that candidates are in the correct post district and will eliminate false positive candidates.

Relaxing Town NameWhen town name matching is relaxed, MapMarker UK searches on the street address matched to the particular postcode, and considers other towns that do not match the town name.

Relaxing Street NameMapMarker UK looks at all candidates with names that sound like the input address. This slows down MapMarker UK’s performance. However, since more candidates are examined, the match rate increases.

Relaxing House NumberPerformance is not significantly affected when the house number setting is relaxed.



A Closer Look at Multiple MatchesA multiple match is when MapMarker UK finds more than one record in the Address Dictionary that covers the same address range. Multiple match candidates are potentially strong matches, but none of them stands out enough from the others to be considered the definitive match. You can control how you want MapMarker UK to respond when it encounters a multiple match.

Select the Multiple Match tab to control the multiple match options.

The Multiple Match Options table describes multiple match preferences and how they are used to filter multiple match results.

Consider the following example.

Street: 3 Eigie Farm CottagesStreet2: Eigie RoadLocality: BalmediePost Town: AberdeenPostcode: AB23 8XT

Multiple Match Options

Multiple Match Option Description

Do not match Click this option to disallow any matches for the record if multiple matches occur. During interactive geocoding, MapMarker UK stops at that record and waits for your response. Sometimes it finds multiple matches, even though there is a candidate that appears to be an exact match.

Accept first Click this option to accept the first candidate for the match.

Developer Guide 85

A Closer Look at Multiple Matches

During interactive geocoding, multiple close match candidates are returned (assuming that you selected Do not match as the Multiple Match option).

MapMarker UK determined that there are multiple close matches for the input address. Blue check marks indicate the multiple close matches. In this case, the user selected the second listed candidate as the preferred candidate. Click Geocode to geocode that record and proceed with interactive geocoding.See Geocoding Your Table Interactively on page 57 for more information on interactive geocoding.


5
Specialized Geocoding Features
This chapter covers a number of specialized MapMarker UK features, including Quick Geocoding, Quick Find, batch geocoding, and table attribution.

You can also geocode remote tables. See Geocoding Remote Tables in Chapter 6 on page 107 for information on that topic.

In this chapter:

Geocoding dBASE Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88Geocoding Delimited and CSV Files . . . . . . . . . . . . . . . . . . . . . . .88Using Quick Geocode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88Geocoding with Quick Find. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89Batch Geocoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94Table Attribution with MapMarker. . . . . . . . . . . . . . . . . . . . . . . . . .98Adding Attributes to Your Table . . . . . . . . . . . . . . . . . . . . . . . . . .103

Geocoding dBASE Files

Geocoding dBASE FilesMapMarker UK reads dBASE format (DBF) as well as MapInfo native format (TAB) files, enabling you to turn any table of records into geographic objects. This section explains some things to keep in mind when geocoding DBF files.

MapMarker UK creates a TAB file automatically when you open a DBF file. If you open the DBF file a second time, a dialog appears stating that a TAB file already exists. Select Yes to replace it.

Since MapMarker UK automatically creates a TAB file for any DBF file you open, all of the options available to TAB files apply to DBF files. Among them, MapMarker UK adds coordinate and result columns and creates points for your table automatically.

MapMarker UK does not display memo fields included with DBF files. The fields are not changed in any way by MapMarker UK.

MapMarker UK does not maintain indexes for DBF files. If you write to an indexed field during geocoding, the table must be re-indexed outside of MapMarker UK if you wish to maintain the index.

Geocoding Delimited and CSV FilesMapMarker UK reads and writes delimited text files, CSV, TXT, and DBF files. After opening these files, you can use a Text File wizard to set properties for the input file.

See the following topics in Chapter 3: Geocoding with MapMarker UK:

Opening a Table or Text File on page 44.

Defining Properties of Delimited Text Files on page 45

Using Quick GeocodeQuick Geocode is a shortcut to geocoding your table with MapMarker UK. Use it to geocode previously opened tables with a single click. For example, use Quick Geocode on tables that you update frequently and need to geocode new records. Quick Geocode follows the geocoding preferences and system preferences settings you specify to carry out the geocoding operation.

Quick Geocode is available after you open a table in MapMarker UK and set the input and output columns, geocoding, and system preferences. You can geocode the entire table or a portion of the table. When you close the table, the settings are written to the table’s metadata and the system registry, preserving your preferences for the next time you need to geocode the table.

Note MapMarker UK attempts to geocode all records in the table during a Quick Geocode pass, regardless of their previous geocoding status.


Chapter 5: Specialized Geocoding Features

Geocoding with Quick FindThe MapMarker UK Quick Find feature provides a fast way to determine the correct address for a single record. If there are several match candidates to choose from, you can then select the best choice.

Quick Find can generate the following kinds of results.

• street addresses• postal addresses (however Postal fallback is not available with Quick Find)

The number and type of candidates returned by Quick Find depends on the criteria set in Quick Find Settings on page 93. Use those settings to select match restrictions.

Street Geocoding with Quick FindFollow these steps to street geocode a single address with Quick Find:

1. Select Search > Quick Find to display the Quick Find dialog box.2. Select either Unformatted Address Entry or Formatted Address Entry. With Unformatted

Address Entry, you can type the entire address in one field. With Formatted Address Entry, you enter each address element in its own input field. For a detailed description of Unformatted (Single Line) Address Entry, see Unformatted (Single Line) Address Entry on page 91.

3. Type the address you wish to find and click Search. This example assumes Formatted Address Entry with an input address of:Street: Stratford RoadPost Town: SolihullPostcode: B90 3LT

This produces a single close match candidate with an S3 result code.


S3 Stratford Road; Shirley, Solihull, B90 3LT 411484.0 280063.0

Developer Guide 89

Geocoding with Quick Find

The results appear as:

Note A green check mark in the Num column indicates a close match. Street browse or place browse candidates do not have a ResultCode or close match indicator.

If you want to expand all candidates to their ranges, select Expand Ranges as Candidates from the QuickFind Options dialog. To select that option, see Quick Find Settings on page 93.

Note You can also double-click a selected candidate to see any ranges associated with that candidate.

Expand Ranges as Candidates

By default, if a street has multiple addresses/delivery points, MapMarker UK v4.5 returns a single close match with each individual delivery point available as a range. If you want to expand all candidates to their ranges, select Expand Ranges As Candidates from the Quick Find Options dialog. In that case, MapMarker UK v4.5 returns each range as a separate close match candidate.

If you Expand Ranges as Candidates, the Stratford Road, Solihull, B90 3LT example returns the ranges as separate close match candidates. The first few candidates are:

Note that these range candidates have an S8 level of precision.


S8 2 Stratford Road; Shirley, Solihull, B90 3LT 411443.2 280129.8





The results appear as:

Note A blue check mark in the Num column indicates multiple close matches.

Copying Information from the Quick Find Candidate List

You can copy a candidate address to the clipboard. To copy a Quick Find candidate address, right click on the address in the candidate list and click the Copy Address popup selection. You could then copy this address into another application.

Unformatted (Single Line) Address EntryMapMarker UK can geocode single line addresses, in which all address components appear on a single line rather than in separate fields.

Each line of your single line input data must appear in the order:

<Street Address> <Locality> <Town> <Postcode>

Not all of these address elements are required. If you omit the any of these elements, MapMarker UK still attempts to geocode the address based on the information you provided.

You can use delimiters (comma, semicolon, or slash) between each component of the address, but this is not necessary. For example, if you input:

Stratford Road, Shirley, Solihull, B90 3LT

Developer Guide 91

Geocoding with Quick Find

The delimiters are recognized and the address is parsed as:

If delimiters are missing in the input address, MapMarker UK recognizes spaces as separators and still successfully geocodes the address.

Example: Geocode Address – Unformatted Address Entry

For example, the following single line address includes unit information, street name, city and postcode.

Flat 69 Victoria Street Windsor SL4 1EH


If you double-click the candidate, you will see the expanded ranges for this address.

Street Address Stratford Road

Locality Shirley

City Solihull

Post Code B90 3LT


S3 Victoria Street, Windsor, SL4 1EH 496544.00 176566.0



The following single line addresses can also be geocoded successfully.

18 High Street Slough (house number, street name, and city)

61 Victoria Street SL4 1EH (house number, street name, and postcode)

Pitney Bowes MapInfo LTD Victoria Street Windsor (company, building name and city)

Postal Geocoding with Quick FindYou can also use Quick Find to quickly geocode a single address to a postcode centroid. For example, enter the address:

Postcode: B90 3LT

This example produces a single close match candidate with an S3 result code.

While you can use Quick Find to geocode a postcode centroid, postal fallback is not supported by Quick Find.

Quick Find SettingsYou can change the criteria used for generating your Quick Find search results.

To change the Quick Find settings:

1. Open the Quick Find dialog (see Geocoding with Quick Find on page 89.2. Click Quick Find Settings.

The Quick Find Settings dialog appears.3. Click Options to display the Quick Find Options dialog.4. Select the settings you wish to use and then click OK.

Developer Guide 93

Batch Geocoding

Batch GeocodingMapMarker UK supports batch geocoding for geocoding one or more files without user interaction. You create a batch file containing the path and file names of the tables to geocode and specify the geocoding preferences you want applied to the session.

Batch geocoding is useful for overnight processing of large databases or when a table is updated regularly via a scheduling program.

Note You can batch geocode MapInfo TAB files, comma-delimited (CSV), text files (TXT), and project files (PROJ). However, you usually cannot batch geocode ODBC database files, since a password is typically required and that requires user intervention.

The procedure for creating a batch file varies depending on whether the input file is a TAB file or other file type. See the following topics:

Creating a Project-Based Batch File on page 77

Quick Find Settings

Quick Find Setting Description

House number Check this box to require the use of house number in determining an exact match.

Street names Check this box to require the use of street name in determining an exact match.

Town Check this box to require the use of town name in determining an exact match.

Postcode Check this box to require the use of postcode in determining an exact match. When Postcode is checked, you can match to Post District or the Full Postcode.

Post district A Post District match requires a match on the first part of the postcode (usually the first three characters) and a match on Street name. If the Street name is not matched, you will not get a close match candidate even if the Post District does match.

Full Postcode For Full Postcode, the complete postcode must be exactly matched to get a close match. However, if the postcode is omitted from input, (or an invalid postcode is entered) you may still get multiple close matches.


By default, if a street has multiple addresses/delivery points, MapMarker UK v4.5 returns a single close match, with each individual delivery point available as a range. If you prefer to get multiple close matches (one for each delivery point on the street), check the Expand Ranges as Candidates check box.



Creating a Batch Geocoding File from a TAB File on page 95

Creating a Batch Geocoding File from a TAB FileTo create a batch geocoding file from a TAB file, follow these steps:

1. Open a table in MapMarker UK and proceed through the select column dialogs to confirm the input and output columns. See Selecting Input and Output Address Columns on page 50.

2. When you have finished specifying input and output columns, use the tabs in the Geocode dialog to select your geocoding settings. After selecting the settings, click Apply. Click the dialog Help buttons to learn more about each geocoding option.

3. When done with the settings, click Cancel in the Geocode dialog then choose Table > Create Batch File. The Save Batch File As dialog appears.

4. Specify the path and filename for the batch file. By default the batch file uses the root file name of the table with the extension *.bat. Click Save.

5. Repeat step 1 through step 4 for each additional table you want to include in the batch file. When saving to an existing batch file, such as the one initially created in step 4, the name of the table is appended to the end of the batch file. To create a new batch file, use a new filename.

Note If you want to batch geocode CSV or TXT files, you must create a project (PROJ file) to accomplish this. For information on creating a project, see Creating and Saving a Project on page 76. To run a project from a batch file, see Creating a Project-Based Batch File on page 77.

To run a batch file, double-click on the filename in Windows Explorer. MapMarker UK starts running and opens each table listed in the batch file in turn and then geocodes it to the specified settings. If MapMarker UK encounters an error, it stops.

Manually Creating a Batch Geocoding File Base on TAB FileFor TAB files, you can create a a batch geocoding file without using a project. To do this, create a BAT file in a text editor and indicate the following:

• the path and filename of the MapMarker UK executable program

Developer Guide 95

Batch Geocoding

• the path and filename of the TAB file• any geocoding preferences that you want MapMarker UK to follow

The parameters can be listed in any order and can use uppercase, lowercase, or mixed case text. You must also open the table in MapMarker UK at least once and set the preferences. Otherwise MapMarker UK will geocode using the default settings for that table as found in the metadata.

The batch geocoding parameters for a TAB file are described in following table: Batch Geocoding Parameters for TAB File. These parameters are only used for batch files based on TAB files. For project-based batch files, the preferences and parameters are encapsulated in the project file itself.

Batch Geocoding Parameters for TAB File

Parameter Description

/TABLE=c:\sample\table Path and filename of table to geocode.

/LOG=<logfile name> Name of log file. MapMarker UK writes the geocoding results to this file. If a log file is not specified, MapMarker UK creates a default Mapmarkr.log file. For more information on the location and use of the log file, see Log File dialog on page 147.

/START=<number> Specify the starting row number to geocode. If omitted, MapMarker UK begins with row 1.

/END=<number> Specify the ending row number to geocode. If omitted, MapMarker UK ends at the end of the table.

/ALL or /UNMATCHED Specify whether to geocode all records or only unmatched records.

/CLEAN_GEO Specify Y to clean addresses before geocoding.

/EXACT_HOUSE=Y,N Specify Y for exact match of house number.

/EXACT_STREET=Y,N Specify Y for exact match of street name.

/EXACT_TOWN=Y,N Specify Y for exact match of town name.

/EXACT_PC=Y,N Specify Y for exact match of postcode.

/EXACT_DCT=Y,N Specify Y for exact match of post district.

/STREET_ONLY=Y,N Geocode to street level.

/FALLBACK=POSTCODE,N Specify whether MapMarker UK falls back to a full postcode.

/MULTI=NO,FIRST Specify how MapMarker UK handles multiple matches:

• No = do not geocode• First = geocode to the first candidate from a multiple match



Following is a sample geocoding batch file. This same batch file could be created manually or through the MapMarker UK interface as described in Creating a Project-Based Batch File on page 77.

"C:\Program Files\MapInfo\MapMarker_UK_v4\desktop\MapMarkerUK.exe" /TABLE=C:\My Documents\MapMarker_UK\CustomerData\UK_ADDR.TAB /LOG=mapmarkr.log /UNMATCHED /START=1 /END=200 /EXACT_HOUSE=N /EXACT_STREET=Y /EXACT_TOWN=Y /EXACT_PC=Y /FALLBACK=N /MULTI=N

Manually Creating a Project-Based Batch FileYou can also manually create a batch file that executes a MapMarker project. A project-based batch file provides the only way to batch geocode a CSV or TXT file.

Before you create a project-based batch file, you must create a project. See Creating and Saving a Project on page 76.

Then In a text editor, create a BAT file that specifies the path to the desktop application and the location of the project.

The general of the syntax of the project-based batch file is:

path to desktop application /PROJ=path to project file

For example:

"C:\Program Files\MapInfo\MapMarker_UK_v4\desktop\MapMarkerUK.exe"

/PROJ=C:\My Documents\MapMarker_UK\Projects\StatQC_Exact.proj

For project-based batch file, The PROJ parameter is used by itself, not in combination with other batch file parameters. No other batch file parameters are valid for a project-based batch file that batch geocodes a CSV or TXT file.

After creating the BAT file, you can run it from the command line.

Note You do not have to create a project-based batch file manually. You can accomplish this automatically, as described in Creating a Project-Based Batch File on page 77.

/GEO_PC Geocode to postcode only.

/PROJ =<path to project file> This parameter is used by itself, not in combination with other batch file parameters. Specify the path to the project file. See Manually Creating a Project-Based Batch File on page 97.

Batch Geocoding Parameters for TAB File (continued)

Parameter Description

Developer Guide 97

Table Attribution with MapMarker

Batch Geocoding ConsiderationsThis section describes how batch geocoding handles information in your table.

Batch geocoding is available only for MapInfo TAB files. Batch geocoding of delimited text files and remote database (ODBC) files is not supported.

Batch File Contents for TAB and Other File Types

A batch files based on TAB files can contain the parameters listed in the table: Batch Geocoding Parameters for TAB File. However, a project-based batch file (used for Delimited and Text files), simply identifies and runs the project file, and does not use any other parameters. For project-based batch files, the preferences and parameters are encapsulated in the project file itself.

Running the Batch File

MapMarker UK should not be running when you run the batch file. The batch file will start MapMarker UK, execute the instructions, then exit.

Table Settings and Preferences

If you list a table in the batch file without parameters, MapMarker UK geocodes to the default settings for the table (whatever the settings were the last time the table was opened in MapMarker UK).

The batch geocoder uses the system preferences that are set at the time of geocoding. To ensure that a particular system setting is used, such as the location of the Address Dictionary, choose the setting in the System Preferences dialog, apply it, make the batch file, and run the batch file during the same MapMarker UK session.

Input and Output Columns

MapMarker UK uses the input and output columns it finds in the table’s metadata. Columns cannot be changed for batch geocoding.

Table Attribution with MapMarkerWith MapMarker UK, you can add information from one table to another, either before, during, or after the geocoding process. This ability is called attribution.

Any table in MapInfo format (TAB file) can be a candidate for attribution. This includes boundary and point files, demographic tables, or non-geographic tables. The table to which the attributes are being applied must be local, since it is the table you are geocoding. The table containing the source attributes can be local or remote.

Note You cannot use table attribution with a text file. Attribution works with TAB files only.



There are two ways to do attribution in MapMarker UK. They are defined by the type of link required to connect the two tables:

Output Point AttributionLinks the geocoded table to the attribution table by geography, specifically by matching latitude and longitude point coordinates within the geocoded table to a geographic boundary defined within the attribution table. For output point attribution, the attribution table must include a map object table (MAP).

Column Value AttributionMatches (joins) a column in the geocoded table to an equivalent column in the attribution table. The column in the attribute table must be indexed.

Attribution can operate either during a geocoding pass or as a separate batch process. Only successfully geocoded or matched records receive attribute data. Batch attribution is generally faster than geocoding with attribution enabled. Column value attribution is faster than output point attribution.

The general process for table attribution in MapMarker UK is:

1. Open the table that you want to geocode. This is the table into which you import attributes.2. Select the attribution table.3. Create a column to receive attribution data.4. Bind the attribute column in your geocoding table to attribution table column. either by Output

Point or Column Value.5. Geocode the table to add the attributes or run the batch attribution process.

Each of these steps is described more fully in the following topics:

Opening the Table for Attribution on page 99

Selecting an Attribution Table on page 100

Binding Attributes – Output Point Attribution on page 100

Binding Attributes – Column Value Attribution on page 101

Adding Attributes to Your Table on page 103

Stopping Attribution on page 104

Clearing Attribute File Selections on page 105

Tips for Using Attributions on page 105

Opening the Table for AttributionFirst you must open the geocoding table into which you want to add attributes. Follow these steps:

1. Open the MapInfo table. Select File > Open Table, navigate to the table you want to open and click Open. For example, open the Customer_Addresses.TAB file, which contains sample addresses.

2. Click Next, then Finish. At the Geocode dialog, the click Cancel. Do not geocode at this point.

Developer Guide 99


You are now ready to select an attribution table from which you want to pull attributes into your geocoding table. See Selecting an Attribution Table.

Selecting an Attribution TableTo select an attribution table that you want to pull attributes from, follow these steps.

1. Open the Select Attribute Tables dialog by doing one of the following:• On the Table menu, select Geocode and on the Geocode tab click Configure Attribution. • On the Table menu, select Add Attributes and click Select Attribute Files. The Select

Attribute Tables dialog appears.2. Navigate to the location of the attribute table that you wish to pull attributes from. Use the Drives

list to select the drive containing the attribute table, and then navigate that drive.3. When you locate the attribute table you wish to use, click it and then click Add. The full path to

the table appears in the Selected Tables box. Repeat to add additional tables.

When you are finished selecting attribution tables, click OK. The Bind Attribute Table Columns to Output Columns dialog box appears. You are now ready to setup attribution. Proceed to either:Binding Attributes – Output Point Attribution (for output point attribution) orBinding Attributes – Column Value Attribution (for column value attribution)

Note See Output Point Attribution on page 99 and Column Value Attribution on page 99 for descriptions of these two different types of attribution.

Binding Attributes – Output Point AttributionOutput point attribution links the geocoded table to the attribution table by geography, specifically by matching latitude and longitude point coordinates within the geocoded table to a geographic boundary defined within the attribution table. For output point attribution, the attribution table must include a map object file (MAP).



To set up output point attribution:

1. If the Bind Attribute Table Columns to Output Columns dialog is not already open, select Table > Add Attributes > Select Attribute Files and click Next at the Select Attribute tables dialog. This will return you to the Bind Attribute Table Columns to Output Columns dialog box. From this dialog, use the Attribute Table Name drop-down list and select the table from which you want to copy attributes.

2. If necessary, click Output Point in the Join Information group.3. From the list at the left, select the column in your table from which you want to pull attributes. For

example, select the Country column.4. From the list at the right, select the output column into which you want to add attributes. For

example, select the Country_o column.5. Click Bind to Column. The input column list box indicates the output column number to which

the input column is bound (column 19 in this example).

Repeat this process for each output point attribution you wish to do. For each table you select, you can choose whether to do output point or column value attribution.

6. When finished, click OK.

You are now ready to add the bound attributes to your table. See Adding Attributes to Your Table on page 103.

Binding Attributes – Column Value AttributionColumn value attribution matches (joins) a column in the geocoded table to an equivalent column in the attribution table. The column in the attribution table must be indexed. (That is, there must be an IND file to accompany the DAT file.

Developer Guide 101


To set up column value attribution:

1. From the Bind Attribute Table Columns to Output Columns dialog, use the Attribute Table Name drop-down list and select the table (and column) from which you want to copy attributes.

2. Click Column Value in the Join Information group.3. In the Attribute Table Column drop-down list, select the column in the attribution table that you

want to join to the output table.4. In the Output Table Column drop-down list, click the column in the output table that you want to

join to the attribution table.5. In the Characters used in comparison box, type the number of characters you want

MapMarker UK to use in determining a match between the joined attribute and output columns.6. In the input table list box on the left, select the column in the attribute table from which you want

to pull attributes. For example, select the PostCode column.7. In the output table list box, select the column in your geocoded table into which you want to add

attributes. For example, select the PostData_o column.8. Click Bind to Column. The input column list box indicates the output column number to which

the input column is bound (column 21 in this example).

Repeat this process for each column value attribution you wish to do. For each table you select, you can choose whether to do output point or column value attribution.

9. When finished, click OK.

You are now ready to add the bound attributes to your table. You can do this by geocoding the table or by adding attributes via a batch process. See Adding Attributes to Your Table.



Adding Attributes to Your TableOnce you have bound your attribute and output table columns (see Binding Attributes – Output Point Attribution on page 100) or Binding Attributes – Column Value Attribution on page 101), you are ready to add attributes to your table. One means of doing attribution is by geocoding your table (see Adding Attributes By Geocoding). You can also add attributes using a batch process (see Adding Attributes Using Batch Process), which is done without geocoding the table.

Output point attribution must be done on a table either during a geocoding run or by a batch process using a table that has already been geocoded. Column value attribution can be done prior to, during, or after geocoding.


Adding Attributes By Geocoding

Adding Attributes Using Batch Process

Stopping Attribution

Clearing Attribute File Selections

Tips for Using Attributions

Adding Attributes By GeocodingWhen you geocode the table, each record in your table is opened and processed. At this time, MapMarker UK also pulls the attributes defined from the attribution table columns you specified when setting up attribution, and inputs those attributes into your table’s target column(s).

For information on geocoding your table, see Geocoding with MapMarker UK in Chapter 3 on page 34.

Adding Attributes Using Batch ProcessYou can use a batch process to add attributes to your table any time after setting up attribution. When you batch add attributes, MapMarker UK uses the table joins and bindings that you defined when setting up attribution, copies the matched attributes from the attribution table(s), and adds them to your table in the column(s) you specified.

Batch attribution is generally faster than geocoding with attribution enabled.

To batch add attributes:

1. If it is not already open, open the MapInfo table that you want to geocode. See Opening a Table or Text File on page 44.

2. Select input and output columns. See Selecting Input and Output Address Columns on page 50.

3. Geocode the table. See Geocoding Your Table Automatically on page 56.4. Select Table > Add Attributes > Select Attribute Files and select an attribution table. See

Selecting an Attribution Table on page 100. When you are finished selecting attribution tables,

Developer Guide 103

Adding Attributes to Your Table

click OK. The Bind Attribute Table Columns to Output Columns dialog box appears. You are now ready to setup attribution.

5. From the Bind Attribute Table Columns to Output Columns dialog box, select either Output Point or Column Value depending on the type of attribution you want to perform. See Binding Attributes – Output Point Attribution on page 100 or Binding Attributes – Column Value Attribution on page 101 for detailed steps.For example, you could set up an Output Point join with Country as the Attribute Name and Country_o as the Output Column:

6. Select Table > Add Attributes > Batch Add Attributes. The Updating Table process indicator appears and automatically closes once attribution is complete.

Stopping AttributionOnce attribution is set up for your table, MapMarker UK does attribution on your table every time you geocode until you instruct it to stop. Attribution is enabled every subsequent time you open the table as well, until you manually stop attribution for the table. Stopping attribution does not remove the attribution information for the table, rather, it stops any further attribution for the table while it is open in MapMarker UK. To completely remove all attribution information for the table, see Clearing Attribute File Selections.

To stop table attribution:

1. If it is not already open, open the MapInfo table.2. Select Table > Add Attributes > Stop Attribution.

When you stop attribution, MapMarker UK no longer does attribution on the table while the table is open, but the attribution settings are still defined within your table’s metadata. You can view the metadata by opening the a TAB file in a text editor.



The attribution information is located at the bottom of the metadata, and resembles the following:

"\MapMarker\AddAttributes" = ""

"\MapMarker\AddAttributes\InputTables" = "1"

"\MapMarker\AddAttributes\Layer0" = "c:\program files\mapinfo\mapmarker\sampdata\cntydemo.tab"

"\MapMarker\AddAttributes\Layer0\BindOnPoint" = "1"

"\MapMarker\AddAttributes\Layer0\Attribute0" = "Ctyname County_nam"

"\MapMarker\AddAttributes\Layer0\AttributeCount" = "1"

Clearing Attribute File SelectionsIf you decide that you do not want to perform attribution for your table, you can clear the attribute file selections for your table. The table is no longer set up for attribution. When you clear attribute file selections, all attribution information in your table’s metadata is removed permanently. If you want to do attribution on your table in the future, you must configure new attribution settings for your table (See Table Attribution with MapMarker on page 98 for the basic steps to setting up and doing attribution.)

To clear attribute file selections:

1. If it is not already open, open the MapInfo table.2. Select Table > Add Attributes > Clear File Selections.

If you want to stop the attribution process without removing the attribution metadata from your table, see Stopping Attribution on page 104.

Tips for Using AttributionsConsider the following when using attributes:

• The Add Attributes feature is available only after you have selected the input and output columns for your geocoding table.

• Do not open the attribution table in MapMarker UK. As long as you provide the path in the Select Attribute Tables dialog, MapMarker UK is able to retrieve information from it.

• Attribution can be done on any local table that MapMarker UK can geocode. Attribution can also be used in a batch geocoding session, for example, for overnight processing. See Batch Geocoding on page 94, for instructions on setting up a batch operation.

• MapMarker UK does not output attributes to columns that have already been selected as input columns or output columns. Generally, you should create a new column to receive attribution data.

• For a column value match, the matching column in the attribute table must be indexed. In addition, the values in the columns must be an exact match. This can be controlled by defining the number of characters required for an exact match in the Bind Attribute Table Columns to Output Columns dialog. See Binding Attributes – Column Value Attribution on page 101 for more information.

• For output point attribution, the attribution table must include a map object file (MAP). The table you are geocoding must contain longitude and latitude values, not just the point object. The coordinates can be obtained during the same geocoding/attribution pass. See Binding Attributes – Output Point Attribution on page 100 for more information.

Developer Guide 105

Adding Attributes to Your Table

• For proper storage of attributes, consider the type and length of attribute fields you are working with. The column type/length for the attribute and output columns display in the Bind Attribute Table Columns to Output Columns dialog. For example, a 15-character value in the attribution table is truncated if the output column can only accept 10 characters. Character values stored as numerics in the attribute table may not display as expected in the output table.

• If MapMarker UK finds a duplicate match in the attribution table, it takes the attributes from the first record it finds.


6
Geocoding Remote Tables
In addition to geocoding MapInfo native format (TAB) and other supported table formats as described in Supported File Formats on page 37, MapMarker UK can geocode tables that are stored on remote database systems. MapMarker UK geocodes remote relational databases via ODBC, an open database connectivity standard. MapMarker UK uses ODBC to access the data and store the resulting geocoding data and spatial object remotely. This ensures that data integrity and security are maintained.

The general process of geocoding these databases is the same as for local tables, but this chapter covers the information specific to remote table geocoding.

In this chapter

Supported Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108Remote Tables and Spatial Objects . . . . . . . . . . . . . . . . . . . . . . .108Preparing to Geocode Remote Databases. . . . . . . . . . . . . . . . . .109Accessing a Remote Table for Geocoding . . . . . . . . . . . . . . . . .110Writing Geocoding Output to Another Table . . . . . . . . . . . . . . . .112Additional Considerations for Remote Table Geocoding. . . . . .116

Supported Databases

Supported DatabasesMapMarker UK supports ODBC tables in Microsoft Access, Oracle, and SQL Server formats. See your MapMarker UK release notes for version-specific support information.

The SQL Server and MS Access drivers are installed with MDAC 2.8.

You must install the Oracle driver separately. To use the driver, you must have the Oracle client installed.

Remote Tables and Spatial ObjectsMapMarker UK supports remote database geocoding via ODBC for relational database management systems (RDBMS). The RDBMS stores coordinates in X,Y columns. The RDBMS stores the geocoded spatial object directly.


Mappable Tables and the MapInfo Map Catalog on page 108

Supported Spatial Index Types on page 108

Mappable Tables and the MapInfo Map CatalogThis section describes the mappable tables and the MapInfo Map Catalog, features that are an integral part of remote geocoding with MapMarker UK.

A mappable table is a table of data that has its spatial information recorded in the MapInfo Map Catalog. Mappable tables are managed by the MapInfo Map Catalog. MapMarker UK reads the Map Catalog each time you geocode a remote mappable table to know how to handle the spatial object. A Map Catalog is optional for X,Y databases. The MapInfo Map Catalog must have an entry for each table in the database that you wish to geocode.

We recommend that you create your Map Catalog and make a table mappable within MapInfo Professional. Specific tools and commands are provided there for this purpose.

If, however, you do not have access to MapInfo Professional, you can do these procedures manually. See Creating a Map Catalog Manually in Appendix B on page 170.

Supported Spatial Index TypesMapMarker UK supports X,Y (for Oracle, SQL Server, and Microsoft Access). This is shown in the Map Catalog under the column SPATIALTYPE for X,Y.


Chapter 6: Geocoding Remote Tables

Preparing to Geocode Remote DatabasesBefore you can geocode your remote table with MapMarker UK, you (or the database administrator) must set up MapMarker UK and your database to handle the geocoding operation. In general, the process follows these steps:

1. Create a data source (see Creating a Data Source on page 109).2. Prepare the remote table with the appropriate columns and spatial handling requirements (see

Preparing the Remote Table on page 109).3. Create a Map Catalog for each remote database (see Creating a Map Catalog on page 110).4. Make the remote table mappable (see Making a Remote Table Mappable on page 110).


Creating a Data Source on page 109

Preparing the Remote Table on page 109

Creating a Map Catalog on page 110

Making a Remote Table Mappable on page 110

Creating a Data SourceAfter the drivers are installed, create a data source for your database. Use the ODBC Administrative Tools in the Control Panel for this purpose.

Note Under Microsoft VISTA Ultimate Edition or Windows 7, you must have Administrator privileges to create an ODBC data source.

To create an ODBC data source, follow these steps:

1. From Control Panel > Administrative Tools, double-click Data Sources (ODBC) to display the ODBC Data Source Administrator dialog.

2. On the User DSN tab, click Add. 3. At the Create New Data Source dialog, choose the drive for which you want to set up a data

source. For example, you could select SQL Server. 4. Click Finish. The ODBC Setup dialog is displayed. The details of this dialog depends on your

data source.5. Fill out the dialog per your needs and click OK. Select allows you to associate a specific

database with the data source. 6. Return to the ODBC Data Source Administrator dialog and click OK.

Preparing the Remote TableYou or your database administrator must add columns to the table to store the results of the geocoding operation. For the X,Y spatial index type, there must be one column for longitude values and another column for latitude values. The longitude and latitude columns should be decimal type (11,6 or larger) or float. See Output Column Type/Width Requirements on page 40.

Developer Guide 109

Accessing a Remote Table for Geocoding

In addition, you should add a column to your table for storing the result code (georesult) that MapMarker UK generates. The result code describes the type of geocoding match that was attempted.

If you plan to write geocoding output to another table, provide those columns as well. See Writing Geocoding Output to Another Table on page 112 for more information.

Creating a Map CatalogCreate a Map Catalog for each remote database you want to access in MapMarker UK. In MapInfo Professional, run the utility MIODBCAT.MBX from the Run MapBasic Program command. For complete details see the topic on Accessing Remote Data in the MapInfo Professional Help System.

If you are not using MapInfo Professional, you must create the Map Catalog manually, as described in Creating a Map Catalog Manually in Appendix B on page 170. This process only needs to be done once for each database.

Making a Remote Table Mappable For each spatial table in the remote database that you want to access in MapMarker UK, you must include it as a row in the MAPINFO_MAPCATALOG table. This is carried out in MapInfo Professional when you select Table > Maintenance > Make ODBC Table Mappable. For details, see the appropriate topic in the MapInfo Professional User Guide.

If you do not use MapInfo Professional to manage the Map Catalog, you must manually add rows to the MAPINFO_MAPCATALOG table for each spatial table in the database that you want to geocode. See Creating a Map Catalog Manually in Appendix B on page 170 for further instructions.

Accessing a Remote Table for GeocodingAfter your remote database is prepared for geocoding, you are ready to open it in MapMarker UK and begin geocoding.

To access your remote database, follow these steps:

1. If you have specified that the File Open dialog display at startup for ODBC tables (set in System Preferences), the Select Data Source dialog is displayed automatically when you start MapMarker UK.

Otherwise, select File > Open Remote Table or click to display the Select Data Source dialog.



2. From the Select Data Source dialog, click the Machine Data Source tab.

3. Choose your data source. Your data source is the location of the specified database. For example, CUSTOMER could be the name of the SQL table located in a specified directory. Once connected to the CUSTOMER data source, you could access information from any table associated with that data source.

4. Sign on to your data source in the usual way. This procedure differs depending on what type of ODBC table you are using.

5. From the Select Table dialog, choose the table you want to access. Each of the tables owned by you or accessible to you are displayed.

Note Remember that you cannot open any other tables while you have an ODBC table open.

6. Proceed with geocoding as you would with any other MapInfo table (see Geocoding Your Table Automatically on page 56 and Geocoding Your Table Interactively on page 57). The procedure is the same as geocoding local tables, with the exceptions explained in the following topics.

Note Typically, during interactive geocoding, you can edit the information in the Input Address fields of the source table. This is described in Editing Your Records on page 60, However, when you geocode a remote table interactively, MapMarker UK cannot overwrite the Input Address fields of the source table. Therefore, when geocoding a remote table the option to write modified addresses is unavailable.

Developer Guide 111

Writing Geocoding Output to Another Table

Writing Geocoding Output to Another TableMapMarker UK can geocode a remote database table and write the results to a another table. Often database administrators do not want users to modify or write back to the source table, because of the potential of introducing errors into the database. In that case, the database administrator can set up a related table to store the geocoding results and other output information. During geocoding MapMarker UK reads the input addresses from the source table and writes the results to the related results table.

Note To avoid overwriting your input data, use output columns that have different names than the corresponding input columns. If your output columns and input columns have the same name, you receive a Warning message telling you that your input data will be modified when geocoding. You can then click Yes to Continue and overwrite your input data or click No if you want to change your output column selections.


Relationship Between Source and Results Tables on page 112

Setting Up for Related Table Geocoding on page 113

Remote Table-to-Table Geocoding on page 113

Optimizing MapMarker for Related Table Geocoding on page 115

Remote Database Views on page 116

Relationship Between Source and Results TablesMapMarker UK can write geocoding results to remote related tables using MapMarker UK ODBC support. All addresses must be contained in the source table, while all results must be written to a related results table.

The source and results tables must be linked by a common key. You or your database administrator must be familiar with how the two tables are related.

In the source table, the values of the primary key must match the values in the unique key of the results table. We recommend relating the tables in a one-to-one relationship. Each address record in the source table has a corresponding record in the related results table connected by the key values.

Where there is more than one record with the same address (a multiple-to-one relationship), these records may produce georesults that are written to one record. Each time MapMarker UK geocodes another address with the same value, it updates the output record in the results table. As long as each address record with the same key contains the same address, the output is identical. However, if two source records with the same key contain different address information, MapMarker UK geocodes the first record, writes its results, then geocodes the second record and updates the results with information from that second record, which contains a different (and possibly incorrect) input address.



Setting Up for Related Table GeocodingPrior to geocoding, the database administrator creates a related table in which to store geocoding results. The table structure includes at least one key that uniquely identifies an address in the source table. In addition, the related table contains fields for the geocoding results, and longitude and latitude coordinates. See Specify Output Address Columns on page 40, for details on column type and width. Consult your database documentation for information on creating relational tables and primary keys.

The database administrator must also create a data source for the remote source/results tables. The data source must include information that enables MapMarker UK to determine which data to access and how to access it. See Preparing to Geocode Remote Databases on page 109 for the instructions for setting up a data source.

Remote Table-to-Table GeocodingUse this procedure to geocode a remote table and write the results to a related table:

1. In MapMarker UK, select File > Open Remote Table.2. In the Select Data Source dialog box, choose either the File Data Source or Machine Data

Source tab. Enter your user name and password if necessary. Click OK.3. In the Select Database dialog box, navigate to the source table that contains the addresses you

want to geocode. Enter the password if your data source requires it. For example, an MS Access database selection might appear as:

Click OK.4. In the Select Table dialog box, select the table that contains the addresses you want to geocode.

For example, an MS Access table selection might appear as:

Developer Guide 113

Writing Geocoding Output to Another Table

Click OK.

5. You may be asked if you want to use a different table for output. Answer Yes if you want to write the geocoded results to a different table.

6. To write results to a different table, choose the data source for the output table. For example, you might select Add_Table_Out as the results table to contain the geocoding output. Click OK.

7. If your source table has multiple unique keys, the Describe Table Relationship dialog appears. Proceed to step 8. If your table has only one key, the Select Input Column dialog appears. Skip to step 9.

8. In the Describe Table Relationship dialog, select the address source columns and the corresponding columns with unique keys in the results table. In the Input Table list, select the input column and drag it to the Selected Input Columns box for Key 1. In the Output Table list, select the input column/key that is linked to the input column and drag it to the Selected Output Keys box for Key 1. Repeat for additional columns and keys. To remove a column name, drag the <Clear> item on top of them.



.

Click OK. The Select Input Column dialog appears.

9. In the Select Input Columns dialog, select the columns that contain the appropriate address components. Click Next. The Select Output Columns dialog is appears.

10. In the Select Output Columns dialog, identify the columns in the results table where MapMarker UK stores the result codes, coordinates, and output addresses.

11. Click Finish to close this dialog. The Geocode dialog appears if it is set to appear automatically in System Preferences. If the Geocode dialog does not appear, select Table > Geocode.

12. On the Related Table tab click either Optimize for insertion or Optimize for update. Choose Optimize for insertion if your results table is new or contains few records. Choose Optimize for update if your results table contains many records are likely to be updated.

13. Continue with the normal geocoding process by choosing options on the other dialog tabs (Geocode, Match Settings, Fallback, etc.) See Geocoding with MapMarker UK in Chapter 3 on page 34.

Note When geocoding using multiple tables, the options, "Georesult less than" and "Unmatched rows" are not available on the Geocode tab. The option, "All types" is the only choice.

Optimizing MapMarker for Related Table GeocodingYou may be writing the geocoding results to a new output table or may be updating previously geocoded records in an existing related table. To get the best performance from MapMarker UK, you can optimize for one situation over the other. In the Geocode dialog, choose from two settings in the Related Table tab: Optimize for Insertion or Optimize for Update.

Developer Guide 115

Additional Considerations for Remote Table Geocoding

As a general rule, select Optimize for Insertion when the results table is empty or nearly so. Select Optimize for Update when the results table already contains many records that are likely to be updated. The default setting is Insertion.

Note This feature does not apply to geocoding to a table in a remote database where the input and the output results are stored in the same table. In these instances, the Related Table tab is not visible in the Geocode dialog.

Remote Database ViewsMapMarker UK enables you to geocode views of remote tables if you are writing the geocoding output to another table. A view is a subset of a table that is typically the result of a select statement. For example, you may create a view of a nationwide table that includes only records for California. Refer to your database documentation when creating views.

Once your view is created and you are ready to geocode, follow these steps: This example uses a machine data source

1. Select File > Open Remote Table. The Data Source dialog is displayed.2. From the Machine Data Source tab, choose the data source (such as DBF files or Excel files).

Click OK.3. From the Select Table dialog, click Filter. Select the Views check box and click OK. The Select

Table dialog is displayed again with a list of views for the data source.4. Choose the view that shows the input table and click OK.5. Answer Yes to using a different table for the outputs from geocoding.6. From the Select Table dialog, choose the view for the output table and click OK.7. At the Select Input and Output Column dialogs, choose your columns and click OK. 8. Select Table > Geocode and proceed with the normal geocoding process. See Geocoding with

MapMarker UK in Chapter 3 on page 34, for complete information on the geocoding process.

Additional Considerations for Remote Table GeocodingConsider the following when doing any type of remote table geocoding:

Sort by Postal for Faster Geocoding on page 117

Geocoding Unmatched Records on page 117

Transaction Control with ODBC Tables on page 117

Remote Database Views on page 117

Rollback Segment Limit on page 117

Supported Unique Index and Primary Key Data Types by Database



Sort by Postal for Faster GeocodingMapMarker UK performance is best when it can access records sorted by Postcode. For local tables, therefore, we recommend that all tables for geocoding are sorted by postcode prior to geocoding. For remote tables, we recommend that the postcode column be indexed for faster accessing. To add an index to a remote table, follow the instructions for your database.

Geocoding Unmatched RecordsMapMarker UK can geocode unmatched records in previously geocoded remote tables instead of geocoding the entire table with every pass. After you select the input and output columns, go to the Geocode dialog and set the types of rows to geocode to Unmatched Rows. MapMarker UK attempts to find a match for all records in your table that have a georesult of N or blank. MapMarker UK updates the log file to reflect the total number of records it attempted to geocode during the pass, not the total number of records in the table.

Note Geocoding unmatched records is not available for multi-table geocoding.

Transaction Control with ODBC TablesMapMarker UK uses as non-obtrusive locking mechanism as possible when geocoding your ODBC table. It attempts to use the lowest level of locking available (for example, row, page or, at worst case, table locking). Locks are not placed until the row is geocoded. MapMarker UK issues a commit after each update so that each lock is held for an extremely short time (the time it takes to lock a row, update it, and commit it).

If MapMarker UK attempts to lock a row that is already locked, MapMarker UK follows the default behavior of the database. Usually this means waiting until that row is released. MapMarker UK does not use any deadlock detection beyond that provided by the database.

Note You are responsible for maintaining the relationship of the street address and the latitude/longitude for that address. For example, whenever you change any street address information, you must re-geocode that record.

If rows are deleted from your table after MapMarker UK opens the table, MapMarker UK reports an error when it tries to geocode that deleted row.

Remote Database ViewsYou may only geocode views of a remote table when you are doing a table-to-table geocode. See Writing Geocoding Output to Another Table on page 112, for more information.

Rollback Segment LimitBe sure that you set your database rollback segment or temp space to be sufficiently large enough to accommodate the size of your database.

Developer Guide 117

Additional Considerations for Remote Table Geocoding

Supported Unique Index and Primary Key Data Types by DatabaseThe following table identifies the supported data types by RDBMS. A Primary Key must also be defined for your table.

If MapMarker UK encounters a mappable table with a spatial type it does not support, an error message is displayed and the table is not geocoded.

For a list of ODBC databases supported by MapMarker UK (including Microsoft Access, Oracle, and SQL Server) see your product-specific MapMarker UK Release Notes.

Microsoft SQLServer Microsoft Access Oracle

Char Character Character

Float Number (double) Number

Integer Number (Long Integer) Varchar

SmallInt Number (Integer) Varchar2

Tinyint Number (Single) N/A

Real N/A N/A

Varchar N/A N/A


7
Result Codes
This appendix explains the result codes returned after geocoding MapMarker UK addresses.

In this chapter:

MapMarker UK Result Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

MapMarker UK Result Codes

MapMarker UK Result CodesAs an output option, MapMarker returns a result code for every record it attempts to match. 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 MapMarker matched each address component.

The result codes are written to a result column specified in the Select Output Columns dialog box at the beginning of the geocoding process. You can either create this column before geocoding or have MapMarker create it automatically (default name Georesult) when you open your table.

The code is an alphanumeric code of 1–10 characters. The codes fall into the following categories:

• Single unique match • Postcode centroid match

The match precision depends on the settings you choose in the Geocode dialog box, the quality of the data in the table to be geocoded, and on the Address Dictionary.

Each category is explained in the following topics.

Single Match (S category)

Multiple Candidates Match (M category)

Postal Centroid Match (Z category)

Single Match (S category)Matches in the S category indicate that the record was matched to a single address candidate. The first character (S) reflects that MapMarker found a street address that matches your record.

S result codes are always returned for matches when the Address-Point dictionary is used. These dictionaries (derived from Ordnance Survey® data) provide point/parcel level geocoding. The CodePoint dictionary provides postal centroid geocoding. For more information on these address dictionaries, see MapMarker UK Address-Point Dictionary and MapMarker UK CodePoint Dictionary.

Single Match Result Codes – First Character

Result Accuracy

S8 Candidate location is precise to the parcel/delivery point with best positional quality (generally within 0.1 metre). S8 results are possible with the Address-Point dictionary

S7 Candidate location is precise to the parcel/delivery point but the positional quality is not as good as S8. S7 results are possible with the Address-Point dictionary.

S5 Candidate location is a street interpolated point and is accurate to the building level.


Chapter 7: Result Codes

Street level georesult codes S8, S7, S5, S4, S3 are followed by additional characters, indicating details of the match precision. These georesult characters appear in the following order, immediately following the S8 or S7.

Note Since Street prefixes, types, and suffixes do not apply to addresses in United Kingdom; MapMarker United Kingdom will always indicate that they have been matched.

S4 Candidate location is precise to street level but has an inaccurate building number.

S3 Candidate location is precise to the postcode centroid. S3 is the only S result code possible when using the CodePoint dictionary. The Address-Point dictionary can return S3 when a parcel level match is not possible (such as when a house number or building name is not provided for input).

Single Match Result Codes – First Character (continued)

Result Accuracy

Single Match Result Codes – Subsequent Characters

Character Description

H Exact match on house number

P Street prefix direction. Always set to P if other parts of street name was match. See Note below.

N Exact match on street name.

T Exact match on street type.

S Street Suffix direction. If input contains a directional which did not match the candidate directional, this flag will not be set. Otherwise the flag is set if street name is matched, regardless of whether the input or candidates had directional elements.

C Exact match on town name

Z Exact match on postcode

A Address is returned from the Address Dictionary. This is always A for MapMarker UK v4.5, because User Dictionary is not supported.

– If any of the fields do not have an exact match, then its position will be replaced with a dash.

Developer Guide 121

MapMarker UK Result Codes

The following are sample geocoding results:

Multiple Candidates Match (M category)Matches in the M category indicate that there is more than one match candidate for the record and MapMarker UK has chosen the best one of those candidates. This can happen when there are multiple close matches and you select Accept first from the Multiple Match tab on the Geocode dialog. See Multiple Match Dialog on page 75.

As in the S category, the second position in the code of M category matches the positional accuracy of the resulting point object. See the table of Single Match Result Codes – Subsequent Characters on page 121.

Possible M geocoding results are:

Note M category matches can be returned for the Desktop Application only.

Sample Single Match Result Codes

Sample Georesult Code Example and Description

S8xxxxxxxx S8-PNTSCZA – Candidate precise to delivery point with an exact match on Street, Town, and Postcode.

S7xxxxxxxx S7-PN-SCZA – Similar to S8 precision, except street type does not match.

S5xxxxxxxx S5HPNTSCZA – Candidate precise to street interpolated point with exact match on all specified criteria.

S3xxxxxxxx S3-PNTSCZA – Candidate precise to the postcode centroid.

S3xxxxxxxx S3HNFTSCZA (S3 result for Northern Ireland address)

Result Accuracy

M5 Multiple matches, point located at a street address position.

M4 Multiple matches, precise to street level but has an inaccurate building number.

M3 Multiple matches, point located at postcode centroid.


Chapter 7: Result Codes

Postal Centroid Match (Z category)Matches in the Z category indicate that the match was made at a postcode level. For MapMarker UK v4.5, Z3 results are returned when using the CodePoint Postal Address File (PAF) dictionary. See MapMarker UK CodePoint Dictionary.

Possible Z geocoding result codes are:

Result Accuracy

Z3 Postcode centroid. The CodePoint dictionary always returns Z3 results.

Developer Guide 123

A
MapMarker User Interface Reference
This appendix has reference information for the various dialogs, buttons, and menu commands in the MapMarker UK user interface.

In this appendix:

MapMarker Menu Commands and Toolbar Buttons . . . . . . . . . .125MapMarker Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132

Appendix A: MapMarker User Interface Reference

MapMarker Menu Commands and Toolbar ButtonsThis section describes the various buttons and menu commands in MapMarker UK and what they are used for. The topics are organized in alphabetical order by button/command name. Use the list below to locate the description of the button or menu command you wish to learn about.

• About MapMarker command on page 125• Arrange Icons command on page 126• Batch Add Attributes command on page 126• Cascade command on page 126• Choose Font command on page 126• Clear File Selections command on page 126• Close command on page 126• Close Project command on page 127• Create Batch File command on page 127• Create Project-based Batch File on page 127• Create/Save Project command on page 127• Exit command on page 127• Geocode command on page 128• Help Topics command on page 128• Logfile command on page 128• Open Browser List command on page 128• Open ODBC Table command on page 129• Open Project command on page 129• Open Table command on page 129• Quick Find command on page 129• Quick Geocode command on page 130• Recent File List command on page 130• Select Attribute Files command on page 130• Select Columns command on page 130• Status Bar command on page 131• Stop Attribution command on page 131• Summary command on page 131• System Preferences command on page 131• Tile command on page 131• Toolbar command on page 132

About MapMarker commandAbout MapMarker UK displays the About MapMarker message box. This message box has information about your copy of MapMarker UK, including the product version number, data vintage, copyright, legal, and licensing information and the serial number for the licensed user of the product. About MapMarker UK is available when MapMarker UK is running.

To view your MapMarker UK information:

• On the Help menu, click About MapMarker.

User Guide 125

MapMarker Menu Commands and Toolbar Buttons

Arrange Icons commandArrange Icons arranges all minimized browser windows into rows along the bottom of the MapMarker UK workspace. Arrange Icons is always available when MapMarker UK is running and there is at least one table open.

To arrange your minimized windows:

• On the Window menu, click Arrange Icons.

Batch Add Attributes commandBatch Add Attributes allows you to add attributes from one table to another without geocoding the table at the same time. Batch Add Attributes is available when a table is open, input and output columns for geocoding have been selected, and the attribute table(s) have been identified.

To use Batch Add Attributes:

• On the Table menu, point to Add Attributes, and then click Batch Add Attributes.

Cascade commandCascade arranges open windows in an overlapping pattern so that the title bar of each window is visible. Cascade is always available when MapMarker UK is running and there is at least one table open.

To cascade your open windows:

• On the Window menu, click Cascade.

Choose Font commandChoose Font allows you to select a font, font style and font size for the text in the Browser window. Choose Font is always active when MapMarker UK is running.

To choose font settings:

• In the Options menu, click Choose Font.

Clear File Selections commandClear File Selections deletes the attribute settings stored in a table’s metadata. Clear File Selections is available when a table is open and attribute settings exist.

To delete a table’s attribute settings:

• In the Table menu, point to Add Attributes, and then click Clear File Selections.

Close commandClose allows you to close a table. Close is available when at least one table is open.

126 MapMarker UK v4


To close a table, do one of the following:

• In the File menu, click Close.• Click in the table window.

Close Project commandTo close a project, do the following:

• In the File menu, click Projects, then Close Project.

Create Batch File commandCreate Batch File allows you to save a text file containing instructions for MapMarker UK to carry out a batch geocoding session. Create Batch File is available when at least one table is open.

To create a batch file, do one of the following:

• In the Table menu, click Create Batch File. • Click the secondary mouse button to display a shortcut menu, then click Create Batch File.

Create Project-based Batch FileCreate Project-based Batch File allows you to create MapMarker UK projects (PROJ) files and to batch geocode TXT files (delimited or fixed-width). Batch geocoding of a TXT file can only be done by done through a project.

To create a project-based batch file, do one of the following:

• On the File menu, click Create/Project-based Batch File.• Click the secondary mouse button to display a shortcut menu, then click Create/Project-based

Batch File.

Create/Save Project commandCreate/Save Project allows you to save a MapMarker UK project file with all saved geocoding settings, column mappings, table attributes settings, and some system preferences. These project file settings will be used when the project is re-opened with the Open Project command. The project file settings override any of the existing metadata settings in the TAB file.

To save a project file, do the following:

1. In the File menu, click Projects, then Create/Save Project.2. In the Save Project File As dialog box, type a name for the project. A PROJ file extension is

used.

Exit commandExit allows you to quit MapMarker UK. Exit is active when MapMarker UK is running.

User Guide 127


To exit MapMarker UK, do one of the following:

• In the File menu, click Exit.• Click in the MapMarker UK window.

Geocode commandUse Geocode to specify the geocoding settings you want to use, including run type (automatic or interactive geocoding), street-level or postcode match, match settings, and fallback settings. Geocode is available when a table is open and you have selected the input and output columns for that table.

To specify your geocoding settings, do one of the following:

• In the Table menu, click Geocode.

• Click In the MapMarker UK toolbar.• Click the secondary mouse button to display a shortcut menu, then click Geocode.

Help Topics commandHelp Topics displays the main entry topic for the MapMarker UK Online Help system. Help Topics is always available when MapMarker UK is running.

To display the online Help, do one of the following:

• In the Help menu, click Help Topics.• Press the F1 key for a command or dialog for which you need more information.

• Click in a dialog.

• Click and then click a toolbar button or menu command in the MapMarker UK window.

Logfile commandLogfile displays the log file in a text editor where you can view the results and chosen settings of the current geocoding session. Logfile is available after geocoding a table.

To view the log file, do one of the following:

• In the View menu, click Logfile.• Select Automatically open log file after geocoding in the Log File tab of the Geocode dialog.

Open Browser List commandThe Open Browser List shows a list of filenames for all open tables within MapMarker UK. The Open Browser List is active when at least one table is open in MapMarker UK.

To use the Open Browser List:

• In the Window menu, click the filename of the table to view.

128 MapMarker UK v4


Open ODBC Table commandOpen ODBC Table allows you to specify which remote table you want to open in MapMarker UK. MapMarker UK supports remote tables in MS Access, Oracle, and SQL Server formats. Open ODBC Table is available when MapMarker UK is running, and is unavailable if there is already a local table open.

To open a remote table, do one of the following:

• In the File menu, click Open ODBC Table.

• Click on the MapMarker UK toolbar.

Open Project commandOpen Project allows you to open a MapMarker UK project file with all saved geocoding settings, column mappings, table attributes settings, and some system preferences. These project file settings override any of the existing metadata settings in the TAB file. To open a project file, do the following:

1. In the File menu, click Projects, then Open Projects.2. Navigate to the folder that contains projects (PROJ file extension), select the project file and click

Open.

The project file is created with the Create/Save Project command.

Open Table commandOpen Table allows you to open a local MapInfo table (TAB file), dBase (DBF). comma-delimited (CSV), or text (TXT) file. table in preparation for geocoding. Open Table is available when MapMarker UK is running.

To open a table, do one of the following:

• In the File menu, click Open Table.

• Click on the MapMarker UK toolbar.• Click the secondary mouse button to display a shortcut menu, then click Open Table.

Quick Find commandQuick Find is a search tool you can use to find or confirm one address at a time. Quick Find is active when MapMarker UK is running.

To use Quick Find, do one of the following:

• In the Search menu, click Quick Find.

• Click on the MapMarker UK toolbar.• Click the secondary mouse button to display a shortcut menu, then click Quick Find.

User Guide 129


Quick Geocode commandQuick Geocode allows you to immediately proceed to geocoding when you open a table in MapMarker UK. MapMarker UK uses the system and table settings from the table's metadata as its matching criteria. The type of geocoding pass done (automatic or interactive) is the same as the last geocoding pass made In the table. For example, if you previously geocoded in interactive mode, Quick Geocode then geocodes in interactive mode until you change the geocode preference to automatic. Quick Geocode is available when at least one table is open and that table has previously been geocoded.

To use Quick Geocode, do one of the following:

• In the Table menu, click Quick Geocode.

• Click on the MapMarker UK toolbar.• Click the secondary mouse button to display a shortcut menu, then click Quick Geocode.

Recent File List commandThe Recent File List is a shortcut method you can use to access tables you have previously opened in MapMarker UK. The names of up to the last four opened tables are listed toward the bottom of the File menu. The Recent File List is available when at least one table has been opened and closed in the current MapMarker UK session.

To use the Recent File List:

• In the File menu, click the filename of the table you want to open.

Select Attribute Files commandSelect Attribute Files allows you to specify the table of attributes you want to connect to your geocoding table. The attribute table can be local or remote. The table you are geocoding, however, must be local, unless that table uses a different table for output. Select Attribute Tables is available when at least one table is open.

To select attribute files:

• In the Table menu, point to Add Attributes, and then click Select Attribute Files.

Select Columns commandSelect Columns allows you to specify the input address columns that MapMarker UK uses to match your records against its Address Dictionary when geocoding your table. Select Columns is available when a table is open.

To use Select Columns, do one of the following:

• In the Table menu, click Select Columns.

• Click on the MapMarker UK toolbar.• Click the secondary mouse button to display a shortcut menu, then click Select Columns.

130 MapMarker UK v4


Status Bar commandStatus Bar shows or hides the status bar at the bottom of the MapMarker UK window. The status bar is visible when the Status Bar command is checked.

To show or hide the MapMarker UK status bar:

• In the View menu, click Status Bar.

Stop Attribution commandStop Attribution stops the addition of attributes from another table. It instructs MapMarker UK to do the next geocoding pass in the normal way. It does not stop attribution during a geocoding or batch attribution operation. Stop Attribution is available when a table is open and attribute settings exist.

To stop attribution:

• In the Table menu, point to Add Attributes, and then click Stop Attribution.

Summary commandSummary displays the results of the previous geocoding pass. Summary is available after geocoding a table.

To view a geocoding summary:

• In the View menu, click Summary.

System Preferences commandSystem Preferences allows you to set system-wide preferences that relate to starting MapMarker UK, setting the Address Dictionary path(s), and selecting the preferred datum. System Preferences is always active when MapMarker UK is running.

To change system preferences, do one of the following:

• In the Options menu, click System Preferences.

• Click on the MapMarker UK toolbar.• Click the secondary mouse button to display a shortcut menu, then click System Preferences.

Tile commandTile arranges open windows side by side so that all windows are visible. Tile is always active when MapMarker UK is running and there is at least one table open.

To tile your open windows:

• In the Window menu, click Tile.

User Guide 131

MapMarker Dialogs

Toolbar commandToolbar shows or hides the MapMarker UK toolbar. The MapMarker UK toolbar is visible when the Toolbar command is checked.

To show or hide the MapMarker UK toolbar:

• In the View menu, click Toolbar.

MapMarker DialogsThis section describes the dialogs in MapMarker UK and what they are used for. The topics are organized in alphabetical order by dialog name. Use the list below to locate the description of the dialog you wish to learn about.

• About MapMarker dialog on page 133• Add Columns dialog on page 133• Automatic Geocode dialog on page 134• Bind Attribute Table Columns to Output Columns dialog on page 135• Describe Table Relationships dialog on page 138• Dictionary Preferences dialog on page 139• Fallback dialog on page 140• Filter Tables dialog on page 140• Font dialog on page 141• Geocode dialog on page 142• Geocoding Summary dialog on page 143• GeoResult dialog on page 144• Interactive Geocode dialog on page 145• Log File dialog on page 147• Match Restrictions dialog on page 148• Modify Table Structure dialog on page 149• Multiple Match dialog on page 150• Open Project command on page 129• Open Table dialog on page 152• Quick Find dialog on page 153• Related Table dialog on page 155• Save As dialog on page 155• Select Attribute Tables dialog on page 156• Select input columns from your table dialog on page 159• Select output columns from your table dialog on page 160• Select Project Files dialog on page 162• Select Table dialog on page 163• Select Table Type dialog on page 164• Startup Preferences dialog on page 164• Text File Wizard (Step 1 of 3) on page 166• Text File Wizard (Step 2 of 3) on page 167

132 MapMarker UK v4


• Text File Wizard (Step 3 of 3) on page 168

About MapMarker dialog

The About MapMarker UK message box displays information about your copy of MapMarker UK, including the version number, data vintages, and legal and licensing notices.

See also:About MapMarker command

Add Columns dialog

Tech Support

Click to view technical support information.

Copyright Click to view the product copyright information.

Close Click OK to close the dialog.

User Guide 133

MapMarker Dialogs

The Add Columns dialog appears when you open a table within MapMarker UK that does not contain one or more of the following columns: Latitude, Longitude, and GeoResult. This dialog prompts you to select which columns to add to your table. Columns you select are added to your table when it opens within MapMarker UK.

Automatic Geocode dialog

The Automatic Geocode dialog appears during an automatic geocoding pass. Within this dialog you can monitor the progress of your geocoding pass, noting the following types of information:

Add Latitude and Longitude columns (optional)

Click this check box to add latitude and longitude columns to your table.

Add Latitude column Click this check box to add a latitude column to your table.

Add Longitude column Click this check box to add a longitude column to your table.

Add GeoResult column (recommended)

Click this check box to add a georesult column to your table.

OK Invokes the settings and closes the dialog. The settings are saved in the table’s metadata until you clear them.

Cancel Cancels the operation and closes the dialog.

Help Displays help for this dialog.

Match Type Rows Percent

Matched Indicates number of rows successfully matched.

Indicates percent of rows successfully matched.

134 MapMarker UK v4


Bind Attribute Table Columns to Output Columns dialog

The Bind Attribute Table Columns to Output Columns dialog allows you to control the attribution operation, including how the attribution table and geocoding tables are related and where MapMarker UK stores the attributes in the output table.

No Match Indicates number of rows not matched. Indicates percent of rows not matched.

Previous Match Indicates number of rows geocoded in previous geocoding sessions.

Indicates percent of rows geocoded in previous geocoding sessions.

Match Type Rows Percent

Attribute Table Name Lists the attribute table(s) you set in the Select Attribute Tables dialog.

Join Information Group This portion of the dialog tells MapMarker UK how the geocoding and attribute tables are related.

Join Using Use the options in this group to specify how to join attribute and output tables.

Output Point Tells MapMarker UK to make the connection between the attribute and output tables by geography. The geocoded point in your table is compared with the geography in the attribute table. Requires the attribute table to have a MAP component file. Also requires the geocoding table to store the longitude and latitude values.

User Guide 135

MapMarker Dialogs

Column Value This type of link between attribute and output tables is based on matching columns. When this option is chosen the attribute table and output table columns lists become available.

Attribute Table Column Lists the indexed columns in the attribute table available for matching against the output columns in your geocoding table.

Output Table Column Lists the output columns available for matching to an indexed attribute column.

Characters used in comparison

The number of characters that MapMarker UK uses to compare attribute and output columns to make an exact match.

Bind Information Group The lower half of the dialog is where you identify the attributes you want added to your geocoding table and which columns to place them in.

Type/Attribute List Box Lists the type and names of attribute fields contained in the attribute table.

Type/Output Column List Box

Lists the type and column name of the output column where you want the attribute information stored.

Modify/Add Columns Click to access the Modify Table Structure dialog and add a new column to the table or modify an existing column.

Bind to Column Links to the highlighted attribute column and the output column.

Unbind Column Uncouples the highlighted attribute column and the output column.


Back Returns you to the Select Attribute Tables dialog.


Help Displays help on this dialog.

136 MapMarker UK v4


Datum Preferences dialog

The Datum Preference dialog allows you to control which datum you want to associate with your table. You can select either British National Grid (BNG) or Irish Transverse Mercator Grid (ITMG).

Use British National Grid for tables with no datum

Converts all table data to BNG and geocodes all records to coordinates with BNG datum.

Use Irish Transverse Mercator Grid for tables with no datum

Converts all table data to ITMG and geocodes all records to coordinates with ITMG datum.

OK Saves your settings and close the dialog.

Cancel Closes the dialog without saving your changes.

Apply Applies your settings without closing the dialog.

Help Displays help for this dialog.

User Guide 137

MapMarker Dialogs

Describe Table Relationships dialog

The Describe Table Relationships dialog allows you to create links between a remote source table and a local results table. This is part of the procedure for geocoding a remote table and writing the results to a related table.

Input Table Columns Lists the columns in the source table.

Output Table Keys Lists the columns in the results table.

Selected Input Keys Lists the input keys that correspond to a specific output key.

Selected Output Keys Lists the output keys that correspond to a specific input key. Up to six key combinations can be listed for a table.




138 MapMarker UK v4


Dictionary Preferences dialog

The Dictionary Preferences dialog allows you to specify the location of the Address Dictionary.

Use MapMarker Address Dictionary

Click this check box to use the Address Dictionary.

Path Specify the path for the MapMarker UK Address Dictionary. Click Browse to identify the current Address Dictionary path and other Address Dictionary paths you want MapMarker UK to search. The path(s) reflects all address dictionaries included with your installation. When adding additional paths to the list, separate each by a semicolon.

OK Closes the dialog and saves the changes that you have made.


Apply Applies the settings that you specified.

Help Displays help on the dialog.

User Guide 139

MapMarker Dialogs

Fallback dialog

The Fallback dialog allows you to specify if you want MapMarker UK to geocode to apostcode centroid if no close match is found at street level.

Filter Tables dialog

Use the options in this dialog to control what types of tables to display in the Select Table dialog.

Fallback to postcode match

Click this check box when you want to fall back to postcode matching.

Geocode Begins the geocoding operation.



Help Displays online help for this dialog.

Show Shows which types of tables to display in the Select Table dialog.

Tables Click this check box to display non-system tables in the Select Table dialog.

140 MapMarker UK v4


Font dialog

The Font dialog appears when you click Options > Choose Font. Use the Font dialog to set fonts for your table in the Browser window.

System Tables Click this check box to display system tables in the Select Table dialog.

Views Click this check box to display view tables in the Select Table dialog.

Note MapMarker UK supports Views only if you are geocoding a table and writing the outputs to another table.

Synonyms/Aliases Click this check box to display synonym/alias tables in the Select Table dialog.

OK Carries out the operation and closes the dialog.

Cancel Cancels the settings and closes the dialog.

Help Displays help on using this dialog.

Font In the Font list, click the font type from the scroll list.

Font Style Choose the font style from the scroll list.

Size Choose the font size from the scroll list.

Sample Displays a sample of the font using the selected font style and size.

Script In the Script list, click the font script that is appropriate for the font you want to use based on your computer’s default language setting.

OK Click OK to apply the font changes you specify and closes the dialog.

User Guide 141

MapMarker Dialogs

Geocode dialog

The Geocode dialog allows you to select a variety of preferences that control the method, precision, range, and levels of geocoding. Use this dialog to set options for the current geocoding operation.

Cancel Click Cancel to close the dialog without saving or applying your font changes.

Help Click Help to display online help for this dialog.

Table Displays the name of the table to be geocoded.

Geocode Operations Geocode to the specified level of precision.

Clean addresses and geocode

Geocode to street address level.

Method Choose from Automatic (default) or Interactive.

Geocode to postcode only

Geocode to the postal centroid. This is faster but less accurate than street level geocoding.

Range to Geocode Use the options in this group to specify which rows in your table to geocode.

All Rows Geocode the entire table.

Row Numbers Geocode a specific block of rows in your table. Enter the row number range in the text boxes below this option. Type the starting row number for the range in the first text box and the end row number for the range in the second text box.

Types of Rows to Geocode

Use the options in this group to specify which table rows within the range you specified in Range to Geocode you want to geocode.

142 MapMarker UK v4


Geocoding Summary dialog

The Geocoding Summary dialog appears at the end of a geocoding session. The Geocoding Summary dialog lists the results of the latest geocoding pass, including the number of new matches, unmatched records and previously matched records.

Unmatched Geocode all unmatched rows (rows for which the GeoResult field: blank or N).

All Types Geocode all rows.

GeoResult less than Geocode rows by match precision.

Use the drop-down list to choose the georesult code with the highest precision for which you want to geocode. Only use this option with a table that has already been geocoded. If you use this selection with a table that has not been geocoded, MapMarker UK geocodes all of the rows regardless of this selection.





Rows Percent

Matched Indicates number of rows successfully matched.

Indicates percent of rows successfully matched.

No Match Indicates number of rows not matched. Indicates percent of rows not matched.

User Guide 143

MapMarker Dialogs

GeoResult dialog

The Georesult dialog shows a breakdown of the result code for each record. To display this dialog, double-click on the code in your table’s result column in the Browser. This behavior is available after you have completed a geocoding pass or set the columns for a previously geocoded table. It is not available at the initial opening of the table.

Previous Match Indicates number of rows geocoded in previous geocoding sessions.

Indicates percent of rows geocoded in previous geocoding sessions.

Total Indicates total number of unmatched rows, entire table or block of rows examined.

Indicates total percent of rows examined.

Rows Percent

Address Displays the street address for the record you are viewing georesult information.

Postcode Displays the postcodefor the record you are viewing georesult information for

Result code Displays the result code for the record you are viewing georesult information

Match type Describes the type of match made while geocoding the record and to what level the record was geocoded.

Match details Indicates the criteria used in determining the match.

Close Click to close this dialog.

Help Contains help on this dialog.

144 MapMarker UK v4


Interactive Geocode dialog

Blue question marks indicate multiple close matches. (A green check mark in the Num column indicates a single close match.) Non-close matches do not have a check mark.

The Interactive Geocode dialog appears when the Interactive option is selected in the Geocode dialog. This dialog displays unmatched records one at a time and a list of suggested matches (if any). Click Geocode to accept the match or click Ignore to move to the next ungeocoded record.

Candidate Close Match Indicators

Symbol Description

Indicates a single close match candidate.

Indicates multiple close matches.

Indicates multiple non-close match candidates.

Summary The summary reflects the percentage of new matches, unmatched and previously matched records.

Matched Indicates percent of rows successfully matched.

No match Indicates percent of rows not matched.

User Guide 145

MapMarker Dialogs

Previous match Indicates percent of rows geocoded in previous geocoding sessions.

Percent complete A progress bar that updates the match count after each record.

Geocoding result Displays the results of geocoding for that record (for example no matches found, unknown address).

Input Address Use the drop-down list to select and display any column of the current address.

Address If Unformatted Address Entry was checked when you selected input columns, the Address field contain all the selected input columns. See step 3 of Selecting Input Columns on page 50.

Company If Formatted Address Entry was checked when you selected input columns, the Company field contains the name of the business residing at the address. See step 3 of Selecting Input Columns on page 50. The Street, Street2, Locality, Post Town, and Postcode fields are also displayed.

Street The primary street address.

Street2 The secondary street address (for example, an apartment or post office box number).

Locality The Locality (suburb). This is AreaName4

Post Town The postal town. This is AreaName3.

Postcode The postal code.

Write above address to database on Geocode

After editing a record, check this box to add the changes you made to the record’s address information into your table upon clicking Geocode.

Note: The existing input address is overwritten with your changes.

Search Click to re-search the Address Dictionary after you have set an expanded search area or after you have edited the input address.

Options Click to change the matching conditions for the displayed record.

Close Stops the interactive geocoding session and closes the dialog.


Back Click to go back to previous records to re-geocode. This is helpful to re-check previous geocoding decisions or to redo previous interactive geocodes.

146 MapMarker UK v4


Log File dialog

The Log File dialog allows you to set up a log file to track your matching conditions, geocoding results and other settings. The mapmarkr.log file is found in the MapMarker UK folder in the User documents area (typically C:\My Documents\MapMarker_UK\). Information from subsequent passes is appended to the top of the log file. The log file size limit is 1 MB.

Next Click to leave the record ungeocoded and skip to next unmatched record.

Geocode Click to geocode the specified match candidate if you agree that it is the correct match for your record. MapMarker UK assigns the coordinates from that record and moves on to display the next unmatched record in your file.

Update Log File Check to have MapMarker UK update the log file for each geocoding session. Information about the session appears at the top of the file.

Specify Log File Name Check the box and specify the name of the log file. The default is table.log, where table is the root name of the topmost opened table. If you do not specify a file name, the log file is named Mapmarkr.log.





User Guide 147

MapMarker Dialogs

Match Restrictions dialog

The Match Settings dialog allows you to adjust the match settings you require for your geocoding session. The same dialog is used for geocoding a table or for Quick Find Options.

House number When the House Number box is checked, candidate house numbers must be exactly matched to return a close match. When the House Number box is unchecked, MapMarker UK can make a close match even if the house number match is not exact.

Street name When the Street Name box is checked, candidate street names must be exactly matched to get a geocoding match. When the street name box is unchecked, MapMarker UK will accept similar street names as a match.

Town When the Town box is checked, MapMarker UK requires a town match. When this box in unchecked, the townname does not have to match.

By default, MapMarker UK is set to Exact Match Town and Exact Match Post district.

Postcode Check this box to require the use of postcode in determining an exact match. When Postcode is checked, you can match to Post District or the Full Postcode.

Post district A Post District match requires a match on the first part of the postcode (usually the first three characters) and a match on Street name. If the Street name is not matched, you will not get a close match candidate even if the Post District does match.

By default, MapMarker UK is set to Exact Match Town and Exact Match Post district.

148 MapMarker UK v4


Modify Table Structure dialog

The Modify Table Structure dialog allows you to change the structure of your geocoding table by adding, removing or changing information about the table’s columns. This is useful for creating columns “on the fly” when you want MapMarker UK to return additional data from the Address Dictionary for which you had not provided a column. This eliminates the time-consuming step of going outside of MapMarker UK to make these changes.

Full Postcode For Full Postcode, the complete postcode must be exactly matched to get a close match. However, if the postcode is omitted from input, (or an invalid postcode is entered) you may still get multiple close matches.

Clear Output Columns If No Match

If this box is checked, MapMarker UK removes existing output values for a record that it cannot match. If you want to preserve this data, such as longitude/latitude coordinates obtained from another source, clear the check box before geocoding the table.

Note This selection appears for Match Restrictions when geocoding a table, but does not appear for QuickFind Options Match Restrictions.


If this box is checked, MapMarker UK returns each range as a separate close match candidate.

Note This selection appears for the QuickFind Options Match Restrictions, but does not appear when geocoding a table.





User Guide 149

MapMarker Dialogs

Multiple Match dialog

The Multiple Match dialog allows you to instruct MapMarker UK on how to handle multiple candidate matches with the same candidate score for a record while geocoding.

Columns

Column Name Shows the existing columns for the table.

Type Indicates the type of column with the number of characters listed in parentheses.

Add Column Adds a new column to the table at the bottom of the list with the default name Field1, Field2 etc.

Remove Column Removes an existing column from the table.

Column Information Area where you can rename the column and change its type and width.

Name The name of the column.

Type The type of data the column contains.

Width The character width of the column.

OK Click to save your new column settings and close the dialog. The settings are saved in the table’s metadata until you clear them.



150 MapMarker UK v4


Open Project dialog

Use the Open Project dialog to open a MapMarker UK project. A project will preserve MapMarker UK preferences and table settings so that they can be easily restored when you open the project.

Do Not Match Click this option to not allow a match to be made for the record if multiple matches occur.

Accept First Click this option to accept the first candidate for the match.





Look in: Navigate to the folder that contains your project files. To see the folder hierarchy on your computer, click the down arrow. To see what is inside a folder, click it.

Double-click a folder or file in that box to open it.

File name: Type the name of the project file that you want to open. Project files always have a .proj file extension.

Files of type: MapMarker UK projects have a PROJ file extension,

Open Opens the selected project.



User Guide 151

MapMarker Dialogs

Opening and Running a Project

Open Table dialog

Use the Open dialog to open a street file for creating a User Dictionary. Use the Open Table dialog to open a MapInfo table to geocode.

Look in: Navigate to the folder that contains your project files. To see the folder hierarchy on your computer, click the down arrow. To see what is inside a folder, click it.

Double-click a folder or file in that box to open it.

File name: Type the name of the file that you want to open. You can use * as a wildcard. For example, you can type *.* to see a list of all files, regardless of file type.

You can also type the full path of a file.

Files of type: This is useful for narrowing the list of files displayed to only those files you are interested in.

The tables displayed are tables in MapInfo format (TAB) or any other supported file format. See Supported File Formats on page 37. Select the file format of the file you want to open.

Open Opens the file with the name, file type, and location you specified.



152 MapMarker UK v4


Quick Find dialog

The Quick Find dialog appears when you click Quick Find on the Search menu. Use this dialog to search for a single address match or to browse the Address Dictionary for a listing of street names or firms for a postcode.

You can also right-click on a candidate to display the context menu. From that menu, you can copy selected information to the clipboard. See Copying Information from the Quick Find Candidate List on page 91.

Address If Unformatted Address Entry is checked, you can enter the complete address on a single input line. If Formatted Address Entry is checked, you can enter each address element in a separate input field.

Not all address components are required. You can use delimiters (comma, semicolon, tab, or slash) between each component of the single line address. If no delimiters are present, MapMarker UK recognizes spaces as separators, but non-delimited addresses may take longer to geocode.

Company If Formatted Address Entry is checked, you can enter each address element as a separate field. Company is the name of the business residing at the address.

Street Specify the Street name.

Locality Specify the locality (AreaName4)

Post Town Specify the town (AreaName3).

User Guide 153

MapMarker Dialogs

Postcode Specify the postcode. Full postcode or post district can be used.

Search Allows you to search the Address Dictionary after you have entered the input address.

Options Changes the Match Restrictions used by Quick Find.

Clear Fields Clears the address fields and items in the candidates list.

Match Candidate List The list box contains either the message “no suggestions available” or at least one candidate that MapMarker UK deems a suitable match for the input information provided. The candidates include the result code followed by the street address.

A green check mark in the Num column indicates a close match. See Geocoding with Quick Find on page 89 for details of the match candidate list for the Quick Find dialog.

Close Stops the search for a match and closes the dialog.


154 MapMarker UK v4


Related Table dialog

This dialog only appears if you are geocoding a remote table and want to write the results to a related table. It tells MapMarker UK whether you want to optimize the geocoding operation for inserting new records or for updating existing records.

Note This feature is not available for single remote table geocoding.

Save As dialogThe basic "Save As" dialog is used in several contexts.

Save Batch File

Save Project File

Optimize for Insertion Choose this option if your results table is new or contains few records.

Optimize for Update Choose this option if your results table contains many records are likely to be updated.





User Guide 155

MapMarker Dialogs

Save Batch File

The Save As dialog appears when you select Create Batch File from the Table menu. Use it to navigate to a folder in which to save your batch file.

Save Project File

The Save As dialog appears when you select File > Projects > Create/Save Project. Use it to name a project with a PROJ file extension. See Creating and Saving a Project on page 76.

Select Attribute Tables dialog

156 MapMarker UK v4


The Select Attribute Tables dialog allows you to choose the attribute tables MapMarker UK accesses during the attribution process.

After you choose attribute tables, you are ready to bind these table columns to the output columns. See Bind Attribute Table Columns to Output Columns dialog on page 135.

Select Data SourceWhen using a remote table as a geocoding source, you can select either a file data source or a machine-specific data source.

Available Tables Displays the directory structure of the chosen drive that contains the table you want MapMarker UK to use for tagging.

Selected Tables Displays the table(s) you have chosen for the attribution process.

Add Adds the highlighted table in the Available Tables list to the Selected Tables list.

Remove Removes the highlighted table(s) from the Selected Tables list.

Remove All Removes all items from the Selected Tables list.

Drives Lists the drives on the system. The chosen drive displays the directory structure in the Available Tables list.

OK Invokes the settings and closes the dialog.



User Guide 157

MapMarker Dialogs

File Data Source Data source can potentially be shared over network by authorized users. You can use any file data source that refers to an ODBC driver that is installed on your system.

Machine Data Source Data source is specific to a machine. User data sources are specific to a user on this machine. System data sources can be used by all users on this machine.

158 MapMarker UK v4


Select input columns from your table dialog

Use this dialog to choose the fields from your table that contain the address information to be matched against the Address Dictionary during the geocoding operation.

Table Identifies the name of the table and lists all columns in the table that can be selected. Highlight an address column name and drag it to the appropriate address component box. If the table has been previously geocoded, MapMarker UK remembers the fields from the table’s metadata. If this is the first time you have geocoded this table, MapMarker UK attempts to guess at the correct fields by examining their field names. To view the complete name of a field that extends beyond the box provided, hold the cursor over the field name and MapMarker UK displays a popup box with the full name of the field.

Address Fields If Unformatted Address Entry is checked, you can select multiple columns from your table and add them to a single input field. See Selecting Input Columns on page 50 for details.

Company If Formatted Address Entry is checked, you can map each input column into its own input field. Specify the field that contains the name of the organization associated with the record, if any.

User Guide 159

MapMarker Dialogs

Select output columns from your table dialog

Address Select the column from your table that contains the primary address data. Single line address input is recognized in the ADDRESS column. single line addresses appear on a single line. You can use delimiters (comma, semicolon, colon, or tab) between each component of the single line address. If no delimiters are present in the address, MapMarker UK recognizes spaces as separators, but non-delimited addresses may take longer to geocode.

Address2 Select the secondary address column. The secondary address is usually used for apartment numbers or post office box numbers. This optional information is appended to the end of the street to form the complete address to be parsed.

Locality Select the column containing the locality (AreaName4).

Post Town Select the column containing the town (AreaName3).

Postcode Select the column containing the postcode (Post District or full Postcode).

Modify/Add Columns

Leads to the Modify Table Structure dialog where you can add, remove or change information about the columns in the open table.

Next Moves to the Select Output Columns dialog.



160 MapMarker UK v4


In this dialog, you specify the columns to contain the results of the geocoding operation, such as: result code, address fields, X Coordinate, and Y Coordinate. This dialog appears when you click Next in the Select Input Columns dialog after selecting your input address column choices.

Table Identifies the name of the table and lists all columns in the table that can be selected. Highlight an address column name and drag to the appropriate address component box. If the table has been previously geocoded, MapMarker UK remembers the fields from the table’s metadata. If this is the first time you have geocoded this table, MapMarker UK attempts to guess at the correct fields by examining their field names. To view the complete name of a field that extends beyond the box provided, hold the cursor over the field name and MapMarker UK displays a popup box with the full name of the field.

Status Column Select the column where MapMarker UK stores the result code after it attempts to geocode. MapMarker UK generates a code for each record. The code indicates how the record was matched and whether the match is exact. Use the code to diagnose MapMarker UK performance, to identify false positives, and analyze ungeocoded records. This column is optional, but highly recommended.

Coordinate Columns

For local tables, choose the columns where longitude (x coordinate) and latitude (y coordinate) information is written when a record is geocoded. These columns are optional when “Create Points” is selected.

Output Address Columns

Specify the columns for these components if you want MapMarker UK to return the address information from the Address Dictionary. To avoid overwriting your input data, you should identify output columns with unique names compared to the Select Input Columns dialog. For example, if you had a Postcode input column you could create a Postcode_O column for output purposes.

See Specify Output Address Columnsfor more information.

Back Returns to the Select Input Columns dialog.

Finish Completes the columns selection process and closes the dialog.



User Guide 161

MapMarker Dialogs

Select Project Files dialog

This dialog appears when you create a batch file to run a project that was created with a TXT file. After you complete this dialog, you will see the Save As dialog.

Field Description

Available Projects Displays the available projects that you can add to a project-based batch file.

Selected Projects Displays the project(s) you have chosen for the batch file.

Add Adds the highlighted table in the Available Projects list to the Selected Projects list.

Remove Removes the highlighted Project(s) from the Selected Projects list.

Remove All Removes all items from the Selected Projects list.

Drives Use the drop-down arrow to select from the available drives on the system.

OK Invokes the settings and closes the dialog.


Help Provides help on this dialog.

162 MapMarker UK v4


Select Table dialog

This dialog appears after selecting a data source when opening an ODBC table. Use this dialog to select the table you wish to open within the data source you specified.

Owner Specify the owner of the table.

Filter Click to set filters on the types of tables you want to select from.

list of tables List of all tables in the database that are owned by you or accessible to you, constrained by the filters you set. Choose which table you want to geocode.


User Guide 163

MapMarker Dialogs

Select Table Type dialog

This dialog prompts you to choose between opening a MapInfo TAB or other supported file format or an ODBC table. This dialog appears if you have set startup preferences to open both local and remote (ODBC) tables when you start MapMarker UK. See Startup Preferences dialog on page 164.

Startup Preferences dialog



Open MapInfo table, or .dbf file

Click this option if you want to open a MapInfo TAB, DBF, or other supported file format. This includes CSV or other delimited files. See Supported File Formats on page 37.

Open ODBC table Click this option if you want to open an ODBC table.




164 MapMarker UK v4


The Startup tab identifies the settings MapMarker UK uses when you start the application. You can select any or all check boxes. If you select either Show MapInfo/dBASE files or Show for ODBC tables, the Open dialog will be displayed automatically when you start MapMarker UK. If you check both boxes, MapMarker UK prompts you with another dialog at startup to choose which type of table you want to open.

File Open Startup Options

Check either or both boxes in this group:

• Show for MapInfo TAB or dBASE files.• Show for ODBC Tables

If you check both items, MapMarker UK prompts you to choose which table type you want to open when you start MapMarker UK.

Show Select Column Dialog On Open

The Select Input Columns dialog automatically appears when you open a table. This is the default setting.

Select Attribute Files After Selecting Columns

The Select Attribute Tables dialog appears after you choose input and output columns for the open table. The default setting is not to display this dialog.

Show Geocode Dialog After Selecting Columns

The Geocode dialog appears automatically once you have opened your table and identified the address columns for geocoding. This is the default setting.

Log file Viewer Identify a viewer for MapMarker UK to display a message log file at the conclusion of the geocoding pass. Provide the viewer name in the box or click Browse to find its location. Windows Notepad is the default viewer.

OK Closes the dialog and saves the changes that you have made.

Cancel Closes the dialog and cancels the changes that you have made.



User Guide 165

MapMarker Dialogs

Text File Wizard (Step 1 of 3)

This is the first dialog box in the Text File Wizard.

Text File Type Delimited is the only supported text file type.

Delimiter Type If MapMarker UK can determine the delimiter type (comma, semicolon, tab, slash, or other), the delimiter will be preselected. Otherwise, you can specify the delimiter type (comma, semicolon, tab, slash, or other).

First Line Used for Column Titles

Specifies that the first line of the input file is used for column titles rather than data.

Next Go to the next dialog in the Text File Wizard.



166 MapMarker UK v4



This is the second dialog box in the Text File Wizard. Click a field name to see all the relevant the Information for that field. You can view this information and may be able to change some fields.

Fields Click a field name to see all the relevant the Information for that field. You can use the following fields to view and possibly change any of this information.

Name Displays the name of the selected field.

Width Displays the width of the selected field. This cannot be changed in this dialog.

List Box The list box area at the bottom of the dialog will display up to the first 20 records of the opened file.

Back Returns to Text File Wizard (Step 1 of 3).

Next Go to the next dialog in the Text File Wizard.



User Guide 167

MapMarker Dialogs


This is the final step of the Text File Wizard.

Input Path This shows the data input path. This is for display only and cannot be changes at this point.

Output Path Specify the full path of the output file. If the file already exists, data will be overwritten.

Back Returns to Text File Wizard (Step 2 of 3).

OK Completes the Text File Wizard.



168 MapMarker UK v4


User Guide 169

B
Creating a Map Catalog Manually
This appendix includes instructions for creating a MapInfo Map Catalog manually and making a remote table mappable, two procedures that are necessary for geocoding remote tables. This information is designed for users who do not have access to MapInfo Professional. If you have MapInfo Professional, see the MapInfo Professional User’s Guide for instructions on carrying out these procedures automatically.

For complete details on remote table geocoding see Geocoding Remote Tables in Chapter 6 on page 107.

In this appendix:

Manually Creating a MapInfo Map Catalog . . . . . . . . . . . . . . . . .171Adding Rows to the MapInfo_MapCatalog. . . . . . . . . . . . . . . . . .172

Chapter B: Creating a Map Catalog Manually

Manually Creating a MapInfo Map CatalogIf you are not a MapInfo Professional or EasyLoader user, you or your database administrator will need to create the Map Catalog manually, as described below. You only have to create the Map Catalog once per server/database.

1. Create the user MAPINFO in the specific database where the mappable tables are located.2. Create the table MAPINFO_MAPCATALOG in the database.

The Create Table statement needs to be equivalent to the following SQL Create Table statement:

Create Table MAPINFO_MAPCATALOG (SPATIALTYPE Float,TABLENAME Char(32),OWNERNAME Char(32),SPATIALCOLUMN Char(32),DB_X_LL Float,DB_Y_LL Float,DB_X_UR Float,DB_Y_UR Float,VIEW_X_LL Float,VIEW_Y_LL Float,VIEW_X_UR Float,VIEW_Y_UR Float,COORDINATESYSTEM Char(254),SYMBOL Char(254),XCOLUMNNAME Char(32),YCOLUMNNAME Char(32),RENDITIONTYPE INTEGER,RENDITIONCOLUMN CHAR(32),RENDITIONTABLE CHAR(32)NUMBER_ROWS INTEGER)

Note It is important that the structure of the table looks exactly like this statement. The only substitution that can be made is for databases that support varchar or text data types; these data types can be substituted for the Char data type.

3. Create a unique index on the TABLENAME and the OWNERNAME, so only one table for each owner can be made mappable.

create unique index mapcat_i1on mapinfo.mapinfo_catalog (OwnerName,TableName)

4. Grant Select, Update, Insert, and Delete privileges on the MAPINFO_MAPCATALOG. This allows users to make tables mappable.

grant select, insert, update, delete on mapinfo.mapinfo_mapcatalog to public

Developer Guide 171

Adding Rows to the MapInfo_MapCatalog

Adding Rows to the MapInfo_MapCatalogFor each spatial table that you want to access from your application, you need to add a row to the MAPINFO_MAPCATALOG table. If you do not use MapInfo Professional to manage the MapInfo_MapCatalog, you will have to add rows to the MAPINFO_MAPCATALOG table manually.

The following describes the syntax and meaning of each column in the Map Catalog Table.

Map Catalog Table

Column Name Values to Assign Examples

SPATIALTYPE MapInfo Spatial Object Format See Spatial Index Types for SPATIALTYPE

Spatial Object Type

x.0: Points onlyx.1: Lines onlyx.2: Regions onlyx.3: All types supported

This column describes the Spatial Object Format of how the data is stored and indexed and the Spatial Object type(s) supported and not supported in the column. The digits to the left of the decimal point are the Spatial Object Format. The digits to the right represent the type of Spatial Object Type that can be stored in the column

14.0 = SQL Server14.114.214.3

TABLENAME The name of the table. CUSTOMERS

OWNERNAME The owner name of the table. BOB

SPATIALCOLUMN The name of the column, if any, containing spatial features:SW_GEOMETRY(mappable using SpatialWare Type/IDS/UDO)NO_COLUMN (mappable using X–Y)MI_SQL_MICODE (mappable using MI Code) Or the name of the IDS/UDO, or Oracle column that is ST_SPATIAL datatype. Name of the Oracle SDO_GEOMETRY column.

SW_GEOMETRY

DB_X_LL The X coordinate of the lower left corner of the layer’s bounding rectangle, in units that are indicated by the COORDINATESYSTEM (see below).

–360

DB_Y_LL The lower left bounding Y value. –90

DB_X_UR The upper right bounding X value. 360

DB_Y_UR The upper right bounding Y value. 90



VIEW_X_LL The X coordinate of the lower left corner of the default view.

The default view only applies if this is the first table to be opened.

-180

VIEW_Y_LL The lower left bounding Y value of the default view. -45

VIEW_X_UR The upper right bounding X value of the default view. 180

VIEW_Y_UR The upper right bounding Y value of the default view. 45

COORDINATESYSTEM A string representing a MapInfo CoordSys clause (but without the keyword CoordSys at the very start), which specifies a map projection, coordinate units, etc. For simple Lon/Lat maps, specify Earth Projection 1, 0.

Earth Projection 1, 0

SYMBOL A MapInfo Symbol clause (if the layer contains only points); or a Symbol clause followed by a Pen clause (indicating styles for linear features) followed by another Pen clause (indicating styles for the borders of regions) followed by a Brush clause.

Symbol(35,0,12) Pen(1,2,0) Pen(1,2,0) Brush(2,255,255)

XCOLUMNNAME For the X/Y mappable tables, specify the name of the column containing X-coordinates. If there is no such column (i.e., if this table uses a single spatial column instead of a pair of X-Y columns) then specify NO_COLUMN or leave empty.

NO_COLUMN

YCOLUMNNAME For the X/Y mappable tables, specify the name of the column containing Y–coordinates, or specify NO_COLUMN

NO_COLUMN

Map Catalog Table (continued)


Developer Guide 173


RENDITIONTYPE This indicates how the object style information is applied.

0 – Indicates that all the objects in the table will have the style specified in the symbol field of the MapCatalog applied to them. No per-record styles are in effect. Objects will be read/updated using the default style for the table.

1 – Indicates that the table uses per-record styles. The table has a separate column that contains a MapBasic string representation of the style information for each object in the table (the same format that is currently used in the MapCatalog’s SYMBOL column). The style column in the table is recorded in RENDITIONCOLUMN.

0 or 1

RENDITIONCOLUMN If RENDITIONTYPE is 1, this field stores the name of the column in the spatial table that contains style information. This column is automatically added to any query against the table and is maintained (updated) as the object is updated. Users should NOT specify this column in their queries as problems can occur with intersect or update statements. Queries which include this column in the select clause (excluding the wildcard character “*”) may access the values through the Dataset object. Rows with a NULL value in their style column will have the style from the SYMBOL field of the MapCatalog applied to the object.

Creates a MapInfo.Column.DataType with MIDBType.Style

MI_SYMBOLOGY

RENDITIONTABLE Currently not used, but reserved for future use. NULL

NUMBER_ROWS Currently used by MapInfo Professional. NULL

Map Catalog Table (continued)




Spatial Index Types for SPATIALTYPEThis table lists the supported Spatial Index types for SPATIALTYPE.

.

Per-Record StylesPer-record style allows geometry in a single table to have its own style. For example, a single 'public institution' table in Oracle Spatial can have schools, town halls, libraries, and police departments and each point type would be represented with its own symbol (i.e., a school symbol for all the schools). Similarly, a single road table in SpatialWare SQL Server may have different road types such that streets are shown as a single pixel black line and secondary roads as a double pixel red line.

To use per-record styles, your table must be represented with an entry in the MapInfo Map Catalog with appropriate settings for RENDITIONTYPE, RENDITIONCOLUMN, and RENDITIONTABLE.

Note If these columns are not present, the table’s default style will be applied to all objects.

Symbol, Pen, Brush Clause SyntaxIf you are manually creating a MAPINFO_MAPCATALOG table to provide support for a remote spatial database, you will need to specify a symbol style, and possibly line and fill styles as well.

Specifying Point Styles

Use a Symbol clause to specify point styles. There are three types of Symbol clauses: one for specifying MapInfo 3.0-style symbols; one for specifying TrueType font symbols; and one for specifying bitmap symbols.

Spatial Index Types

Spatial Index Type Type Number

MapInfo MICODE schema (any database) — Point layer in X/Y columns indexed with micode (a serialized quadtree key)

1

XY schema (any database) — Point layer in X/Y columns 4

Oracle Spatial Geometry 13.x

SpatialWare for Microsoft SQL Server 14.x

Oracle Spatial Annotation Text 16.x

SQL Server Spatial (for geometry) 17.x

SQL Server Spatial (for geography) 18.x

PostGIS for PostgreSQL 19.x

SQL Server Spatial with M and Z values (for geometry) 20.x

SQL Server Spatial with M and Z values (for geography) 21.x

Developer Guide 175


Specifying Line Styles

Use a Pen clause to specify line styles. In a MAPINFO_MAPCATALOG table, you may need to specify two pen clauses: one to specify the appearance of linear features, and another to specify the appearance of region borders.

Specifying Fill Styles

Use a Brush clause to specify the style for closed features (regions).

Point Styles

Symbol Syntax Example

Symbol(shape, color, size)orSymbol(shape,color,size,font,fontstyle,rotation)orSymbol(bitmapname,color,size,customstyle)

Symbol(35,0,12)

Symbol(64,255,12,"MapInfo Weather",17,0)

Symbol("sign.bmp", 255, 18, 0)

Line Styles

Pen Syntax Example

Pen(thickness, pattern, color) Pen(1, 2, 0)

Fill Styles

Brush Syntax Example

Brush(pattern,color,backgroundcolor) Brush(2, 255, 65535)


Index

AAbout MapMarker

dialog 133About MapMarker dialogs 132About MapMarker menu command 125accessing remote tables

MapInfo_MapCatalog 171specifying styles 175

Add Columnsdialog 133

address dictionarydefinition 35installing 21storing on hard drive 21

address matchinggeocoding 11input columns 39, 50–51, 54output columns 40–41, 53

Arrange Icons menu command 126attribution

add output column 55adding attributes 103–104adding columns 99attaching data to geocoded records 98batch process 103clearing file selections 105column value 99, 101–102considerations 105output point 99–101selecting a table 100stopping 104–105

attribution tableselecting 100

automatic geocoding 56, 134

Bbatch add attributes 126batch attribution 103batch file

creating manually 95batch geocoding 94–96, 98best match from multiple candidates

result codes 122bind attribute table columns to output columns135binding

attribute columns to output 55, 71brush styles

in remote spatial tables 175

Ccandidates

definition 35Cascade menu command 126centroid

definition 35Choose Font menu command 126clear file selections 126client installation 32close match

definition 35Close menu command 126column value attribution 99, 101–102columns

input 39, 50–51, 54output 40–41, 53

commands 125copy from quick find results

quick findcopy from 91

Create Batch File menu command 127Create/Save Project menu command 127creating

map catalogs 110MapInfo_MapCatalog 171

Ddata

User Guide 177

installing 21storing 21

databasessupported 108

Datum preferencesdialog 137

dBASE files, geocoding 88delimited text file

first line 47output 49

delimiter type 46Describe Table Relationships

dialog 138dialogs

About MapMarker 133Add Columns 133Automatic Geocode 134Bind Attribute Table Columns to Output

Columns 135Datum preferences 137Describe Table Relationships 138Dictionary preferences 139Fallback preferences 140Filter Tables 140Font 141Geocode preferences 142Geocoding Summary 143GeoResult 144Interactive Geocode 145Log File preferences 147Match Settings 148Modify Table Structure 149Multiple Match preferences 150Open 152Quick Find 153Quick Find Settings 148Related Table 155Save Batch File As 156Select Attribute Tables 156Select input columns from your table 159Select output columns from your table 160Select Table 163Select Table Type 164Startup Preferences 164Text File Wizard 167Text File Wizard 1 166Text File Wizard 3 168

dictionary preferencesdialog 139

displaying geocoded records 68

Eediting records interactively 60error files

location 72exact match 73Exit menu command 127expanded ranges

quick find 90

Ffallback

postcode 64fallback preference

to postcode 75fallback preferences

dialog 140false positives

reducing 82fill styles

in remote spatial tables 176Filter Tables

dialog 140Font

dialog 141formatted address entry 61formatted address input 52

GGeocode

menu command 128toolbar button 128

geocodingscoring model 37street address 60

geocoding matchespositional accuracy 82strategies 81–82

geocoding preferences 69, 72, 142geocoding procedures

address columns 50–51, 53–54automatic 56dBASE files 88displaying geocoded records 68interactive 57, 60one pass 83quick geocode 88re-geocoding a table 69to postcode centroids 66using quick geocode 88

geocoding remote databasesaccessing remote tables 110

178 MapMarker UK v4

preparation procedures 109related table geocoding 112remote mappable tables 108, 110rollback segment limit 117supported data types 118transaction control 117

geocoding resultsoutput columns 40

Geocoding Summarydialog 143

geocoding terms 35GeoResult

dialog 144

HHelp Topics


historic postcode 62

Iinput column settings

saving to a table 76installation

client 32graphical interface 23modifying 29multiple versions of MapMarker 30new installation 23removing MapMarker 31shared 21silent install 28UNIX/Linux 23upgrading 30Windows procedure 23

Interactive Geocodedialog 145

interactive geocoding 57, 60

Lline styles

in remote spatial tables 176locality alias 62log file preferences 72, 147Logfile menu command 128longitude/latitude columns 40–41

Mmap catalog

creating 110remote mappable tables 108

MapInfo_MapCatalogadding rows 172, 174, 176creating 171spatial index types 175

mappable tablesadding rows to MapCatalog 172, 174

Match Settingsdialog 148

match settings 81exact match 73specifying 73

matching addressesinput columns 39, 50–51, 54output columns 40–41, 53with geographic data 11

matching conditionschanging interactively 60fallback settings 74multiple matches 75relaxing 84

matching strategies 81–82menu command

Arrange Icons 126Batch Add Attributes 126Cascade 126Choose Font 126Clear File Selections 126Close 126Create Batch File 127Create/Save Project 127Exit 127Geocode 128Help Topics 128Logfile 128Open Browser List 128–129Open Project 129Open Table 129Quick Find 129Quick Geocode 130Recent File List 130Select Attribute Files 130Select Columns 130Status Bar 131Stop Attribution 131Summary 131System Preferences 131Tile 131Toolbar 132

menu commands 125About MapMarker 125

metadatasaving settings to a table 76

modify install

User Guide 179

graphical interface 29silent 29

modifying table structure 149Multiple Match preferences

dialog 150multiple matches

choice of actions 85must match

definition 36

Nnetwork installation 21Northern Ireland addresses 64

OODBC tables

geocoding 113–115supported data types 118transaction control 117

Opendialog 152

Open Browser Listmenu command 129toolbar button 129

Open Browser List menu command 128Open Project menu command 129Open Table


optimizing performance 39output columns

geocoding results 40–41saving to a table 76

output point attribution 99–101

Ppen styles

in remote spatial tables 175performance

optimizing 23, 39per-record styles 174–175PO Box input 63point styles

in remote spatial tables 175positional accuracy

geocoded records 82postal centroid match

result codes 123postal geocode 66postal geocoding 66

definition 36postcode

definition 36fallback 64relaxing match conditions 84

postDirectionaldefinition 36

postTypedefinition 36

preDirectionaldefinition 36

preferencesfallback settings 74fallback to postcode 75geocoding 69, 72log file 72match restrictions 73multiple matches 75startup 42

projectopening 43saving 76using 43

QQuick Find


quick findexpand ranges as candidates 90settings 93

quick find commanddialog 153finding a single address 89settings 148

Quick Geocodemenu command 130toolbar button 130

quick geocode button 88

RRDBMS 108Recent File List menu command 130re-geocoding 69related table geocoding 112, 155relational database management systems 108relative matching 37relaxing match conditions 84remote database geocoding

geocoding procedure 110–111preparation 109preparation procedures 110remote mappable tables 108, 110rollback segment limit 117

180 MapMarker UK v4

supported data types 118transaction control 117

remote database views 116remote mappable tables

making a remote table mappable 110MapInfo map catalog 108supported data types 108supported spatial index types 108

remote spatial tablesadding rows to MapCatalog 172, 174, 176MapInfo_MapCatalog 171per-record styles 174–175specifying styles 175styles 176

remote tablesadditional considerations 116, 118

removing MapMarker from your system 31result codes

best match from multiple candidates 122definition 36M category 122output columns 40–41postal centroid match 123S category 120single close match 120Z category 123

rollback segment limitremote databases 117

running MapMarker 43

SSave Batch File As

dialog 156saving settings to a table 76Select Attribute Files menu command 130select attribute tables 156Select Columns


select input columns 39Select input columns from your table

dialog 159Select output columns from your table

dialog 160Select Table

dialog 163Select Table Type

dialog 164settings and preferences

saved in project 76silent install 28silent modify 29

silent uninstall 32silent upgrade 31single line address 65, 92

geocoding 65, 91input 52

single match result codes 120spatial index types 108, 175starting MapMarker Desktop Application 33Startup Preferences

dialog 164startup preferences 42Status Bar menu command 131Stop Attribution menu command 131street address geocoding 60street level geocoding

definition 36street names

relaxing match conditions 84styles

in remote spatial tables 175Summary menu command 131supported databases 108symbol styles

in remote spatial tables 175System Preferences menu command 131

Ttable attribution

add output column 55adding attributes 103–104adding columns 99clearing file selections 105column value 99, 101–102considerations 105output point 99–101selecting a table 100stopping 104–105

tablesediting records while geocoding 60ODBC 117opening 44saving settings 76sorting before geocoding 39

text fileopening 44type 46

Text File Wizarddialog 1 166dialog 3 168

Text File Wizard 2dialog 2 167Tile menu command 131Tips for Using Attribution 105

User Guide 181

toolbar buttons 125Geocode 128Help Topics 128Open Browser List 129Open Table 129Quick Find 129Quick Geocode 130Select Columns 130

Toolbar menu command 132transaction control 117

ODBC tables 117

Uunformatted address 65, 91–92uninstall 31

graphical interface 31silent 32

updated recordsre-geocoding a table 69

upgrade install 30graphical interface 30silent 31

182 MapMarker UK v4