beautypg.com

Pitney Bowes MapXtreme User Manual

Page 338

background image

Chapter 18: Geocoding

Using Constraints for Accurate Geocoding

MapXtreme v7.1

345

Developer Guide

FallbackToPostal – Determines if a street geocode request which produces no close
candidates, the geocode is performed on the postal code centroid. The default value is set to
false.

OffsetFromStreet – Determines the distance from the street segment at which the address is
positioned. This value is used to prevent addresses across the street from each other from being
given the same point. For example, a house with number 50 on a segment that spans from 40 to
60 is interpolated as the midpoint of the segment. The OffsetFromStreet positions the point
perpendicular from the road, so that houses on the left side of the street appear on the left, and
the houses on the right side of the street appear on the right. The default value for
OffsetFromStreet is 25 meters. The Distance class is used to specify the OffsetFromStreet by
defining the value and unit of measure.

OffsetFromCorner – Determines the distance from the end (corner) of a street segment at
which the address is positioned. This value is used to prevent addresses at street corners from
being given the same point of the intersection. OffsetFromCorner positions the point parallel to
the street (based on the street address) a distance along the segment. For example, a house
with number 40 on a segment that spans from 40 to 60 is positioned so that its point is not
located at the street intersection. The default value for OffsetFromCorner is 25 meters. The
Distance class is used to specify the OffsetFromCorner by defining the value and unit of
measure.

MaxCandidates – Defines the maximum number of candidates returned in a response. The
actual number of candidates returned may be less than this maximum value. A value of -1 is
used to mean return all candidates that meet the other constraints. The default is 3 when using
the MapInfo geocoding server. The default is -1 (all) when using the Envinsa Location Utility
Service.

MaxRanges – This preference controls whether a geocode operation returns the exact number
for a street address or a range of numbers. If the MaxRanges is set to 0, then no ranges are
returned and only the exact address number is returned. If the MaxRanges is set to a value
greater than 0, then that number of street address numbers is returned. The default value for
MaxRanges is 0. For example, if MaxRanges is set to 5, then the service returns up to 5 matches
within the address range. A value of -1 returns all suitable matches.

MaxRangeUnits – Defines the maximum number of candidate range units to be returned per
candidate range. The default value for MaxRangeUnits is zero (0).

GeocodeType – Determines the type of geocoding when available from the server. Refer to your
server or service documentation for information on geocode type support.

LocalGeocodeConstraints – Allows you to set country specific constraints which are specific to
that country and that geocoder. These values are always Key/Value pairs. Refer to your server or
service documentation for information on available local constraints.

DictionaryUsage – Specifies if the server address dictionary is to be used by itself, if a
configured user dictionary is to be used by itself, or if both of them are to be used. If both are to
be used, a preference of one over the other can be requested. By default the AD_AND_UD
option is used. This option indicates that the server address dictionary and any user dictionaries
that are configured should be used. For information on creating and accessing user dictionaries,
refer to your server or service documentation.

UseCASSRules – Specifies if CASS level geocoding should be used by the server (US only).
CASS certification is a process by which a table of mailing addresses is standardized to meet
U.S. Postal Service® (USPS) requirements for bulk mailing discounts. The geocoding client
performs this address standardization under strict matching conditions set by the U.S. Postal
Service while it geocodes your records. You must deploy a version of the US geocode data