c-squares active map tester |
|
This form is provided for testing and demonstration purposes. It is designed to show what parameters the current implementation of the CMR c-squares mapper at "cs_map.pl" accepts and example mapper output, in order to assist you to produce application-level calls to the mapper to suit your own purposes.
|
form action | "https://www.obis.org.au/cgi-bin/cs_map.pl" method="post"
|
|
(Note, method="get" should not be used unless all spaces in any supplied strings are represented as "%20" and all ampersands as "%26"; there is also a character limit using "method=get" which does not apply to "post".)
|
Required:At least an initial c-square string (one or more c-square codes with "|" separators) is essential! |
csq:
color: |
NOTE: Red is the default colour and is not a required parameter |
Users can assign any of these seven colours by name:
red blue yellow black brown white green pink purple orange
Or, enter any valid hexadecimal colour code e.g. FF00FF (will give a purple square), FF9900 (will give an orange square).
** Click here to pop up a GIF image showing hexadecimal codes for the 216 web friendly colours. **
NOTE: in general, the maps are designed so that darker colours will display better than light ones.
|
Optional:Up to nine additional c-square strings can be supplied (all can be individually coloured).These additional c-squares strings need not be at the same resolution as the first, or as each other, however the resolution within any individual string should be constant. The default colour values for each string are as shown on the form when initially displayed (i.e., these colours need not be specified explicitly), however you can overwrite them with other colours of your choice if desired (see above). |
csq2:
color2: |
|
csq3:
color3: |
|
csq4:
color4: |
|
csq5:
color5: |
|
csq6:
color6: |
|
csq7:
color7: |
|
Identifying elements |
title: |
|
legend: |
|
Not Required |
map: |
|
NOTE: "best fit" is the default and is not a required parameter.
This list of available maps is subject to change, "best fit" is suggested to be used in most cases - i.e., do not specify a value for "map" (user can then select any other map from a scrollable list once the initial map is returned). |
To turn the map from a static to an active (clickable) map, a destination URL can be supplied as the parameter "redirect": |
redirect: |
|
This particular "redirect" URL is active, but is supplied for demonstration purposes only. It has been constructed to accept the following parameters:
param1
param2
param3
N_lat
S_lat
W_long
E_long
where:
- param1-param3 are dummy parameters representing those which a user's application may need as constraints on a database search, in addition to a "bounding box" (there can be any number of these)
- N_lat and S_lat are the northernmost and southernmost coordinates, and W_long and E_long are the easternmost and westernmost coordinates for the desired search area, all in expressed in decimal degrees (positive = northern hemisphere and east of the Greenwich meridian). (These four parameters are added by the perl script when the user clicks on an "active map", see below).
To implement active maps for your application, you will need to construct an equivalent, web-accessible procedure (which will perform a database query, not just display the parameters sent) on your own server to make use of this facility for your own data; clicking on an "active map" will then produce a query to your own database of the format:
"redirect"&W_long=[ ]&N_lat=[ ]&E_long=[ ]&S_lat=[ ]
similar to this real-world example. Values inside the square brackets will be added by the mapper in decimal degrees, according to the size of the c-squares in the first string sent, and where on the map the user has clicked. |
Happy with the entered values? Then click
- and remember to try clicking on the map if you have included a "redirect" value.
|
|
Please notify any problems with this page by e-mail. For notification of future developments regarding c-squares and the c-squares mapper, you may wish to subscribe to the c-squares-discuss email discussion group. |
|
This page last updated: 7 April 2003 |
