IGEO is an XML based format for specifying geographic data. Note that this is a
beta version of the format that is subject to change in the next version. The
IGEO data is referred to from a Layer in an IDOC file that defines the layer page.
The following example shows a small file with two Markers (symbols):
<?
xml version=
"1.0" encoding=
"UTF-8"?>
<
geodata>
<Marker name="Restaurant Slussen" symbol="i:pinorange" x="18.071862" y="59.322227" text="A nice cosy restaurant.\ntel:+46555123"
/>
<Marker name="Bar Gamla stan" symbol="i:pinorange" x="18.070829" y="59.325035" text="redirect:1187768.idoc"
/>
</geodata>
All coordinates should be defined in the WGS84 Coordinate Reference System, i.e. as longitude and latitude decimal degrees.
geodata
This element is the root element of an IGEO file. It contains the other elements.
Child elements
| Child element | Cardinality | Description |
|---|
| Marker | 0..n | A predefined point object. |
MarkerBase
MarkerBase is just an abstract base class. It documents the attributes available in all Marker* classes. You can not create MarkerBase objects.
Attributes
| Attribute | Use | Description |
|---|
| name | optional |
Name of object. Will be presented as a title and in some cases as a label.
|
| category | optional |
A value between 0 and 31 that is used for categorisation of objects. Often used for choosing different visualization (like color) on different objects.
|
| type | optional | A value between -32768 and 32767 that can be used for classification of objects. |
| text | optional | Text that can be presented as a description of the object. There is some markup that can be used for formatting.
- "\n" - inserts a newline
- "tel:" - interprets the following number as a phone number. Spaces and parenthesis are ignored. A plus sign is allowed first.
- "redirect:" - loads an IDOC file instead from the URL that follows. Must be the only contents of the text attribute. The URL can be relative to the IGEO file.
|
Marker
A Marker is a point object which is symbolized with a bitmap image. It has a few predefined attributes that are used for visualization and selection. Note that it extends MarkerBase so it has all those attributes as well.
Attributes
| Attribute | Use | Description |
|---|
| symbol | optional | The URL to a PNG file used for symbolization. There are also some predefined symbols that can be used. All these start with "i:". Currently the available ones are: i:pinblue, i:pinred, i:pingreen, i:pinyellow, i:pinlime, i:pinpurple, i:pinorange.
|
| x | required | X-coordinate (longitude) of the coordinate of the object. Should be defined in WGS84 decimal degrees. |
| y | required | Y-coordinate (latitude) of the coordinate of the object. Should be defined in WGS84 decimal degrees. |
MarkerLine
A MarkerLine is a line object that consists of a number of breakpoints.
This is an example of a MarkerLine:
<MarkerLine name="My line" category="1" text="Idevio office\ntel:+46317790960" coordinates="11.969997 57.706638 11.95508 57.69163 11.94008 57.68163"
/>
Attributes
| Attribute | Use | Description |
|---|
| coordinates | required | The coordinates in a string. They should be specified alternating x and y all separated by space. Should be defined in WGS84 decimal degrees. |
MarkerPolygon
A MarkerPolygon is an area object that consists of a closed curve defined by breakpoints. The polygon is automatically closed if not the first and last point are the same. It is structurally identical to a MarkerLine but is interpreted as an area injstead of a line.
Attributes
| Attribute | Use | Description |
|---|
| coordinates | required | The coordinates in a string. They should be specified alternating x and y all separated by space. Should be defined in WGS84 decimal degrees. |