Documentatie voor Integratie met XY Parameters Omnibase

Gewijzigd op Ma, 13 Jul om 9:15 AM

Documentatie voor Integratie met XY-Parameters in de Omnibase Viewer

Doel:
Deze documentatie legt uit hoe je de Omnibase viewer kunt integreren in je eigen applicatie of website met vooraf ingestelde XY-coördinaten.

Parameters:

x: De X-coördinaat van het punt dat je wilt centreren in de Viewer.
y: De Y-coördinaat van het punt dat je wilt centreren in de Viewer.

Stappen voor Integratie:

1. Identificeer de Coördinaten en het Coördinatenreferentiesysteem (CRS)

Bepaal de XY-coördinaten en het coördinatenreferentiesysteem (CRS) dat je wilt gebruiken. Zorg ervoor dat het CRS compatibel is met het systeem dat door Omnibase wordt ondersteund.

2. Creëer de Integratie-URL

Om de integratie-URL te maken, voeg je de XY-coördinaten en het CRS toe aan de basis-URL met behulp van de queryparameters x, y en het type beeldmateriaal. Gebruik de onderstaande URL-structuren:

Puntwolk:

https://viewer.georizon.nl/tenant/018a227c-cbcb-71a8-84ac-07244821b3ff/projects/018ef61f-af6e-7252-b070-07061ba8612b?x=188033.00&y=428619.00

Panorama:

https://viewer.georizon.nl/tenant/018a227c-cbcb-71a8-84ac-07244821b3ff/projects/018fa545-b722-70d5-9c87-ad8cef1fc7dd?x=188033.00&y=428619.00&dataset=panorama

Obliek:

https://viewer.georizon.nl/tenant/018a227c-cbcb-71a8-84ac-07244821b3ff/projects/018ef61f-af6e-7252-b070-07061ba8612b?x=188033.00&y=428619.00&dataset=obliek

Extra parameters:

2D- of 3D-modus
Voeg de parameter &mode of &modus toe met de waarde 2d of 3d (hoofdletters en kleine letters zijn beide geldig).
Indien geen parameter wordt meegegeven, is de standaardwaarde 2d.
Voorbeeld: &mode=3d
Kijkrichting (voor obliek)
Voeg de parameter &direction of &richting toe met de waarde N, S, E of W (noord, zuid, oost, west; hoofdletters en kleine letters zijn beide geldig).
Let op: deze parameter bepaalt de kijkrichting van de camera en niet de zijde van het object die zichtbaar is.
Voorbeelden:
- &direction=S → de camera kijkt naar het zuiden en toont daardoor de noordzijde van een gebouw.
- &direction=N → de camera kijkt naar het noorden en toont daardoor de zuidzijde van een gebouw.
Voorbeeld: &direction=S

Dataset specificeren:

Om een specifieke dataset te selecteren, voeg je de dataset ID of een deel van de datasetnaam toe aan de URL:

&dataset=id-van-dataset of &dataset=deel-van-de-naam-van-de-dataset

Virtuele Collecties (VC’s) specificeren:

Virtuele Collecties (VC’s) maken het mogelijk om samengestelde datasets via één OGC-API-endpoint te benaderen.
Een VC-endpoint heeft de volgende structuur:

https://georizon.nl/api/ogc-v1/tenant/{tenant_id}/virtual-collections/{virtual_collection_id}

Voorbeeld:

https://georizon.nl/api/ogc-v1/tenant/01952384-afd6-7015-894f-708ccfd7e7a7/virtual-collections/0199ec6a-75e5-7323-a380-1482e8de9eb7

Authenticatie verloopt op dezelfde manier als bij datasets

Conversie van coördinaten (WGS84 naar RDNew):

Voor coördinaatconversie kun je de volgende URL gebruiken:

https://georizon.nl/goto-wgs84/4.4629484/51.9310754/tenant/018e5654-94ac-714a-96b1-8f78cf745b92/projects/0190fd4a-97ad-73a4-b7ba-7b4dcb5f3543?dataset=panorama

Vervang de gebruikte coördinaten door de daadwerkelijke variabelen.

Oriëntatie van Beelden: van Kappa-Omega-Phi naar Yaw-Pitch-Roll

De oriëntatie van beelden wordt in de metadata weergegeven met drie rotatieparameters:

κ (kappa) – rotatie rond de Z-as
ω (omega) – rotatie rond de X-as
φ (phi) – rotatie rond de Y-as

Georizon standaardiseert op een rechtshandig cameramodel waarbij:

de oorsprong (0,0,0) overeenkomt met een luchtfoto die loodrecht naar beneden kijkt;
de bovenkant van de foto naar noord is gericht.

Om deze waarden te vertalen naar een meer gangbare yaw-pitch-roll-notatie (waarbij 0,0,0 overeenkomt met een foto die horizontaal naar het noorden kijkt), kan een rotatiecorrectie van 90° rond de X-as worden toegepast.

In matrixvorm:

R_corrected = R_x(90°) * R_original

waarbij R_original de rotatiematrix is afgeleid uit kappa, omega en phi.

3. Implementeer de URL in je Applicatie

Gebruik een iframe of een webview-component om de Omnibase Viewer binnen je applicatie in te laden. Stel de gecreëerde URL in als bron voor het iframe of de webview.

4. Test de Integratie

Open je applicatie en navigeer naar de pagina of het onderdeel waar de Omnibase Viewer is geïntegreerd. Controleer of de Viewer laadt met het gecentreerde punt op basis van de opgegeven XY-coördinaten.

5. Foutopsporing

Als de kaart niet correct laadt:

Controleer of de coördinaten en het CRS juist zijn.
Test de URL direct in een browser om te verzekeren dat het probleem niet binnen de integratie ligt.

6. Opmerkingen:

Houd rekening met eventuele cross-origin-beleid (CORS) die de integratie kunnen beïnvloeden.
Het gebruik van het juiste CRS is essentieel voor een nauwkeurige positionering op de kaart.

Deze handleiding biedt een stapsgewijze benadering voor het integreren van de Omnibase Viewer met XY-coördinaten, zodat een specifiek punt binnen je applicatie gecentreerd wordt weergegeven.