Services

In deze sectie van de MapGallery beheeromgeving kun je verschillende services beheren, zoals API's, WMS en WFS. Een service kan meerdere kaartlagen onstluiten.

Navigatie

Klik op het instellingen-icoon () rechtsboven in de header.
Selecteer Dashboard uit het menu en ga naar de sectie services.
Je bent dan op de Lijstweergave.
Voor het Bewerkingsscherm, klik dan op een service uit de lijst, waarvan je de instellingen wilt wijzigen.

Lijstweergave

Dit overzicht toont een lijst van de beschikbare services in MapGallery. In het overzicht is snel te zien welke services beschikbaar zijn en wanneer deze zijn toegevoegd.

Boven de lijst wordt aangegeven hoeveel services er momenteel beschikbaar zijn in het systeem.

Het overzicht bevat de volgende velden:

Naam	Beschrijving
`Id`	Uniek identificatienummer van de service.
`Datum`	Datum waarop de service is toegevoegd of voor het laatst is bewerkt.
`Naam`	De naam van de service.
`Protocol`	Het bestandsformaat of gebruikte protocol van de service.
`Toegang`	Toont of de service publiek toegankelijk is of geauthenticeerd.
`URL`	De URL van de service.

Acties

Door op een veldnaam te klikken, wordt de sortering aangepast. Een omhoogwijzend pijltje geeft aan dat er gesorteerd wordt van A-Z, terwijl een omlaagwijzend pijltje Z-A aangeeft. Door nogmaals te klikken, wordt de sortering teruggezet naar de oorspronkelijke volgorde (op basis van Id).

Rechtsboven in het overzicht bevinden zich de actie elementen.

Gebruik de Filterfunctie om snel te zoeken op basis van naam, type, of beschrijving. Dit helpt je om een specifiek record snel te vinden.

Klik op Toevoegen om een nieuwe service aan te maken in MapGallery. Een pop-upscherm komt tevoorschijn waar de basis-kenmerken kunnen worden ingevoerd. Voor meer informatie over het toevoegen van een collectie, zie een service toevoegen.

Aan de rechterkant van elke rij in het overzicht is er een menu met acties die je kunt uitvoeren op een service. Dit menu wordt geopend door op de drie puntjes te klikken en biedt de onderstaande opties.

Bewerken: Hiermee kan de service worden aangepast, zoals de naam, beschrijving, of toegangsniveaus.

Dupliceren: Hiermee kan een exacte kopie van de service worden gemaakt, handig voor snel hergebruik.

Verwijderen: Hiermee kan de service worden verwijderd uit MapGallery.

Bewerkingsscherm

Via het bewerkingsscherm worden alle relevante details van een service weergegeven en kunnen kunnen de instellingen worden gewijzingd.

Bewerkingsopties

Bovenaan de pagina zijn de tabbladen Algemeen en Kaartlagen voor verschillende instellingen van de service.

Tabblad Algemeen

Bevat de belangrijkste instellingen van de service (zoals hieronder beschreven). Velden met een * zijn verplicht. Uitleg van de Velden:

Naam	Beschrijving
`Uitschakelen`	Wanneer deze optie is aangevinkt, wordt de collectie niet getoond in het overzicht voor de eindgebruikers. De service blijft echter wel toegankelijk voor beheerders.
`Toegang`	Hier kun je de toegang van de service instellen.
`Naam`	De naam van de service.
`Notitie`	Hier kunnen eventuele beheernotities worden toevoegen die niet zichtbaar zijn voor de eindgebruikers.
`URL`	Dit is de URL waarop de service beschikbaar is.
`Query parameters`	Extra parameters die bij het opvragen van de service kunnen worden meegegeven: `Param1=value1&Param2=value2`

Tabblad Protocol

Hier stel je het protocol in (bijvoorbeeld WMS of WFS) en kun je specificaties configureren zoals versies en outputformaten.

Tabblad Authenticatie

In dit tabblad stel je in welke authenticatiemethoden worden gebruikt voor toegang tot de service. Er zijn drie mogelijkheden:

