EasyGIS API

De EasyGIS-API is ontwikkeld om u de mogelijkheid te geven verschillende EasyGIS-modules in uw eigen website op te nemen. Om gebruik te kunnen maken van de EasyGIS API is een sleutel vereist. Deze sleutel kunt u aanvragen via info@easygis.eu.

1. Algemeen

Om de EasyGIS-API te laden, plaatst u de volgende code in de body van uw html document, bij voorkeur direct voor de </body>.

<script type="text/javascript" src="https://api.easygis.eu/js/latest.js">

2. Modules

Met de EasyGIS API is het mogelijk verschillende modules in te laden. Dit kan via JavaScript door de functie easygis.loadModule() aan te roepen na het inladen van de API. De functie easygis.loadModule() verwacht een enkel argument - bestaande uit een object - welke de gewenste configuratie bepaalt. De volgende eigenschappen zijn hierbij verplicht:

key is de door EasyGIS geleverde API-key;
module bepaalt welke module er geladen dient te worden;
target is de id van het HTML-element waarin de module geladen dient te worden.

Voorbeeld

<!DOCTYPE html>
<html>
<head>
  ...
</head>
<body>
  ...
  <div id="show-me-here"></div>
  ...
  <script type="text/javascript" src="https://api.easygis.eu/js/latest.js"></script>
  <script type="text/javascript">
    easygis.loadModule({
      key: 'ah5lf345yt274q2r234dq3464g563qy',
      module: easygis.Module.MODULE,
      target: 'show-me-here'
    });
  </script>
 </body>
</html>

2.1 Meldpunt

Voor het meldpunt gebruikt u de volgende module tag: easygis.Module.REPORTINGPOINT.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    module: easygis.Module.REPORTINGPOINT,
    ...
  });
</script>

2.2 Routeplanner

Voor de routeplanner gebruikt u de volgende module tag: easygis.Module.ROUTEPLANNER.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    module: easygis.Module.ROUTEPLANNER,
    ...
  });
</script>

2.2.1 Categorie

U dient een categorie op te geven middels de category tag. U heeft keuze uit de volgende categoriën:

easygis.Category.CYCLING voor fietsen;
easygis.Category.WALKING voor wandelen;
easygis.Category.HORSERIDING voor ruiteren & mennen;
easygis.Category.MOUNTAINBIKING voor mountainbiken;
easygis.Category.DRIVING voor autorijden;
easygis.Category.BOATING voor varen.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    module: easygis.Module.ROUTEPLANNER,
    category: easygis.Category.CYCLING,
    ...
  });
</script>

2.2.2 Taal

De taal waarin de routeplanner weergegeven wordt, kan ingesteld worden via de lang tag. U heeft de keuze uit de volgende (ISO 639-1) codes:

"nl"
"en"
"de"
"fr"

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    key: '...',
    module: easygis.Module.ROUTEPLANNER,
    lang: "nl",
    ...
  });
</script>

2.2.3 (Thema-) Route

U kunt een routecode opgeven middels de code tag. U kunt de code van een geplande route of een themaroute gebruiken.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    key: '...',
    module: easygis.Module.ROUTEPLANNER,
    category: easygis.Category.CYCLING,
    code: 'abcde'
    ...
  });
</script>

2.2.4 Zoom & Locatie

U kunt een initieel zoomniveau aangeven middels de zoom tag (0 < zoom < 19 ).

U kunt een initiele locatie aangeven center, waar de kaart op gecentreerd wordt. De locatie dient een lat en lng eigenschap te hebben in WGS84. Tip: Gebruik Google Maps voor het eenvoudig vinden van een het coördinaat van een locatie.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    module: easygis.Module.ROUTEPLANNER,
    category: easygis.Category.CYCLING,
    zoom: 11,
    center: {lat: 50.3, lng: 5.1}
    ...
  });
</script>

2.3 POI-Widget

Voor de POI-Widget gebruikt u de volgende module tag: easygis.Module.POIWIDGET.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    key: '...',
    module: easygis.Module.POIWIDGET,
    ...
  });
</script>

2.2.3 POI

U kunt een POI specificeren middels de uuid tag. U kunt de UUID terugvinden in het beheersysteem.

Voorbeeld

    
...
<script type="text/javascript">
  easygis.loadModule({
    ...
    key: '...',
    module: easygis.Module.POIWIDGET,
    uuid: 'a1b2c3d4-a1b2-a1b2-a1b2-a1b2c3d4e5f6'
    ...
  });
</script>