Geocoding Guide for India - United...

Spectrum Technology PlatformVersion 9.0

Geocoding Guide for India

Contents

Chapter 1: Geocode Address Global.................................................................5Input........................................................................................................................6

Input Fields...................................................................................................6Address Input Guidelines.............................................................................7Single Line Input...........................................................................................8Street Intersection Input...............................................................................9

Options...................................................................................................................9Geocoding Options.......................................................................................9Matching Options........................................................................................12Data Options...............................................................................................15Output Data Options...................................................................................17

Output...................................................................................................................17Address Output...........................................................................................17Geocode Output.........................................................................................20Result Codes..............................................................................................21

Chapter 2: Reverse Geocode Address Global...............................................23Input......................................................................................................................24Options.................................................................................................................24

Geocoding Options.....................................................................................24Matching Options........................................................................................26Data Options...............................................................................................26

Output...................................................................................................................27

Chapter 3: Result Codes for International Geocoding..................................31International Street Geocoding Result Codes (S Codes)................................32Interpreting S Result Codes...............................................................................32International Postal Geocoding Result Codes (Z Codes)................................34International Geographic Geocoding Result Codes (G Codes)......................34Reverse Geocoding Codes (R Codes)...............................................................34Non-match Codes................................................................................................35

1Geocode Address Global

Geocode Address Global provides street-level geocoding for many countries. Itcan also determine city or locality centroids, as well as postal code centroids.Geocode Address Global handles street addresses in the native language andformat. For example, a typical French formatted address might have a street nameof Rue des Remparts. A typical German formatted address could have a streetname Bahnhofstrasse.

Geocode Address Global does not support U.S. or U.K. addresses. Togeocode U.S. addresses, use Geocode US Address. To geocode U.K.addresses, use Geocode Address GBR.

Note:

The countries available to you depends on which country databases you haveinstalled. For example, if you have databases for Canada, Italy, and Australiainstalled, Geocode Address Global would be able to geocode addresses in thesecountries in a single stage. Before you can work with Geocode Address Global,you must define a global database resource containing a database for one ormore countries. Once you create the database resource, a Geocode AddressGlobal will become available in the Management Console, Enterprise Designer,and Interactive Driver.

Geocode Address Global is an optional component of the Enterprise GeocodingModule.

In this section:

• Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6• Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9• Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

InputGeocode Address Global takes an address or intersection as input. To obtain the best performance andthemost possible matches, your input address lists should be as complete as possible, free of misspellingsand incomplete addresses, and as close to postal authority standards as possible. Most postal authoritieshave websites that contain information about address standards for their particular country.

Input FieldsFor India, Geocode Address Global takes an address or intersection as input. To obtain the bestperformance and the most possible matches, your input address lists should be as complete as possible,free of misspellings and incomplete addresses, and as close to postal authority standards as possible.Most postal authorities have websites that contain information about address standards for their particularcountry.

The following table lists the input fields used for geocoding locations in India.

If you are using the API, specify input using the DataTable class. The fields described below arethe valid column names in the DataTable class. For information on the DataTable class, see the"API Fundamentals" section of the Spectrum™ Technology Platform API Guide.

Note:

Table 1: Input Fields

DescriptionField Name

One of the following:AddressLine1

• The address line containing the street name and building number.For example:

Gunjur RoadBangalore South 560017

• This field can also contain the full address. For more information,see Single Line Input on page 8

• For all countries except Argentina, Great Britain, and Japan, thisfield can contain a street intersection. To specify a streetintersection, use double ampersand (&&) to separate the streets.For more information, see Street Intersection Input on page 9.

This field is not used in this country.AddressLine2

The city or town name. Your input address should use the official cityname.

City

The meaning of county varies by country.County

• IND (India)—District

The district name.

A place name, such as a building name or company name.FirmName

Aravali Vihar Police StationAlwar 301030

Spectrum Technology Platform 9.06

Input


The building number. You may get better parsing results for somecountries if you put the house number in this field instead ofAddressLine1. Not every country includes house number data.

HouseNumber

For the best results, use the HouseNumber input field for thesecountries when using multi-line input: India, Singapore, Malaysia,Thailand, and Turkey.

The house number specified in the HouseNumber field takesprecedence over any house number specified in theAddressLine1 field.

Note:

The last line of the address.LastLine

• Gunjur RoadBangalore South 560017

The meaning of locality varies by country:Locality

• IND (India)—Locality

The postal code in the appropriate format for the country.PostalCode

India has a six-digit postal code system.

The meaning of State/Province varies by country.StateProvince

• IND (India)—State

Address Input GuidelinesFollow these suggestions to ensure that your street input data is in the best format possible for optimalgeocoding.

Address Guidelines for IndiaFollow these guidelines to provide input that Geocode Address Global can successfully geocode. Foradditional information about the India postal system, see the India Post website:www.indiapost.gov.in.

• Required fields—Addresses must contain either a city or a postal code.• Thoroughfare types—Thoroughfare types and their common abbreviations are recognized and fullysupported on input and output.

• Common words and abbreviations in addresses—The geocoder recognizes common words thatare used in street names, directionals, building identifiers, and Points of Interest and can successfullygeocode addresses that use these common words. Common abbreviations are also recognized withinaddresses.

• Numbers, Numeric Equivalents, and Ordinals—Numbered streets are mapped to the namedequivalents. Ordinals are also recognized in input addresses.

• Point of Interest—The India geocoder can return S8 close match candidates based on a placenamecombined with any valid locational input (town, locality, or postcode). Points of interest can includerestaurants, hotels, police stations, banks, ATMs, hospitals, schools, stores, and other businessesand organizations. Input placenames can be geocoded correctly even if they include numbers, hyphens,various types of punctuation, abbreviations, or minor misspellings.

7Geocoding Guide for India

Chapter 1: Geocode Address Global

http://www.indiapost.gov.in

• Sub locality—The India geocoder can return SL sub locality candidates. This indicates a sub locality(block or sector) street level match. An SL result code also requires a match on other geographic inputfields (city, district, or state).