None: Geen authenticatie vereist. Kies deze optie voor een openbare service waar geen inlog- of verificatiemechanisme voor nodig is.
Basic Authentication: Vereist een gebruikersnaam en wachtwoord om toegang te krijgen. Dit is een eenvoudige maar minder veilige authenticatiemethode.
HTTP header token: Een token in de HTTP-header voor authenticatie. Dit is een veelgebruikte methode voor API-toegang waarbij een token als beveiligingssleutel fungeert.
Query parameter token: Een authenticatietoken wordt meegegeven als queryparameter in de URL.

Tabblad Foutmeldingen

Wanneer er problemen optreden met een service, zoals een API, WMS of WFS, kan de foutmeldingen log nuttige informatie bieden om de oorzaak te achterhalen en op te lossen.

Acties

Rechtsboven in het overzicht bevinden zich de actie knoppen.

Klik op de knop Openen om de service direct in een nieuw scherm te bekijken zoals gebruikers deze zouden zien. Tussentijdse wijzigingen worden niet opgeslagen.

Via de knop Kaartlagen kunnen informatielagen uit de service direct worden gekoppeld. Zie ook Een kaartlaag toevoegen voor meer informatie.

Klik op de knop Opslaan om aangebrachte wijzigingen aan de service op te slaan. Een kleine spinner geeft feedback wanneer het opslaan is gelukt.

Context menu

Via het uitklapmenu zijn de onderstaande opties beschikbaar.

Terug naar lijst: Terug naar de lijst en de wijzigingen niet opslaan.

Verwijderen: Door in het uitklapmenu te kiezen voor Verwijderen kun je een service verwijderen.

Een service toevoegen

Navigeer naar de lijstweergave via stappen 1 en 2 van Navigatie
Klik op Toevoegen. Een pop-upscherm komt tevoorschijn.
Vul de basisinformatie voor de service in het formulier in.
Klik op Opslaan rechtsonder in het pop-upvenster om de nieuwe service op te slaan. Als je op Sluiten klikt, wordt het toevoegen van de service geannuleerd.

Let op

Zodra je de nieuwe service hebt opgeslagen, opent automatisch het bewerkingsscherm voor verdere aanpassingen.

Ondersteunde formaten en protocollen

GeoJSON: JSON-gebaseerd GIS-bestand in WGS84 projectie voor het uitwisselen van geografische gegevens.
HTTP: URL van web-assets voor het direct laden van symbolen of metadata. Dit protocol wordt gebruikt om assets te whitelisten voor de proxy, zodat deze kunnen worden geladen.
MapBox: Vectorlaag dat de MapBox/MapLibre specificatie volgt, vaak gebruikt voor schaalbare, interactieve kaarten.
REST: Simpele REST API voor het ophalen van geografische data via een standaard HTTP-interface. Het formaat kan XML of JSON zijn. MapGallery converteert intern de gegevens naar GeoJSON op basis van Latitude- en Longitude-velden.
TileJSON: Vectortiles laag dat de TileJSON-specificatie volgt.
TMS: Tile Map Service, een protocol voor het laden van kaartlagen als rastertiles.
WFS: Web Feature Service, een OGC-standaard voor het uitwisselen van vectorgeometrieën en bijbehorende attributen.
WMS: Web Map Service, een OGC-standaard voor het opvragen van kaartafbeeldingen op basis van geografische gegevens.
WMTS: Web Map Tile Service, een OGC-standaard voor het opvragen van kaartlagen als voorgerenderde tiles.
XYZ: Laag met een eenvoudige URL-structuur voor het laden van kaarten als rastertiles.

Een service verwijderen

Navigeer naar de lijstweergave via stappen 1 en 2 van Navigatie
Klik op de drie puntjes () naast de service en selecteer Verwijderen.
Vink in het pop-upscherm het vakje aan naast "Ik weet het zeker, verwijder record(s)" om te bevestigen dat je de service wilt verwijderen.
Klik op Verwijderen rechtsonder in het pop-upscherm om de service definitief te verwijderen.

Let op

Verwijderde services kunnen niet worden hersteld. Zorg ervoor dat je zeker bent van deze actie voordat je doorgaat.