Settings

When working with gotmap you may want to change the default settings of the map, this is done by editing the GotMapEngine.Options.
The GotMapEngine.Options are copied to every instance of the map when it is created, so all changes to the GotMapEngine.Options will take effect in all map instances cerated after the changes are done.

My sugestion is to make a .js-file called someting like gotmapsettings.js and include it in the html-pages where you will be using the map, this file should contain all the changes you whant on the default settings, and looks somethin like the code bellow.
(see the AIP to get a complete list of the available settings)

Icons

marker-default.png

marker-blue.png

marker-grey.png

marker-black.png

marker-red.png

marker-darkred.png

marker-lightgreen.png

marker-green.png

marker-orange.png

marker-darkorange.png

marker-yellow.png

marker-purple.png

marker-shadow.png

Custom GeoJSON properties

The map mainly uses GeoJSON to draw features.
To enable a wider array of functionality, gotmap has implemented some custom GeoJSON-properties.

Markers

Styling

Common

OGC Servers

var server = GotMapEngine.OGCServerManager.CreateServer(
    'url.to.server'
    , GotMapEngine.Enums.OGCServerTypes.WMS //use ...OGCServerTypes.WFS for wfs servers
    , {
        version: '1.1.1'
        , useProxy: false
        , altUrl: 'alternateurl.to.server' //an alternate serverurl to a server housing the same layers (fallback server)
    }
);    

var server = undefined;
var url = 'url.to.server';
var useProxy = false;

//use ...OGCServerTypes.WFS for wfs servers
if (GotMapEngine.OGCServerManager.ServerExists(url, GotMapEngine.Enums.OGCServerTypes.WMS)) {
    server = GotMapEngine.OGCServerManager.GetServer(url, GotMapEngine.Enums.OGCServerTypes.WMS);
}
else {
    //create a temporary server
    server = new GotMapEngine.Classes.OGCServer(url, GotMapEngine.Enums.OGCServerTypes.WMS, { isCorsEnabled: useProxy != undefined ? !useProxy : true });
}

RelayProxy

A local url which purpose is to relay http requests to external servers and results back to the client.

GotMap expects a http-relay to be implemented as an url that recives the desired url as a get parameter.
ex: http://excample.com/relay?url=http://the_desired_url.com&firstgetparam=param&second.....

The Options RelayProxyUrl="http://excample.com/relay" and RelayProxyParameterName="url" needs to be set eighter in the GotMap instanse or in GotMapEngine.Options for this to work.

Using a http-relay problems such as cross-domain ajax and accessing servers on the same network as the webserver can be avoided.

Note: When opening up for requests like this there is great need for safeguards prohibiting requests to protected internal servers!

ViewPortCulling

Verktyg

Zoom-verktyget

Zoomverktyget används för att zooma in och ut i kartan. Ett klick på plustecknet (+) zoomar in, ett klick på minustecknet(-) zoomar ut. Du kan också använda scroll-hjulet(rullhjulet) på musen eller "pinch" om du använder touch-skärm för att zooma in och ut. Alternativt kan du dubbelklicka i kartan för att zooma in.

Laddningsindikator

Laddningsindikatorn används för att visa att ett bild(tile/wms)-lager laddas. Indikatorn visas då ett lager börjar ladda nya bilder och döljs när lagret laddat klart. Första gången kartan visas och varje gång kartan zoomas eller flyttas behöver de synliga bild-lagern ladda nya bilder. Även yttre påverkarn kan initiera laddning av nya lagerbilder.

Kontextmeny

Kontextmenyn(högerklicksmenyn) består av två olika menyer, en för kartan och en för utritade objekt i kartan. Menyn är indelad i tre delar, en som visar koordinaten den öppnades på, en med gemensama menyalternativ samt en som är specifik för om menyn öppnades i katan eller på ett utritat objekt.

Både den gemensamma och de specifika delarna av menyn kan anpassas med önskad funktionalitet beroende på applikationens behov.

Fullskärms-verktyget

Med hjälp av detta verktyg kan en användare välja att visa kartan i fullskärmsläge, kartfönstert expanders då till att täcka hela skärmen. Klick på knappen aktiverar fullskärmsläget.

I fullskärmsläget ändras knappen. Klick på knappen lämnar fullskärmsläget.

Meny/sidopanel-verktyget