• Street level geocoding— Street geocoded India addresses can return candidates based onPlacename/Point of Interest (S8 result code), sub locality (SL result code), and street centroid (S4result code). Depending on your requirements, you may prefer to see some or all of these candidates.These returns are controlled by API s and by check boxes in the Management Console interface. SeeMatching Options on page 12 for coverage of the ReturnPOIWithStreet, ReturnSublocalityCandidates,ReturnStreetCandidates, and other India-specific preferences.

• Address Point data— TomTom data starting with 2012.09 vintage includes address point data.Address point candidates return an S8 result code.

To take advantage of the most recent enhancements to the IND geocoder (including sub localitycandidates and address point data) you must use India Enterprise Geocoding Module data

Note:

2013.Q2 or newer. The updated data vintages provide improved address matching, return sublocality and place name with Exact match mode candidates, and return extended precision codesalong with other additional fields. See India-Specific Output for details on the additional fieldsthat are unique to the India geocoder.

Single Line InputInstead of entering each address element in separate fields, you may enter the entire address in theAddressLine1 input field.

You can enter addresses in these single-line formats.

For all countries except Japan, you can enter addresses in one or more of these single-line formats.

Not all formats work may work for every country.Note:

StreetAddress;PostalCode;City

StreetAddress;City;PostalCode

StreetAddress;City

StreetAddress;City;StateProvince;PostalCode

StreetAddress;Locality

StreetAddress;County;City

PostalCode;StreetAddress

PostalCode;StreetAddress;City

City;PostalCode;StreetAddress

Where:

• StreetAddress can be house number and street name in either order (with street type immediatelybefore or after the street name).

• City is the city or town.• PostalCode is the complete postcode. For Brazil,

Other single-line formats may also be acceptable for many countries.

The matching accuracy for single line input is comparable to that of structured address input. Theperformance of single line input addresses may be slightly slower than that of structured address input.

For best results, use delimiters (comma, semicolon, or colon) between each component of the address.For example,

Gunjur Road,Marattahalli,560017


Input

If the input address is missing delimiters, spaces are recognized as separators and internal parsing rulesidentify address components. In the example above, the address would still successfully geocode evenif some or all of the delimiters were missing in the input.

Non-delimited or partially-delimited single line addresses may take longer to geocode and maynot produce the same results as delimited single line input. This is especially true for addresses

Note:

with multi-word street names or cities. To optimize single line geocoding, use delimiters betweenaddress components (particularly between street name and city).

Punctuation is ignored for geocoding purposes.

Guidelines for Single Line Input

• Punctuation is generally ignored, however you may improve results and performance by usingseparators (commas, semicolons, etc.) between different address elements.

• The country is not required. Each country geocoder assumes that the address is in its country.• Firm information (placename, building name, or government building) is returned if available.

Street Intersection InputIf you enter a street intersection as input, the geocoder will provide the coordinates of the intersection.

To enter an intersection, specify the two street names separated by a double ampersand (&&) inAddressLine1. For some countries, the word AND can also be used to delimit intersections. The &&delimiter can be used for all countries. For example:

AddressLine1: Arjunlal Road && Tilak RoadCity: Ahmadabad City

The double ampersand (&&) can always be used as an street intersection separator. For somecountries, you can use additional symbols or words to delimit street intersections.

Note:

All close match criteria are enforced for intersection geocoding, just as for any street level geocoding.

Options

Geocoding OptionsThe following table lists the options that control how a location's coordinates are determined.

Table 2: Default Geocoding Options

DescriptionOption Name

Specifies how precisely you want to geocode addresses. One of thefollowing:

Geocode level

The geocoder attempts to geocode addresses to astreet address, but some matches may end up at a

Streetaddress

less precise location such as a postal code centroid,intersection, or shape path.

If postal code data is available, the geocoder attemptsto geocode addresses to the most precise postal code

Postalcentroid




it finds. The advantage of postal code centroid matchingis the speed of the operation. The disadvantage ofpostal code matching is that the geocoder onlyexamines the PostalCode field. If you use streetaddress precision, the geocoder looks at both the streetname and the PostalCode field and attempts to returnstreet-level coordinates and optionally fall back to postalcode coordinates.

The geocoder attempts to geocode addresses to thegeographic centroid of a city or state. This option is notavailable for the United Kingdom (GBR).

Geographiccentroid

Specifies whether to perform address point interpolation. This optiononly works if you have a point database, installed. This option isavailable for selected countries only.

Address point interpolation

Address point interpolation uses point data to refine geocode results.By default, the geocoding process estimates the location of an addressbased on the street numbers at either end of street segment. Forexample, if a street segment runs from 100 Main St. to 200 Main St.,then a request for 150 Main St. will return a location in the middle ofthe segment. With interpolation, the geocoder finds the position of 180Main St. in the point data, and it is about two-thirds of the way downthe street. Using this information, the geocoder can estimate theposition of 150 Main St. based on 100 and 180 Main St. In this case,the geocoder estimates the location of the address slightly away fromthe center of the segment.

Specifies whether to attempt to determine a geographic region centroidwhen an address-level geocode cannot be determined. This option isnot available for the United Kingdom (GBR).

Geographic centroid

Specifies whether to attempt to determine a postal code centroid whenan address-level geocode cannot be determined.

Postal centroid

Indicates the offset distance from the street segments to use instreet-level geocoding. The distance is specified in the units you specifyin the Units field.

Offset from street

The default value varies by country. For most countries, the default is7 meters.

The offset distance is used in street-level geocoding to prevent thegeocode from being in the middle of a street. It compensates for thefact that street-level geocoding returns a latitude and longitude pointin the center of the street where the address is located. Since thebuilding represented by an address is not on the street itself, you donot want the geocode for an address to be a point on the street. Instead,you want the geocode to represent the location of the building whichsits next to the street. For example, an offset of 50 feet means that thegeocode will represent a point 50 feet back from the center of the street.The distance is calculated perpendicular to the portion of the streetsegment for the address. Offset is also used to prevent addressesacross the street from each other from being given the same point.The following diagram shows an offset point in relation to the originalpoint.


