<geolayer>

Syntax

<dynamic>
  <widget class_="graphics"> 
    [1010data_QUERY] 
    <layer name="[LAYER_NAME_1]">
      [1010data_QUERY_1] 
    </layer>
    <layer name="[LAYER_NAME_2]">
      [1010data_QUERY_2] 
    </layer>
    ...
    <graphspec> 
      <geograph type="geolayers" ...>
        <geolayer layername="[LAYER_NAME]" ...>
         type="states|counties|zipcodes|countries|locations"
         states="all|continental|[LIST_OF_STATES]"
         countries="all|europe|africa|asia|
                    southamerica|northamerica|oceania|
                    [LIST_OF_COUNTRIES]"
         datalabel="none|auto|value|name|fullname"
         x="" y="" value="" 
         name="" namevalue=""
         shape="" size=""

          ...
        </geolayer>
        <geolayer layername="[LAYER_NAME]" ...>
          ...
        </geolayer>
          ...
      </geograph> 
    </graphspec> 
  </widget> 
</dynamic> 

Attributes

type

Specifies the type of polygon region.

Valid values are:

states

U.S. state polygons. The states to include in the geograph are specified using the states attribute.

counties

U.S. county polygons. The states to include in the geograph are specified using the states attribute.

zipcodes

U.S. ZIP code polygons. The states to include in the geograph are specified using the states attribute.

The first time this plot is generated, it will take longer than expected since all the ZIP code polygons (~35K) need to be loaded into the system. Subsequent runs will be faster.

Note that all the ZIP code polygons do not completely cover the all U.S. region (e.g., lakes, mountains, etc.)

countries

Polygons representing countries. The countries to include in the geograph are specified using the countries attribute.

Note: You must set projection="mercator" when type="countries".

locations

A point defined by latitude and longitude coordinates on which a shape can be drawn.

When type="locations", the x attribute specifies a column name containing the longitude values, and the y attribute specifies a column name containing the latitude values.

For more information on defining shapes, see shape.

states

Determines which states are included in the layer. Valid state name or FIPS codes are expected.

This is used when type is set to states, counties, or zipcodes.

Valid values are:

all

All states, including Alaska and Hawaii, are included.

continental

Only states within the continental United States are included.

[LIST_OF_STATES]

Only the states specified in a a comma-separated list are included. States may be specified using the full name, two-letter abbreviation, or FIPS code.

Multi-word state names may be written with spaces between the words, or the spaces may be omitted. The values in this list are not case sensitive. Examples of valid entries: Illinois, texas, CA, fl, 18.

For a complete list of state names, abbreviations, and FIPS codes, see State names, abbreviations, and FIPS codes.

The default is all.

countries

Determines which countries are included in the layer. Valid country names or FIPS codes are expected.

This is used when type is set to countries.

Valid values are:

all

All countries are included.

europe

Only the countries of Europe are included.

africa

Only the countries in Africa are included.

asia

Only the countries in Asia are included.

southamerica

Only the countries in South America are included.

northamerica

Only the countries in North America are included.

oceania

Only the countries in Oceania are included.

[LIST_OF_COUNTRIES]

Only the countries specified in a a comma-separated list are included. Countries may be specified using the full name or FIPS code.

Multi-word country names may be written with spaces between the words, or the spaces may be omitted. The values in this list are not case sensitive.

For a complete list of country names and their FIPS codes, see Country names and FIPS codes.

The default is all.

x

Specifies the column name containing the names of the polygons associated with the type attribute.

When type="locations", this attribute specifies a column name containing the longitude values.

y

Specifies the column name for the values to be plotted in association with the polygons defined by the x attribute.

When type="locations", this attribute specifies a column name containing the latitude values.

datalabel

Specifies what type of data values are used for the labels of the polygons or points associated with the <geolayer>.

Valid values are:

none

No labels are displayed.

auto

The short name associated with the polygon is used for the labels. For more information, see name below.

value

The value from the column specified by the y attribute is used as the label.

name

The short name associated with the polygon is used for the labels, depending on the type.

For instance, if the type attribute for the <geolayer> is set to states, the polygons will be labeled with the two-letter abbreviation of the state. If the type attribute for this <geolayer> is set to counties, the polygons will be labeled with the name of the county.

You can override this by specifying the name of a column that contains the name you want to use for the particular polygon to the name attribute.

fullname

The full name associated with the polygon is used for the labels, depending on the type.

For instance, if the type attribute for the <geolayer> is set to states, the polygons will be labeled with the full state name. If the type attribute for this <geolayer> is set to counties, the polygons will be labeled with the name of the county along with the two-letter abbreviation of the state it is in.

The default is none.

name

When datalabel="name", this attribute specifies the name of the column from the data set to use for the label of the polygon.

value

When datalabel="value", this attribute specifies the name of the column from the data set to use for the label of the polygon.

namevalue

Specifies the name of a column that contains numeric values to map in association with the colormap for the label of the polygon.

shape

When type="locations", this references the name of a column in the data set that specifies the marker shape to draw at a particular set of coordinates. The longitude coordinate is specified in the column referenced by the x attribute, and the latitude coordinate is specified in the column referenced by the y attribute.

size

When type="locations", this specifies the name of a column in the data set that specifies the size of the shape to use.

layername

Specifies the name of a <layer> element that provides a 1010data query which provides the data. If this attribute is not specified, the <geolayer> element uses the 1010data query specified within the <widget class_="graphics"> element.