Denna knapp används för att visa meny/sidopanelen. Detta verktyget ger plats för navigering av applikationen samtidigt som kartan får största möjliga utrymme, här finns även utrymme för att visa annan information.

Sök-verktyget

Denna knapp används för att söka i kartan (ex. adresser, kartobjekt m.m). Ett klick på knappen expanderar sökfältet.

Vid ett klick på knappen så expanderas sökfältet, skriv din sökfras i fältet. Etiketten/placeholdern indikerar vilken söktyp.

Sökfältet ger dig förslag när du börjar skriva i det. För att välja den föreslagna adressen, navigera med piltangenterna och välj med enter eller använd musen.

Verktyget har stöd för flera sökmotorer(sökningstyper). När fler än en sökmotor är definierad så visas knappen med tre st prickar(se bilden ovan). Vid ett klick på knappen så expanderas sökmotorvals-menyn och man får då valet att välja sökmotor (se bild till höger).

Hitta mig / följ mig-verktyget

Denna knapp används för att visa din position i kartan. Vid ett klick panorerar kartan samt zoomar in till din position.
Denna funktionalitet ger bäst resultat när du använder en surf-platta eller smartphone. Positioneringen är dock inte lika precis som en "riktig" GPS men visar din ungefärliga position inom en radie på ett par meter.

Din position markeras i kartan med hjälp av denna symbolen (den yttre ringen expanderar och försvinner). Även markören försvinner efter en liten stund.
Klickar du på "Hitta mig"-knappen medans markören är synlig så aktiveras "Följ mig". När "Följ mig" är aktiverat försvinner inte markören utan den följer din förflyttning.

"Hitta mig"-knappen ändras till detta utseende då "Följ mig" är aktiverat. Ett klick på denna knapp avaktiverar funktionen.

Informations-verktyget

Denna knapp används för att få tillhörande information om kartobjekt i de lager du valt att aktivera i lager-verktyget. Ett klick på denna knappen aktiverar funktionaliteten, när verktyget är aktivet kan du klicka i kartan för att se information tillhörande kartobjektet.

Knappen får detta utseende när funktionaliteten är aktiv, Ett klick på knappen då den har detta utseende avaktiverar funktionaliteten.
Här till höger kan du se ett exempel på hur informationen kan se ut.

För tydligare presentation och möjlighet till stilsättning av informationen tillhandahåller även detta verktyg möjlighet att sätta presentationsmallar. Varje lager i applikationen har en egen presentationsmall, mallar utformas med hjälp av html för layout och css för stilsättning.

Mät-verktyget

Mät-verktyget används för att mäta avstånd i kartan. Det kan exempelvis vara avståndet mellan två objekt eller en plottad rutt med flera delmål.
Klicka på denna knapp för att aktivera verktyget.

Knappen får detta utseende när funktionaliteten är aktiv, Ett klick på knappen då den har detta utseende avaktiverar funktionaliteten.
Klicka i kartan för att börja mäta, klicka igen för att placera ut delmål i en rutt. Dubbelklicka för att färdigställa rutten.

Ritverktyget

Med hjälp av detta verktyg kan en användare påverka vad som visas i kartan. Här kan man rita ut nya objekt så som linjer, polygoner, punkter och markeringar. Klick på knapparna aktiverar respektive verktyg, klick i kartan på något verktyg är aktivt påbörjar utritning, dubbelklick färdigställer ritat objekt (för punkt och markering färdigställs objektet vid det första klicket i kartan).

Verktyget innehåller även funktionalitet för att editera eller ta bort befintliga objekt. Klicka på någon av knapparna aktiverar respektive verktyg, alternativen spara och avbryt visas då verktyget är aktivt. Spara färdigställer editering, avbryt återställer editeringen.

Utökat ritverktyg

Detta verktyg används för att skriva ut text i kartan. Klicka för att aktivera verktyget.
Kilck i kartan då verktyget är aktivt visar en textediterings ruta, skriv in texten som skall visas i kartan och tryck på Enter för att färdigställa texten.

Klick på ett utritat objekt visar färgväljaren, klick i kartan döljer färgväljaren.

Knappar används för export och import av .kml-filer. Klick på den över knappen exporterar alla ritade objekt till en .kml-fil(kompatibel med andra kartverktyg) som automatiskt laddas ner. Klick på den nedre knappen öppnar en dialogruta för val av .kml-fil att importera in i kartan.

Lager-verktyget