Options


Street coordinates are accurate to 1/10,000 of a degree andinterpolated points are accurate to the millionths of a degree.

Specifies the distance to offset the street end points in street-levelmatching. The distance is specified in the units you specify in theUnits

Offset from corner

field.This value is used to prevent addresses at street corners frombeing given the same geocode as the intersection.

Offset is not supported for the United Kingdom (GBR) or Japan(JPN).

Note:

The default value varies by country:

• 12 meters—Australia (AUS), Austria (AUT), Germany (DEU)• 7 meters—For other supported countries, the default offset is 7meters.

The following diagram compares the end points of a street to offsetend points.

Specifies the unit of measurement for the street offset and corner offsetoptions. One of the following:

Units


Note:

• Feet• Miles• Meters• Kilometers

The default is Meters.

A coordinate system is a reference system for the unique location ofa point in space. Cartesian (planar) and Geodetic (geographical)

Coordinate system

coordinates are examples of reference systems based on Euclidean




geometry. Spectrum™ Technology Platform supports systemsrecognized by the European Petroleum Survey Group (EPSG).

Each country supports different coordinate systems. Depending onthe country, you have one or more of the following options:

Also known as the WGS84 coordinatesystem.

EPSG:4326

Matching OptionsMatching options let you set match restrictions, fallback, and multiple match settings so that the matchingcan be as strict or relaxed as you need. The strictest matching conditions require an exact match onhouse number, street name, postal code and no fallback to postal code centroids. The geocoder looksfor an exact street address match within the postal code in the input address. Relaxing the conditionsbroadens the area in which it searches for a match. For example, by relaxing the postal code, thegeocoder searches for candidates outside the postal code but within the city of your input address.

Table 3: Default Matching Options


Specifies whether to return results when the address matches to multiplecandidates in the database. If this option is not selected, an address thatresults in multiple candidates will fail to geocode.

Keep multiple matches

If you select this option, specify the maximum number of candidates toreturn next to the check box. Specify -1 (minus one) to return all possiblecandidates.

Specifies whether to return address range information. If you enable thisoption, the output field Ranges will be included in the output.

Return ranges

A range is a series of addresses along a street segment. For example,5400-5499 Main St. is an address range representing addresses in the5400 block of Main St. A range may represent just odd or even addresseswithin a segment, or both odd and even addresses. A range may alsorepresent a single building with multiple units, such as an apartmentbuilding.

If you choose to return ranges, this option specifies the maximum numberof ranges to return for each candidate. Since the geocoder returns one

Maximum ranges percandidate

candidate per segment, and since a segment may contain multiple ranges,this option allows you to see the other ranges in a candidate's segment.

If you choose to return ranges, this option specifies the maximum numberof units (for example, apartments or suites) to return for each range.

Maximum units per range

For example, if you were to geocode an office building at 65 Main St.containing four suites, there would be a maximum of four units returnedfor the building's range (65 Suite 1, 65 Suite 2, 65 Suite 3, and 65 Suite4. If you were to specify a maximum number of units as 2, then only twounits would be returned instead of all four.

Specifies whether to return only those geocoded results that are closematch candidates. For example, if there are 10 candidates and two of

Close matches only


Options


them are close candidates, and you enable this option, only the two closematching candidates would be returned instead of all 10. To specify whatis considered a close match, use the Close match criteria options.Address candidates are ranked according to how closely the input addressmatches these preferences.

Specifies how to determine whether a candidate is a close match. Oneof the following:

Match mode

This option allows you to specify which parts of a candidateaddress must match the input address to be considered a

Custom

close match. Use the Close match criteria check boxes tospecify the address elements you want. This is the defaultvalue for most countries.

All of a candidate address's elements must match in orderfor the candidate to be considered a close match.

Exact

Note that for IND, Exact match mode returns the sub localityand place name information

Only the candidate address's street name and town mustmatch in order for the candidate to be considered a close

Close

match. For Chile, China, Great Britain, Estonia, India,Indonesia, Latvia, Lithuania, Slovakia, Slovenia, Taiwan,and South Africa, only the street name and townmust match.

All candidate addresses are considered a close match.Relaxed

Specifies whether candidates must match all non-blank input fields to beconsidered a close match. For example, if an input address contains a

All input

city and postal code, then candidates for this address must match thecity and postal code to be considered a close match.

Specifies whether candidates must match the house number to beconsidered a close match.

House number

If you select this option you should also require an exact match on streetname. This option does not significantly affect performance. It does,however, affect the type of match if the candidate address correspondsto a segment that does not contain any ranges. The type of match canalso be affected when the house number range for a candidate does notcontain the input house number. If you relax the house number, youshould set the maximum ranges to be returned to a value higher than 0.

Specifies whether candidates must match the street name to beconsidered a close match.

Street

If a close match is found, the geocoder attempts expanded street namemanipulation, which looks for candidates with names that sound like theinput address or that are spelled improperly. This slows down performancebut increases the match rate . If the geocoding database is indexed, theperformance impact is reduced.

Specifies whether candidates must match the locality (or equivalent) tobe considered a close match. The meaning of Locality varies for differentcountries.

Locality




If you do not require exact matches on locality, the geocoder searcheson the street address matched to the particular postal code, and considersother localities that do not match the name, but do match the postal code.


Specifies whether candidates must match the city to be considered aclose match. For Japan, this field specifies whether the candidate must

City

match the municipality subdivision (oaza). If you do not require exactmatches on city, the geocoder searches on the street address matchedto the particular postal code, and considers other cities that do not matchthe name, but do match the postal code.

Specifies whether candidates must match the county (or equivalent) tobe considered a close match. The meaning of county varies for differentcountries.

County


Specifies whether candidates must match the state or province (orequivalent) to be considered a close match.

State/Province


Specifies whether candidates must match the postal code to beconsidered a close match. If you do not require exact match on postal

Postal code

codes, the geocoder searches a wider area for a match. While this resultsin slower performance, the match rate is higher because the request doesnot need to match exactly when it compares match candidates.

