Das FalkPolylineOverlay ermöglicht das einzeichnen von Polylinien in die Karte. Dazu wird eine Liste von Geocodes als Linienzug interpretiert. (siehe Verwendung)
Das Overlay kann auf zwei verschiedene Arten initialisiert werden.
Es muss eine Array von Paaren aus geografischen Breiten- und Längenangaben angegeben.
var polyline = [ [Lat, Lng], ..., [Lat, Lng] ];
Eine codierte Polyline wird am einfachsten über ein JavaScript Objekt Literal angegeben.
var polyline = {
points:"encoded polyline",
levels:"encoded level string",
numLevels:4,
zoomFactor:16 // for future purposes
};
Die codierte Polylinie bietet den Vorteil, eine bessere Performance im Browser für Polylinien zu erreichen. Es wird für jeden Punkt einer codierten Polylinie eine Stufe (level) angegeben, die festlegt, ob der Punkt in einer Zoomstufe angezeigt werden soll. Meist wird in kleineren Zoomstufen eine geringere Genauigkeit verlangt, da Einzelheiten des Linienzuges erst bei größen Zoonstufen von Belang sind. Weniger Geocodes in einer Zoomstufe führen damit zu einer besseren Performance beim Einzeichnen der Polylinie.
Der Algorithmus für das Format kodierter Polylinien ist als Teil der Google Maps API dokumentiert. Außerdem bietet Google ein interaktives Tool zu erstellen von kodierten Polylinien an, dieses Format wird von der Falk Map API ebenfalls verwendet.