|
|
|---|---|
|
To embed a map in your web page using this interface, you must use an IFRAME, as the
REST interface creates a complete web page. The base URL is http://www.kansasmaps.org/services/rest/map.cfm. In addition, you can add the following query string parameters and values to customize the layout of the map. |
|
| Parameter | Description |
| extenttype | The type of extent to zoom to. Valid values: county, city, zip, coord, srt. Optional. Must be used together with extentvalue. "srt" refers to section-range-township values. "coord" refers to latitude and longitude value pairs. |
| extentvalue | The value to pass to the extent query. Optional. Must be used together with extenttype. City values: If you are searching for a city whose name contains a space, you must URL encode that space as %20. For example, a search for "Arkansas City" would need to be passed as "Arkansas%20City". Section-township-range (srt) values: should take the form 'S26-T12S-R20E'. Coordinate values: should be decimal and take the form 'latitude,longitude' (comma-separated, without spaces). For example, extentvalue=38.962992,-95.246422. |
| layers | The layers to include, a comma-delimited list of integers referring to layers defined in a look-up table (see below).
The maximum number of layers a user can request is 10.
Optional. If no layer is included, the default map displayed is the 2006 NAIP color aerial imagery of the state of Kansas. View the list of available map cache layers. |
| opacities | The opacity of the displayed layers: a comma-delimited list of integers between 0 and 10 corresponding to the sequence of layers in the
layers attribute. 1 is least opaque (most transparent) and 10 is most opaque. 0 sets the display to "false", so the layer is loaded but not visible, and must be turned on by checking the box in the "Display" menu. Optional. |
| w | Map width in pixels. Optional. Maximum width is 2000 pixels. The default is 780. |
| h | Map height in pixels. Optional. Maximum height is 2000 pixels. The default is 400. |
| startlevel | The initial zoom level for the map. Optional. The default is defined by the maps requested (if any). Valid values vary by map, but at most include 0 (full extent) to 11 (maximum zoom). Valid values for the 2006 NAIP base layer are 0 through 10. |
| switcher | Turn the "Display" menu on and off. Optional. The default is "on", while passing the value "off" will remove the menu. |
| help | Display this content below the map. This is a stand-alone parameter and needs no value. Optional. |
REST (an acronym for Representational State Transfer) refers to an application architecture that includes Web applications that can be manipulated simply by sending values to the web address (URL) as name-value pairs. For example, such a Web application can be accessed by sending requests in the form http://application_url.com/app?name_1=value_1&name_2=value_2 etc.