This option applies only to Indian addresses.Return point of interestmatches with street matches Specifies whether to return both point of interest (POI) matches and street

matches when both street and POI information are provided in the input.If you select this option, a POI candidate is returned with candidates thatmatched on street name. A sub locality candidate returns an S8 resultcode. If you set this option to No, only street information is returned.

This option applies only to Indian addresses.Return sub localitycandidates Specifies whether to return a sub locality (block or sector) match. A sub

locality candidate returns an SL result code, and requires a match onother geographic input fields (city, district, or state). You can combinethis with the Return street candidates preference to get both SL and S4candidates.

This option applies only to Indian addresses.Return street candidates

Specifies whether to return a street match. A street candidate returns anS4 result code. You can combine this with the Return sub localitycandidates preference to get both S4 and SL candidates.

This option applies only to Indian addresses.Return locality candidates

Specifies whether to explicitly return a geographic locality (G4) match inpreference to a town (G3) candidate.

This option applies only to Indian addresses.Return town candidates


Options


Specifies whether to explicitly return a geographic town (G3) match inpreference to a locality (G4) candidate.

This option applies only to Indian addresses.Place Name

Specifies whether a candidate address must match the place name tobe considered a close match.

You may want to use a balanced strategy between match rate and geographic precision. That is, youmay want to geocode as many records as possible automatically, but at the same time want to minimizethe number of weaker matches (false positives). For example, false positives can occur when thegeocoder:

• finds a street that sounds like the input street.• finds the same street in another city (if postal code match is not required).• finds the street but with a different house number (if house number is not required).

The following settings may achieve a good balance between match rate and precision:

• Close matches only—Select this option.• Close match criteria—Select House number and Street only.• Postal centroid—Do not select this fallback level.

Data OptionsThe Data tab allows you to specify which databases to use in geocoding. Databases contain the addressand geocode data necessary to determine the geocode for a given address. There are two kinds ofdatabases: standard databases and custom databases. Standard databases are those supplied byPitney Bowes Software and based on address and geocoding data from postal authorities and suppliersof geographical data. Custom databases are databases you create to enhance or augment standarddatabases for your particular needs.

The following table lists the options available for specifying which databases to use and the search orderof databases.

Table 4: Default Data Options


Specifies the database to be used for geocoding. Only databases thathave been defined in the Databases Resources panel in theManagement Console are available.

Database

Specifies which geocoding databases to use. One of the following:Database preference

Use both standard databases and customdatabases, but give preference to candidates

Prefer customdatabase

from custom databases. Use this option if youfeel your custom database is superior to thestandard database.

Use both standard databases and customdatabases, but give preference to candidatesfrom standard databases.

Prefer standarddatabase




Use only custom databases. Ignore standarddatabases.

Use customdatabases only

Use only standard databases. Ignore customdatabases.

Use standarddatabases only

Use both standard databases and customdatabases. In cases where candidates are

Use both custom andstandard databases

returned from both, the standard database ispreferred. Default.

The results from a custom database have a "U" at the end of the resultcode. Results from an address database have an "A" at the end of thematch score. For example: S5HPNTSCZA is a match score that comesfrom an address database, while S5HPNTSCZU comes from a customdatabase. For more information, see Result Codes for InternationalGeocoding on page 31.

Specifies whether to use the database search list specified in theManagement Console under the database resources tools (Modules >

Override the default databasesearch list

Enterprise Geocoding > Tools). If you choose to override the defaultdatabase search list you may change the search order of the databasesin theDatabase search list field. Youmay also remove databases fromthe search list.

If you override the default database search list, changes to the databaseresources will not be reflected in the database search list, which maycause geocoding to fail. However, if you do not override the defaultdatabase search order, any changes to the database resources will beautomatically reflected by the geocoder. For example, if a databaseresource is moved from one directory to another and you update thedatabase resources accordingly (Modules > Enterprise Geocoding >Tools) the database location will be automatically updated in thegeocoder.

The name of one or more database resources to use in the searchprocess. Use the database name specified in theManagement Console'sDatabase Resources tool.

Database search list

You can specify multiple database resources. If you specify more thanone database, list them in order of preference.

The order of the databases has an effect when there are close matchcandidates from different databases. The closematches that are returnedcome from the database that is first in the search list. Close matchesfrom lower ranked databases are demoted to non-close matches.

You can also use the order of the databases to perform fallbackprocessing if you have an both an address point database and astreet-level database installed for the country. List the address pointdatabase first and the street database second. If the address cannotbe geocoded to the address point level, the geocoder will attempt togeocode it to the street level.

Related LinksGeocode Address Global on page 5


Options

Output Data OptionsThe following table lists the options that control which data is returned in the output.

Table 5: Output Data Options


This option applies to the U.K. only.Return only similar firm names

Specifies whether to return firm names only when the input firm nameis similar to the firm name in the geocoding database. For example, ifthe input firm name is "Pitney Bowes Business Insight" but the geocodingdatabase returns "Pitney Bowes Software, Inc.", these two firm namesare not similar. In most cases the input firm name must match the firmname in the database exactly. Some differences in abbreviations areconsidered similar enough to result in the firm name being returned.

OutputThe geocoder returns the latitude/longitude, standardized address, and result indicators. Result indicatorsdescribe how well the geocoder matched the input address to a known address and assigned a location;they also describe the overall status of a match attempt. If you are using the API, t of the Spectrum™

Technology Platform API Guide

Address OutputThe address may be identical to the input address if the input address was accurate, or it may be astandardized version of the input address, or it may be a candidate address when multiple matches arefound.

Table 6: Address Output


First line of the address.AddressLine1

Second line of the address.AddressLine2

The type of unit, such as apartment, suite, or lot.ApartmentLabel

Unit number.ApartmentNumber

The municipality name.City

The three-letter ISO 3166-1 Alpha 3 country code.Country



The district name.

Name of the company or a place name.FirmName




The building number for the matched location.HouseNumber

The highest house number of the range in which the address resides.HouseNumberHigh

The lowest house number of the range in which the address resides.HouseNumberLow

Indicates if the house number range contains even or odd numbers orboth.

