Deep links vanuit een GIS-viewer koppelen

Veel organisaties openen GEORIZON vanuit hun eigen GIS- of kaartviewer: je klikt op een plek in de kaart en het panorama van die plek opent. Dit artikel beschrijft hoe je zo'n koppeling inricht en hoe je de meest voorkomende fouten voorkomt. De volledige specificatie van alle parameters staat in Deep links (XY integratie).

1. Een URL-sjabloon met placeholders

Je GIS-pakket vult bij een klik de coördinaten in een URL-sjabloon in. Hoe de placeholders heten, verschilt per pakket. Veelgebruikt zijn $coordx en $coordy, maar ook {x}, [X] of %X% komen voor. Raadpleeg de documentatie van je GIS-pakket.

Een sjabloon voor de GEORIZON-viewer ziet er zo uit:

https://argos.georizon.cloud/<omgeving>/<project-id>?x=$coordx&y=$coordy&views=pano

• <omgeving> is de naam van je omgeving, bijvoorbeeld gemeente-voorbeeld.
• <project-id> kopieer je uit de adresbalk als je het project in de viewer opent.
• views=pano zorgt ervoor dat het dichtstbijzijnde panorama direct opent, kijkend naar het aangeklikte punt. Zonder views centreert de viewer alleen de kaart.

Tip: kopieer de project-URL uit de adresbalk en verwijder alles vanaf het vraagteken. Plak daarna het deel met de placeholders erachter. Zo blijven er geen vaste coördinaten in het sjabloon achter.

Dezelfde URL werkt voor interne en openbare toegang. Of een gebruiker moet inloggen, hangt af van de instellingen van het project, niet van de link.

2. Coördinaatstelsel

x en y moeten in het coördinaatstelsel van het project staan: x is de oostwaarde, y de noordwaarde. Voor Nederlandse projecten is dat Rijksdriehoek (RD New, EPSG:28992). Controleer dat je GIS-pakket de placeholders in RD invult en niet in graden (WGS84). Gebruik een punt als decimaalteken.

3. Alleen bepaalde beelden tonen

Bevat een project beelden uit meerdere datasets, bijvoorbeeld eigen opnamen en opnamen van een andere leverancier, dan zijn er twee manieren om te bepalen wat er opent:

1. In de link: met views=pano@<dataset-id> opent alleen een panorama uit die ene dataset. Gebruik het dataset-id, zodat de link blijft werken als de dataset wordt hernoemd. De gebruiker kan in de viewer wel andere datasets aanzetten.
2. Met een apart project: 360GEO kan een project inrichten met alleen de gewenste datasets. Dit is de juiste keuze als andere beelden niet zichtbaar mogen zijn, bijvoorbeeld bij een openbare koppeling of vanwege licentievoorwaarden.

4. Koppelingen van de Omnibase viewer omzetten

Koppelingen die nog naar de Omnibase viewer wijzen, moet je aanpassen voor de GEORIZON viewer. Controleer twee dingen:

De parameter dataset=panorama wordt in de GEORIZON viewer niet herkend. De link brengt je dan wel naar de juiste plek, maar er opent geen panorama.

5. Veelgemaakte fouten

6. Testen

Test een sjabloon eerst met een ingevulde link. Vervang de placeholders door de coördinaten van een bekende plek, open de link in de browser en controleer dat het panorama van die plek opent. Werkt de ingevulde link wel, maar de koppeling vanuit het GIS niet, vergelijk dan de URL die het GIS-pakket daadwerkelijk genereert met je testlink. Stuur bij een supportvraag altijd die volledig ingevulde URL mee.

7. Verder integreren: de Viewer API

Een deep link opent de viewer op een plek, maar hoort niets terug. Wil je dat je eigen toepassing ook weet wat de gebruiker doet, gebruik dan de Viewer API. Daarmee kan een GIS-toepassing foto's openen op een plek, eigen objecten over elke weergave leggen en de gebruiker laten meten. De viewer meldt terug wat de gebruiker meet, waar de cursor staat, waar elke weergave naar kijkt en waar foto's zijn genomen, zodat je dat op je eigen kaart kunt tekenen.

Je laat de viewer op drie manieren zien. De berichten zijn in alle drie hetzelfde.

• Webcomponent. Voor een webpagina met de viewer naast je eigen kaart.
• Eigen browsertabblad. Je pagina opent de viewer in een apart tabblad.
• WebSocket. Voor een desktopprogramma dat de viewer in de browser van de gebruiker opent.

Een project dat niet openbaar is, heeft een projecttoegangstoken nodig. Gebruik een alleen-lezen token dat je los kunt intrekken, want iedereen die kan zien hoe je toepassing de viewer opent, kan het token lezen. Een openbaar project heeft geen token nodig.

Het protocol, de parameters, het JSON Schema en een voorbeeld dat je kunt kopiëren en uitproberen vind je op argos.georizon.cloud/docs. Een uitgebreide Nederlandse uitleg staat in GIS-koppeling en plugins: de GEORIZON viewer integreren met de Viewer API.