GET_GEOCODE

GET_GEOCODE

Used in: REQUEST
Servers: Geocode
Parent elements: REQUEST

<GET_GEOCODE	Attribute Description Table
maxcandidates ="integer" [20] minscore ="0 – 100" [60] spellingsensitivity ="1 .. 100" [80] > <ADDRESS... /> <LAYER... /> <FEATURECOORDSYS... /> </GET_GEOCODE >
Bold: Attribute or child element is required.

Sends a request containing address information to the Geocode Server.

See GEOCODE for response.
Geocode requests must be routed to the Geocode Server. This routing information is contained in the URL sent to the ArcIMS site such as in the following example (all one line):
http://myComputer.domain.com/servlet/com.esri.esrimap.Esrimap?ClientVersion=9.0
        &ServiceName=myservice
        &CustomService=Geocode
        &Form=True&Encode=True
Up to maxcandidates candidates with score greater than minscore is returned.
FEATURECOORDSYS should be included only when the coordinate system of the ArcIMS service is different than the coordinate system in the client.
For more information on geocoding elements, see Summary of Geocoding Elements.

Attribute	Usage	Back to Top
maxcandidates	Maximum number of returned candidates.
minscore	Minimum score of returned candidates. If not included, all candidates with scores above 60 are returned. A candidate with a score of 100 means a perfect match, and 0 means no match.
spellingsensitivity	Controls how much variation the geocoding service allows when it searches for likely candidates in the reference data. A low value for spelling sensitivity allows "Mane", "Maine", and "Man" to be treated as match candidates for "Main". A higher value restricts candidates to exact matches. If you are sure that your addresses are spelled correctly, you can set a higher spelling sensitivity. However, if you think that your addresses may contain spelling errors, then you should use a lower setting. Processing takes longer with a lower setting since scores for more candidates must be computed. A value of "0" is equivalent to the default, which is "80". In a request, the spelling sensitivity value cannot be lower than any value set in GCSTYLE in a map configuration file. If no value is set, a value of "80" is assumed. If the requested value is lower than the service value, the requested value is set to the service value.

Example 1:	Back to Top
<?xml version="1.0" encoding="UTF-8"?> <ARCXML version="1.1"> <REQUEST> <GET_GEOCODE maxcandidates="25" minscore="60"> <LAYER id="streets" /> <ADDRESS> <GCTAG id="STREET" value="380 New York St" /> <GCTAG id="Zone" value="92373" /> <GCTAG id="CrossStreet" value="" /> </ADDRESS> </GET_GEOCODE> </REQUEST> </ARCXML>