HouseNumberParity

EvenE

OddO

BothB

UnknownU

For reverse geocoded candidates, the two-character language code isreturned.

Language

Complete last address line (city, state/province, and postal code).LastLine

Street directional that precedes the street name. For example, the N in138 N Main Street.

LeadingDirectional



Indicates the number of ranges of which the candidate is a member. Acandidate may be a part of multiple ranges if the candidate is a street

NumberOfCandidateRanges

instead of a building. To specify the number of ranges to return for eachcandidate, use the Maximum ranges per candidate option.

Indicates the number of units included in the range. A unit is an addresswithin a building, such as an apartment or office suite. To specify the

NumberOfRangeUnits

number of units to return for each range, use the Maximum units perrange option.

The postcode for the address. The format of the postcode varies bycountry. Postcode data is not available for every country.

PostalCode

The second part of a postcode. This field is not used by most countries.PostalCode.Addon

Miscellaneous information that appears before the street name.PreAddress

This field is not currently used.PrivateMailbox

This is a list field containing the address ranges that exist on the streetsegment where the candidate address is located.

Ranges

A range is a series of addresses along a street segment. For example,5400-5499 Main St. is an address range representing addresses in the5400 block of Main St. A range may represent just odd or even addresseswithin a segment, or both odd and even addresses. A range may alsorepresent a single building with multiple units, such as an apartmentbuilding.

The Ranges field contains the following sub-fields:

This is a list filed that contains sub-fields forany address elements (AddressLine1, City,

Address


Output


and so on) that are different from thecandidate's address.

A listing of country-specific informationrelated to the address. The information

AdditionalFields

contained in AdditionalFields varies bycountry.

The highest address number for the range.HouseNumberHigh

The lowest address number for the range.HouseNumberLow

Indicates the side of the street where therange is located. One of the following:

SegmentParity

It is not known which side of thestreet the range is located on.

0

The range is on the left side of thestreet.

1

The range is on the right side of thestreet.

2

Indicates whether the range contains oddor even address numbers. One of thefollowing:

HouseNumberParity

The range contains both odd andeven address numbers.

0

The range contains odd addressnumbers

1

The range contains even addressnumbers.

2

It is not known whether the rangecontains odd or even housenumbers.

-1

The number of unit ranges returned for theaddress. A unit is an address within abuilding, such as an apartment or suite.

TotalRangeUnitsReturned

A list of the ranges of units within thebuilding. An example of units areapartments or suites.

RangeUnits

This is a list filed thatcontains sub-fields for

Address

any address elements(AddressLine1, City,and so on) that aredifferent from thecandidate's address.

The highest unitnumber.

UnitNumberHigh

The lowest unit number.UnitNumberLow




A unique ID that identifies a street segment.SegmentCode

Indicates which side of the street has odd numbers.SegmentParity

Left side of the streetL

Right side of the streetR

Both sides of the streetB

UndeterminedU



The default search order rank of the database used to geocode theaddress. A value of "1" indicates that the database is first in the default

StreetDataType

search order, "2" indicates that the database is second in the defaultsearch order, and so on.

The default database search order is specified in theManagement Consolewith the Database Resources tool.

For most countries, this contains the street name.StreetName

The type of street when the street type appears before the base streetname.

StreetPrefix

The street type of the matched location. For example, AVE for Avenue.StreetSuffix

Street directional that follows the street name.TrailingDirectional

The highest unit number of the range in which the unit resides.UnitNumberHigh

The lowest unit number of the range in which the unit resides.UnitNumberLow

Geocode Output

Table 7: Geocode Output


The coordinate system used to determine the latitude and longitudecoordinates. A coordinate system specifies a map projection, coordinate

CoordinateSystem

units, etc. An example is EPSG:4326. EPSG stands for EuropeanPetroleum Survey Group.

Seven-digit number in degrees and calculated to four decimal places(in the format specified).

Latitude

Seven-digit number in degrees and calculated to four decimal places(in the format specified).

Longitude


Output

Result CodesResult codes contain information about the success or failure of the geocoding attempt, as well asinformation about the accuracy of the geocode.

Table 8: Result Code Output


Indicates how closely the input address matches the candidate address.For more information, see Result Codes for International Geocodingon page 31.

Geocoder.MatchCode

Indicates whether or not the address is considered a close match. Anaddress is considered close based on the "Close match criteria" optionson the Matching tab.

IsCloseMatch

Yes, the address is a close match.Y

No, the address is not a close match.N

For street address geocoding, the number of matching address positionsfound for the specified address.

MultiMatchCount

For intersection geocoding, the number of matching street intersectionpositions found for the specified addresses.

Reports the success or failure of the match attemptStatus

Successnull

FailureF

If the geocoder could not process the address, this field will show thereason.

Status.Code

• Internal System Error• No Geocode Found• Insufficient Input Data• Multiple Matches Found• Exception occurred• Unable to initialize Geocoder• No Match Found

If the geocoder could not process the address, this field will show adescription of the failure.

Status.Description

Returned when Status.Code = InternalSystem Error.

Problem + explanation

Returned when Status.code = NoGeocode Found.

Geocoding Failed

Returned when Status.code = NoGeocode Found.

No location returned

The geocoder could not identify anycandidate matches for the address.

No Candidates Returned

The address resulted in multiplecandidates. In order for the candidate

Multiple CandidatesReturned and Keep




Multiple Matches notselected

address to be returned, you must selectthe Keep multiple matches option.

A code describing the precision of the geocode. One of the following:LocationPrecision

No coordinate information is available for thiscandidate address.

0

Interpolated street address.1

Street segment midpoint.2

Postal code 1 centroid.3

Partial postal code 2 centroid.4

Postal code 2 centroid.5

Intersection.6

Point of interest.7

State/province centroid.8

County centroid.9

City centroid.10

Locality centroid.11

For IND, 12 indicates a sub locality (block orsector) match. This is more specific than othergeographic matches (city, district, or state).

12 - 15(LocationPrecisioncodes)

For most countries, LocationPrecision codes 12through 15 are reserved for unspecified customitems.

