GCSTYLE

Used in

Servers

Geocode

Parent elements

Syntax

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

Description

Identifies the geocoding style used for a layer.

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 several 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).
USAddressCityStateZip	U.S. streets with city and state or zone: This style considers street addresses by included either city and state or zone information. This format provides a format used frequently on Web sites where users often do not know the ZIP code but do know the city and state.
USCityState	U.S. Cities with State: This style allows you to find a specific city in the country. Tables of addresses that can be geocoded using this style must contain fields that have city name and state-specific information.
WorldCityCountry	World Cities with Country: This style allows you to locate cities within a specified country. Tables of addresses that can be geocoded using this style must also contain a city name and country name fields.

ArcIMS supports the implementation of custom address styles. For information on customizing an address style for use in another country 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
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 .

<?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" />
      <FILTERCOORDSYS id="4326" />
      <FEATURECOORDSYS id="4326"/>
      </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.

Example 3: USSingleHouseZ Style.

Example 4: USSingleHouse Style.

Example 5: USSingleRangeZ Style.

Example 6: USSingleRange Style.

Example 7: Zip4 Style.

Example 8: Zip4Range Style.

Example 9: Zip5 Style.

Example 10: SingleField Style.

Example 11: USAddressCityStateZip Style.

Example 12: USCityState Style.

Example 13: WorldCityCountry Style.

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

<?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" sideoffset="20" sideoffsetunits="feet" >
            <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>

Example 15: When in a SERVICEINFO response.

<?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 type="line"></FCLASS>
        <EXTENSION type="Geocode" >
          <GCSTYLE name="USAddressZ" />
        </EXTENSION>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>