GCSTYLE

GCSTYLE

Used in: CONFIG   RESPONSE
Servers: Geocode
Parent elements: EXTENSION

<GCSTYLE	Attribute Description Table
name ="USAddressZ \| USAddress \| USSingleHouse \| USSingleHouseZ \| USSingleRange \| USSingleRangeZ \| Zip4 \| Zip4Range \| Zip5 \| SingleField" endoffset ="0 - 50" [3] sideoffset ="integer" [0] sideoffsetunits ="feet \| meters \| decimal_degrees" [feet] spellingsensitivity ="1 - 100" [80] > When parent element is EXTENSION in map configuration file: (m) <GCFIELD... /> When parent element is EXTENSION in SERVICEINFO response: (m) <GCINPUT... /> </GCSTYLE >
Bold: Attribute or child element is required. (m): Child element can be used multiple times.

Description:

endoffset

sideoffset

sideoffsetunits

Restrictions:

The attributes sideoffset, sideoffsetunits, and endoffset are valid only with line features. They are not valid with point or polygon features.
The attributes sideoffset, sideoffsetunits, endoffset, and spellingsensitivity are not available in ArcIMS Author.

Notes:

ArcIMS has 10 standard address styles:

GCSTYLE Address Style	Description
USAddressZ	U.S. streets with zone: This style considers street addresses with zone information such as postal ZIP Codes or city names. Street features are represented by two house number intervals, one for the left side of the street and the other for the right side of the street. The parity (odd/even) of each interval should agree. The beginning number of the intervals can either be lower or higher than the end number.
USAddress	U.S. streets: This style is used for address geocoding without zone information. Street features are represented by two house number intervals, one for the left side of the street and the other for the right side of the street.
USSingleRangeZ	U.S. single range with zone: This style considers street or parcel addresses with zone information such as postal ZIP Codes or city names. Features are represented by one house number interval. No parity (odd/even) of the house numbers is required.
USSingleRange	U.S. single range: This style is used for address geocoding without zone information. Features are represented by one house number interval. No parity (odd/even) of the house numbers is required.
USSingleHouseZ	U.S. single house with zone: This style considers parcel or point addresses with zone information such as postal ZIP Codes or city names. Features are represented by a single house number.
USSingleHouse	U.S. single house: This style is used for address geocoding without zone information. Features are represented by a single house number.
Zip4	ZIP+4: This style is used for geocoding ZIP+4 using two components (ZIP and ZIP4).
Zip4Range	ZIP+4 range: This style is used for geocoding ZIP+4 in a range using three components (ZIP, ZIP4Low, and ZIP4High).
Zip5	ZIP 5-digit: This style is used for geocoding five-digit ZIP Code addresses.
SingleField	Single field: This style is used for geocoding based on the value of a single field in the reference layer's attribute table. The style contains one component (Keyfield).

ArcIMS supports the implementation of custom address styles. For information on customizing an address style for use in another count?y or for special cases in the United States, see Using Custom Address Styles.
For more information on geocoding elements, see Summary of Geocoding Elements.

Attribute Descriptions for GCSTYLE:

Attribute	Usage	Back to Top
endoffset	Address styles that use reference data with line geometry, such as USAddress, can interpolate a position along reference features for a geocoded address. In order to prevent features that are located at the end of a reference feature from falling on top of other features (for example, a cross street), the address locator can apply a "squeeze factor", or end offset, to the location of a geocoded address. The end offset setting of an address locator is expressed as a percentage of the length of the reference feature, between 0 and 50 percent. An end offset setting of 0 percent will not offset features from the end of the reference feature. An end offset of 50 percent will locate all features at the middle of the reference feature. Any value greater than 50 is treated as 50 percent. Valid geocoding styles are USAddress, USAddressZ, USSingleRange, and USSingleRangeZ.
name	Geocoding style. See Notes section for a description of the different geocoding styles.
sideoffset	Allows you to specify a side offset for geocoded features. When you specify a side offset, the geocoded feature is placed at the specified distance from the street centerline on the correct side of the street. Valid geocoding styles are USAddress and USAddressZ.
sideoffsetunits	Reference data units for sideoffset.
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".

Examples for GCSTYLE:

Example 1: USAddressZ Style. Required elements are noted with .

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
       <ENVELOPE minx="-71.077092" miny="42.357962" maxx="-71.034511" maxy="42.385263" name="Initial_Extent" />
       <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
       <SHAPEWORKSPACE name="shp_ws-64" directory="<path to data>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="Streets" visible="true" id="4">
       <DATASET name="bosstreets" type="line" workspace="shp_ws-64" />
       <SIMPLERENDERER>
         <SIMPLELINESYMBOL type="solid" width="2" color="255,0,0" />
       </SIMPLERENDERER>
       <EXTENSION type="Geocode">
         <GCSTYLE name="USAddressZ">
 <GCFIELD id="FromLeft" name="L_F_ADD" />
 <GCFIELD id="FromRight" name="R_F_ADD" />
 <GCFIELD id="ToLeft" name="L_T_ADD" />
 <GCFIELD id="ToRight" name="R_T_ADD" />
            <GCFIELD id="PreDir" name="PREFIX" />
            <GCFIELD id="PreType" name="PRE_TYPE" />
 <GCFIELD id="StreetName" name="NAME" />
            <GCFIELD id="StreetType" name="TYPE" />
            <GCFIELD id="SufDir" name="SUFFIX" />
 <GCFIELD id="LeftZone" name="ZIPL" />
 <GCFIELD id="RightZone" name="ZIPR" />
         </GCSTYLE>
       </EXTENSION>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: USAddress Style.

Back to Top

Example 3: USSingleHouseZ Style.

Back to Top

Example 4: USSingleHouse Style.

Back to Top

Example 5: USSingleRangeZ Style.

Back to Top

Example 6: USSingleRange Style.

Back to Top

Example 7: Zip4 Style.	Back to Top
<EXTENSION type="Geocode"> <GCSTYLE name="Zip4"> <!--reqd--> <GCFIELD id="ZIP" name="ZIP" /> <!--reqd--> <GCFIELD id="ZIP4" name="ZIP4" /> </GCSTYLE> </EXTENSION>

Example 8: Zip4Range Style.	Back to Top
<EXTENSION type="Geocode"> <GCSTYLE name="Zip4Range"> <!--reqd--> <GCFIELD id="ZIP" name="ZIP" /> <!--reqd--> <GCFIELD id="Zip4Low" name="ZIPL" /> <?--reqd--> <GCFIELD id="Zip4High" name="ZIPH" /> </GCSTYLE> </EXTENSION>

Example 9: Zip5 Style.	Back to Top
<EXTENSION type="Geocode"> <GCSTYLE name="Zip5"> <!--reqd--> <GCFIELD id="ZIP" name="ZIPL" /> </GCSTYLE> </EXTENSION>

Example 10: SingleField Style.	Back to Top
<EXTENSION type="Geocode"> <GCSTYLE name="SingleField"> <!--reqd--> <GCFIELD id="KeyField" name="NAME" /> </GCSTYLE> </EXTENSION>

Example 11: When in a SERVICEINFO response.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <CAPABILITIES forbidden="" disabledtypes="" />
        <SCREEN dpi="96" />
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <FEATURECOORDSYS id="4326"/>
        <FILTERCOORDSYS id="4326"/>
        <ENVELOPE minx="-71.077172" miny="42.355504" maxx="-71.034431" maxy="42.387721" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Streets" id="0">
        <FCLASS ty?e="line"></FCLASS>
        <EXTENSION type="Geocode" >
          <GCSTYLE name="USAddressZ" />
        </EXTENSION>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Example 12: When in a SERVICEINFO response that was routed to the Geocode Server.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <CAPABILITIES forbidden="" disabledtypes=""/>
      </ENVIRONMENT>
      <LAYERINFO name="Streets" id="4" >
        <EXTENSION type="geocode">
          <GCSTYLE name="USAddressZ" >
            <GCINPUT id="STREET" type="text" label="Street" width="10" description="street number, street name and type" />
            <GCINPUT id="ZONE" type="text" label="Zone" width="5" description="zone information" />
            <GCINPUT id="CROSSSTREET" type="text" label="Cross street" width="10" description="cross street name and type" />
          </GCSTYLE>
        </EXTENSION>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>