Sub locality (block or sector) match. This is morespecific than other geographic matches (city,district, or state).

12

Additional point precision for unspecified customitem.

13


14


15

The result is an Address Point.16

The result was generated by using address pointdata to modify the candidates segment data.

17


StreetDataType


The default database search order is specified in the ManagementConsole with the Database Resources tool.


Output

2Reverse Geocode AddressGlobal

Reverse Geocode Address Global determines the address for a givenlatitude/longitude point. Reverse Geocode Address Global can determineaddresses in many countries. The countries available to you depends on whichcountry databases you have installed. For example, if you have databases forCanada, Italy, and Australia installed, Reverse Geocode Address Global wouldbe able to geocode addresses in these countries in a single stage.

Reverse Geocode Address Global does not support U.S. addresses. Togeocode U.S. addresses, use Reverse Geocode US Location.

Note:

Before you can work with Reverse Geocode Address Global, you must define aglobal database resource containing a database for one or more countries. Onceyou create the database resource, a ReverseGeocode AddressGlobal will becomeavailable in the Management Console, Enterprise Designer, and Interactive Driver.

Reverse Geocode Address Global is an optional component of the EnterpriseGeocoding Module.

In this section:

• Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24• Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24• Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

InputReverse Geocode Address Global takes longitude and latitude as input.

Table 9: Reverse Geocode Global Input

DescriptionFormatField Name

The latitude of the point for which you want addressinformation.

StringLatitude

The longitude of the point for which you want addressinformation.

StringLongitude

One of the following:StringCountry

• The name of the country in English.• The two-character ISO 3116-1 alpha-2 country code.• The three-character ISO 3116-1 alpha-3 country code.

Options

Geocoding Options

Table 10: Default Geocoding Options


The radius from the input coordinates in which to search for an address.Street segments and points within the radius are considered. The default

Search distance

search radius is 150 meters and the maximum search radius is 1600meters.

The units in which the search distance is specified. One of the following:Units


Indicates the offset distance from the street segments to use instreet-level geocoding. The distance is specified in the units you specifyin the Units field.

Offset from street

The default value varies by country. For most countries, the default is7 meters.

The offset distance is used in street-level geocoding to prevent thegeocode from being in the middle of a street. It compensates for the


Input


fact that street-level geocoding returns a latitude and longitude point inthe center of the street where the address is located. Since the buildingrepresented by an address is not on the street itself, you do not wantthe geocode for an address to be a point on the street. Instead, youwant the geocode to represent the location of the building which sitsnext to the street. For example, an offset of 50 feet means that thegeocode will represent a point 50 feet back from the center of the street.The distance is calculated perpendicular to the portion of the streetsegment for the address. Offset is also used to prevent addresses acrossthe street from each other from being given the same point. The followingdiagram shows an offset point in relation to the original point.

Street coordinates are accurate to 1/10,000 of a degree and interpolatedpoints are accurate to the millionths of a degree.

Specifies the distance to offset the street end points in street-levelmatching. The distance is specified in the units you specify in the Units

Offset from corner

field.This value is used to prevent addresses at street corners frombeing given the same geocode as the intersection.


Note:

The default value varies by country:

• 12 meters—Australia (AUS), Austria (AUT), Germany (DEU)• 7 meters—For other supported countries, the default offset is 7 meters.

The following diagram compares the end points of a street to offset endpoints.

Specifies the unit of measurement for the street offset and corner offsetoptions. One of the following:

Units


Note:


Chapter 2: Reverse Geocode Address Global



The default is Meters.

A coordinate system is a reference system for the unique location of apoint in space. Cartesian (planar) and Geodetic (geographical)

Coordinate system

coordinates are examples of reference systems based on Euclideangeometry. Spectrum™ Technology Platform supports systems recognizedby the European Petroleum Survey Group (EPSG).

Each country supports different coordinate systems. Depending on thecountry, you have one or more of the following options:

Also known as theWGS84 coordinate system.EPSG:4326

Matching Options

Table 11: Default Matching Options


Specifies whether to return results when the coordinates match tomultiple candidate addresses in the database. If this option is not

Keep multiple matches

selected, coordinates that results in multiple address candidates will failto geocode.

If you select this option, specify the maximum number of candidates toreturn next to the check box.

Data OptionsThe Data tab allows you to specify which databases to use in reverse geocoding. Databases containthe address and geocode data necessary to determine the address for a given point. The following tablelists the options available for specifying the search order of databases.

Table 12: Default Data Options


Specifies whether to use the database search list specified in theManagement Console under the database resources tools (Modules >

Override the default databasesearch list

Enterprise Geocoding > Tools). If you choose to override the defaultdatabase search list you may change the search order of the databasesin theDatabase search list field. Youmay also remove databases fromthe search list.

If you override the default database search list, changes to the databaseresources will not be reflected in the database search list, which may


Options


cause geocoding to fail. However, if you do not override the defaultdatabase search order, any changes to the database resources will beautomatically reflected by the geocoder. For example, if a databaseresource is moved from one directory to another and you update thedatabase resources accordingly (Modules > Enterprise Geocoding >Tools) the database location will be automatically updated in thegeocoder.

The name of one or more database resources to use in the searchprocess. Use the database name specified in theManagement Console'sDatabase Resources tool.

Database search list

You can specify multiple database resources. If you specify more thanone database, list them in order of preference.

The order of the databases has an effect when there are close matchcandidates from different databases. The closematches that are returnedcome from the database that is first in the search list. Close matchesfrom lower ranked databases are demoted to non-close matches.

You can also use the order of the databases to perform fallbackprocessing if you have an both an address point database and astreet-level database installed for the country. List the address pointdatabase first and the street database second. If the address cannotbe geocoded to the address point level, the geocoder will attempt togeocode it to the street level.

OutputTable 13: Reverse Geocode Address Global Output Fields


First line of the address.AddressLine1

Second line of the address.AddressLine2

The type of unit, such as apartment, suite, or lot.ApartmentLabel

Unit number.ApartmentNumber

The municipality name.City



The district name.