Denna knapp används för att visa lager-verktyget. Vid ett klick på denna knapp visas den meny som du ser här till höger. I denna meny kan du styra vilken bakgrundskarta och vilka lager som skall visas. Du kan även få information om färger och symboler för de olika lagren (Obs: Innehållet i menyn på bilderna här är bara ett exempel!).

Här kan du se vilken bakgrundskarta som är vald och visas för tillfället.
Ett klick här expanderar en meny där du kan välja bakgrundskarta. Se exempelbild till höger.

Lager

Alla lager är grupperade i s.k lagergrupper. I denna meny kan du välja att aktivera ett, flera eller alla lager i en eller flera lagergrupper samt få information om färger och symboler i ett lager.

Indikerar att lagret eller alla lager i gruppen är inaktiva(visas ej). Ett klick aktiverar lagret eller alla lager i gruppen.

Indikerar att lagret eller alla lager i gruppen är aktiva(visas). Ett klick avaktiverar lagret eller alla lager i gruppen.

Indikerar att något eller några men inte alla lager i gruppen är aktiva. Ett klick aktiverar alla lager i gruppen.

Indikerar att gruppen inte är expanderad. Ett klick expanderar gruppen.

Indikerar att gruppen är expanderad. Ett klick minimerar gruppen.

Ett klick på denna knapp öppnar ett fönster med information om lagrets färger och symboler.

Du kan också ändra utritningsordningen av lagren. Detta görs genom att hålla nere vänster mus-knapp och "dra och släpp" på lagret. På samma sätt kan du ändra ordningen på lagergrupperna.

WMS-export-verktyget

WMS-export-verktyget används för att exportera en specifik del av kartan i olika format och storlek(upplösning).

Klicka på denna knapp för att aktivera verktyget.
Bilden till höger visar verktyget då det är aktivt.
Ett klick på den röda knappen avbryter verktyget.

Det aktiva verktyget består av två delar, en del för att välja ett område i kartan och en del som berör inställningar och kontroller.
Använd de vita ”hörnen” för att avgränsa det område av kartan som skall exporteras.
Om valda lager som existerar på samma WMS-server slås samman till en bild medans valda lager ifrån olika WMS-servrar kommer genereras som separata bilder.
Använd lager-verktyget för att aktivera de lager som skall exporteras.
Ett klick på den gröna knappen öppnar ett ”popup-fönster” med resultatet ifrån exporten.
Om formatet PDF har valts vid export så laddas filen/filerna automatiskt ned i det nya fönstret.
OBS: Endast lager ifrån servrar som är konfigurerade i GotMap’s GeoServerDefinitions kan användas vid export.

Lägg till WMS-Lager

Med detta vertyget kan användaren lägga till WMS-lager i kartbilden från WMS-servrar, man kan endast lägga till ett lager i taget.

För öppna verktyget klickar man antingen på knappen eller genom att högerklicka i kartbilden, beroende på hur verktyget har implementerats i applikationen.
Börja med att skriva in Url:en till den WMS-server som WMS-lagren ligger på.
Om vertyget lyckas "ansluta" till Url:en visas de lager som är tillgängliga.
När ett lager har valts kan användaren välja vilken stil man vill ha, förutsatt att det finns mer än 1 fördefinierad stil.
I sista steget innan wms-lagret läggs till i kartbilden, kan man ställa in avancerade inställningar för WMS-lagret.
När användren klickar på slutför läggs WMS-lagret till i kartbilden samt i lagerhanteraren, det tillagda lagret lagras därefter som en cookie och kommer därefter laddas in automatiskt när användaren stänger webbläsaren och öppnar applikationen i fortsättningen, detta kommer ske i 30 dagar och därefter kommer lagret tas bort. Om användaren vill ta bort lagret innan dess kan man öppna vertyget och på första sidan listas de tillagda lagren och där kan man välja att ta bort ett specifikt lager.

Gatuvy-verktyget

Klicka på knappen för att aktivera verktyget, när verktyget är aktivt visas linjer i kartan som indikerar vart det finns ”gatuvy”-bilder.
För att stänga av verktyget och återgå till normalläge klickar du på samma knapp igen.
Ett klick i kartan då linerna är synliga öppnar iNovitas verktyg för "gatuvy"-bilder.
För hjälp om hur iNovitas verktyg fungerar se manualen här eller använd hjälpfunktionen inne i verktyget.