Page 1 of 6
When you first meet the Placemark it appears to be just a way of putting an icon on a map - but it is much more general. A Placemark can put almost any graphic onto a map not just an icon.
Let's take a closer look at how it works.
You can try all of these examples out and experiment with them using the Interactive KML Editor.
The Placemark can be thought of as a general-purpose container for text, positions, geometry and for their associated styles and behaviors. However, when you first meet it - well, it just looks like a place marker:
That is, with the Placemark tags are a Point and its coordinates - 2D or 3D. If you try this out in the Interactive KML editor then, after navigating to the correct spot, you will see a default icon on the map in the specified position.
This is just the start, however, because the Placemark is a versatile container. The Point is just one of the many geometric objects that can be placed inside it.
When you do use a Point tag then you automatically get an icon positioned at the specified location but if you use other objects then you don't get an icon. If you include other elements such as a name tag within the Placemark then it will be applied to the Point.
So what other geometry can we use in a Placemark?
- The whole purpose, you could say point, of a Point is to place an icon at a location.
There are four commonly encountered Geometry objects. The Point that we have already met, the LineString, the LinearRing and the Polygon. Let's look at each of the new types of Geometry in turn.
The Line String
This is simply a set of lines connected to one another to form a continuous "string" of lines. For example:
This draws a default line from 0.0,0.0,0.0 to 1.0,15.0,0.0 which is a very big line. (You can drop the third co-ordinate if you are working with a 2D map.)
If you carry on adding co-ordinates then more lines are drawn, one more line for every extra point. For example:
This draws a line from 0.0,0.0,0.0 to 1.0,15.0,0.0, then from 1.0,15.0,0.0 to 5.0,15.0,0.0 and finally from 5.0,15.0,0.0 to 5.0,0.0,0.0.
You can continue on in this way creating as many lines as you need.