The distance from input location in meters. If the input coordinates arean exact match for the address, the value is 0.

Distance

Name of the company or a place name.FirmName




Indicates how closely the input coordinatesmatch the candidate address.For more information, see Reverse Geocoding Codes (R Codes) onpage 34.

Geocoder.MatchCode

The building number for the matched location.HouseNumber

The highest house number of the range in which the address resides.HouseNumberHigh

The lowest house number of the range in which the address resides.HouseNumberLow

Indicates if the house number range contains even or odd numbers orboth.

HouseNumberParity

EvenE

OddO

BothB

UnknownU

For reverse geocoded candidates, the two-character language code isreturned.

Language

Complete last address line (city, state/province, and postal code).LastLine

Street directional that precedes the street name. For example, the N in138 N Main Street.

LeadingDirectional



Indicates the number of ranges of which the candidate is a member. Acandidate may be a part of multiple ranges if the candidate is a street

NumberOfCandidateRanges

instead of a building. To specify the number of ranges to return for eachcandidate, use the Maximum ranges per candidate option.

Indicates the number of units included in the range. A unit is an addresswithin a building, such as an apartment or office suite. To specify the

NumberOfRangeUnits

number of units to return for each range, use the Maximum units perrange option.

The postcode for the address. The format of the postcode varies bycountry. Postcode data is not available for every country.

PostalCode

The second part of a postcode. This field is not used by most countries.PostalCode.Addon

Miscellaneous information that appears before the street name.PreAddress

This field is not currently used.PrivateMailbox

A unique ID that identifies a street segment.SegmentCode

Indicates which side of the street has odd numbers.SegmentParity

Left side of the streetL

Right side of the streetR

Both sides of the streetB

UndeterminedU


Output





StreetDataType


The default database search order is specified in the ManagementConsole with the Database Resources tool.

For most countries, this contains the street name.StreetName

The type of street when the street type appears before the base streetname.

StreetPrefix

The street type of the matched location. For example, AVE for Avenue.StreetSuffix

Street directional that follows the street name.TrailingDirectional

The highest unit number of the range in which the unit resides.UnitNumberHigh

The lowest unit number of the range in which the unit resides.UnitNumberLow

The exact latitude / longitude coordinates of the candidate, which maybe different than the input coordinates.



3Result Codes forInternational Geocoding

Candidates returned by Spectrum geocoders return another class of return codesthat are referred to as International Geocoding Result Codes. Each attemptedmatch returns a result code in the Geocoder.MatchCode output field.

In this section:

• International Street Geocoding Result Codes (S Codes) .32• Interpreting S Result Codes . . . . . . . . . . . . . . . . . . . . . . . .32• International Postal Geocoding Result Codes (Z Codes) .34• International Geographic Geocoding Result Codes (G

Codes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34• Reverse Geocoding Codes (R Codes) . . . . . . . . . . . . . . .34• Non-match Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

International Street Geocoding Result Codes (SCodes)

Street level geocoded candidates return a result code beginning with the letter S. The second characterin the code indicates the positional accuracy of the resulting point for the geocoded record.

Table 14: Street (S ) Result Codes

DescriptionS Result Code

Single close match with the point located at postal code centroid.S1

Single close match with the point located at postal code centroid.S3

Single close match with the point located at the street centroid. The S4 code isfollowed by letters and dashes indicating match precision. see Interpreting SResult Codes on page 32

S4

Single close match with the point located at a street address position. The S5 codeis followed by letters and dashes indicating match precision. For information aboutthese letters, see Interpreting S Result Codes on page 32.

S5

Single close match with the point located at centroid of geometry postal code. (Forexample, large buildings having their own codes.)

S6

Single match with the point located at an interpolated point along the candidate'sstreet segment. When the potential candidate is not an address point candidate

S7

and there are no exact house number matches among other address pointcandidates, the S7 result is returned using address point interpolation. The pointis interpolated according to the next highest or lowest address point candidatethat both intersects the segment and whose house number is contained within therange of houses of the original candidate. By using known address referencepoints on the street segment, the S7 point can be adjusted to a more accurateposition.

Single close match with the point located at either the single point associated withan address point candidate or at an address point candidate that shares the samehouse number. No interpolation is required.

S8

Sub locality. The SL result code is used for India only. This indicates a sub locality(block or sector) street level match. An SL result code also requires a match onother geographic input fields (city, district, or state).

SL

Single close match with the point located at street intersection.SX

Interpreting S Result CodesFor S (street geocoded) international result codes, eight additional characters describe how closely theaddress matches an address in the database. The characters appear in the order listed in the followingtable. Any non-matched components are represented by a dash.

For example, the result code S5--N-SCZA represents a single close match that matched the street name,street suffix direction, town, and postcode. The dashes indicate that there was no match on housenumber, street prefix direction, or thoroughfare type. The match came from the Street Range Addressdatabase. This record would be geocoded at the street address position of the match candidate.


International Street Geocoding Result Codes (S Codes)

ExampleDescriptionCategory

18House numberH

NorthStreet prefix directionP

P is present if any of these conditions are satisfied:

• The candidate pre-directional matches the inputpre-directional.

• The candidate post-directional matches the inputpre-directional after pre- and post-directionalsare swapped.

• The input does not have a pre-directional.

MerivaleStreet nameN

StStreet typeT

WStreet suffix directionS

S in result code is present if any of these conditionsare satisfied:

• The candidate post-directional matches the inputpost-directional.

• The candidate pre-directional matches the inputpost-directional after pre- and post-directionalsare swapped.

• The input does not have a post-directional.

South BrisbaneCity nameC

4101Postal codeZ

Block-9 Sector-3Sublocality. The SL result code is used for for Indiaonly. This indicates a sublocality (block or sector)

L

match when a street match (S4) or point match(S8) was not possible. An SL result code alsorequires a match on other geographic input fields(city, district, or state).

In India, street name information is often notavailable, but a sublocality can be a very smallarea. Therefore an SL match can be more precisethan a street centroid S4 match.

ADatabase type used to obtain the match.A, G, or U

• A—Street Range Address database.• U—Customer (user-defined) database.


Chapter 3: Result Codes for International Geocoding

International Postal Geocoding Result Codes (ZCodes)

Matches in the Z category indicate that a match was made at the postcode level. A postcode match isreturned in either of these cases:

• You specified to match to postal code centroids. The resulting point is located at the postal codecentroid with the following possible accuracy levels.

• There is no street level close match and you specified to fall back to postal code centroid.

Table 15: Postal (Z) Result Codes

DescriptionZ Result Code

Postal Code centroid match.Z1

Full postal code centroid match. For Canada, this is an FSALDU centroid.Z3

Postal level geocoded candidates return a result code beginning with the letter Z. India can generate aZ1 result code. Country-specific geocoders can often generate more accurate postcode results (with Z2or Z3 result codes).

International Geographic Geocoding Result Codes(G Codes)

Geographic level geocoded candidates return a result code beginning with the letter G. The numbersfollowing the G in the result code provides more detailed information on the accuracy of the candidate.

Table 16: Geographic (G) Result Codes

DescriptionG Result Code

State or province centroid. match.G1

County (district or region) centroid match.G2

City or town (municipality) centroid match.G3

Locality (village, suburb, or neighborhood) centroid match.G4

Reverse Geocoding Codes (R Codes)Matches in the R category indicate that the record was matched by reverse geocoding. The second twocharacters of the R result code indicate the type of match found. R geocode results include an additionalletter to indicate the dictionary from which the match was made.

Example reverse geocoding codes:


International Postal Geocoding Result Codes (Z Codes)

Table 17: Reverse Geocoding (R) Result Codes

DescriptionReverse Geocoding Code

Point/parcel level precision for reverse geocoding. Candidate returnedfrom address dictionary.

RS8A

Interpolated street candidate for reverse geocoding. Candidate returnedfrom address dictionary.

RS5A

Street centroid candidate for reverse geocoding. Candidate returnedfrom address dictionary.

RS4A

Candidate returned from India address dictionary with a sublocality(block or sector) match. In India, street name information is often not

RSLA

available, but a sublocality can be a very small area. Therefore an RSLAmatch can be more precise than a street centroid RS4 match.

Non-match CodesThe following result codes indicate no match was made:

• N—No close match.• NX—No close match for street intersections.• ND—Spectrum™ Technology Platform could not find the geocoding database for the given postal codeor municipality/state/province.


Chapter 3: Result Codes for International Geocoding

Notices

© 2013 Pitney Bowes Software Inc. All rights reserved. MapInfo and Group 1 Software are trademarksof Pitney Bowes Software Inc. All other marks and trademarks are property of their respective holders.

USPS® Notices

Pitney Bowes Inc. holds a non-exclusive license to publish and sell ZIP + 4® databases on optical andmagnetic media. The following trademarks are owned by the United States Postal Service: CASS, CASSCertified, DPV, eLOT, FASTforward, First-Class Mail, Intelligent Mail, LACSLink, NCOALink, PAVE,PLANET Code, Postal Service, POSTNET, Post Office, RDI, SuiteLink , United States Postal Service,Standard Mail, United States Post Office, USPS, ZIP Code, and ZIP + 4. This list is not exhaustive ofthe trademarks belonging to the Postal Service.

Pitney Bowes Inc. is a non-exclusive licensee of USPS® for NCOALink® processing.

Prices for Pitney Bowes Software's products, options, and services are not established, controlled, orapproved by USPS® or United States Government. When utilizing RDI™ data to determine parcel-shippingcosts, the business decision on which parcel delivery company to use is not made by the USPS® orUnited States Government.

Data Provider and Related Notices

Data Products contained on this media and used within Pitney Bowes Software applications are protectedby various trademarks and by one or more of the following copyrights:

© Copyright United States Postal Service. All rights reserved.

© 2013 TomTom. All rights reserved. TomTom and the TomTom logo are registered trademarks ofTomTom N.V.

© Copyright NAVTEQ. All rights reserved

Data © 2013 NAVTEQ North America, LLC

Fuente: INEGI (Instituto Nacional de Estadística y Geografía)

Based upon electronic data © National Land Survey Sweden.

© Copyright United States Census Bureau

© Copyright Nova Marketing Group, Inc.

Portions of this program are © Copyright 1993-2007 by Nova Marketing Group Inc. All Rights Reserved

© Copyright Canada Post Corporation

This CD-ROM contains data from a compilation in which Canada Post Corporation is the copyright owner.

© 2007 Claritas, Inc.

The Geocode Address World data set contains data licensed from the GeoNames Project(www.geonames.org) provided under the Creative Commons Attribution License ("Attribution License")located at http://creativecommons.org/licenses/by/3.0/legalcode. Your use of the GeoNames data(described in the Spectrum™ Technology PlatformUser Manual) is governed by the terms of the AttributionLicense, and any conflict between your agreement with Pitney Bowes Software, Inc. and the AttributionLicense will be resolved in favor of the Attribution License solely as it relates to your use of the GeoNamesdata.

ICU Notices

Copyright © 1995-2011 International Business Machines Corporation and others.

All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software andassociated documentation files (the "Software"), to deal in the Software without restriction, includingwithout limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of theSoftware, and to permit persons to whom the Software is furnished to do so, provided that the above


http://www.geonames.org

http://creativecommons.org/licenses/by/3.0/legalcode

copyright notice(s) and this permission notice appear in all copies of the Software and that both theabove copyright notice(s) and this permission notice appear in supporting documentation.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THEWARRANTIES OF MERCHANTABILITY, FITNESSFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NOEVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLEFORANYCLAIM,ORANYSPECIAL INDIRECTORCONSEQUENTIALDAMAGES,ORANYDAMAGESWHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTIONOF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR INCONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not be used in advertising orotherwise to promote the sale, use or other dealings in this Software without prior written authorizationof the copyright holder.


Copyright

Date post:	27-Mar-2018
Category:	Documents
Upload:	dangmien
View:	222 times
Download:	3 times

Geocoding Guide for India - United...

Documents