Integration with Janjoo Informera

Med ett integration-plugin för Janjoo Informera kan Weave skicka en polygon till Informera för användning vid utskick.

Process

En Weave-klient öppnas med en speciell tag i URL:en. Klienten öppnas från Informera som också genererar URL:en
Användaren markerar ett område med ett polygonverktyg.
När polygonen är korrekt trycker användaren på knappen "Skicka till Informera"
Polygonen är skickad och klienten kan stängas. Polygonen finns nu tillgänglig i Informera.

Konfiguration

I serverkonfigurationen anges inställningar för kommunikation mellan Informera och Weave. För klienten finns tre knappar; en för polygonverktyget, en för att skicka polygonen till Informera samt en för att skicka ett markerat urval.

Parameter	Krävs	Beskrivning
id	ja	Unikt id för konfigurationen. Flera konfigurationer kan sättas upp för Informera
url	ja	URL till Informera
apikey	ja	API-nyckel till Informera
acl	nej	Begränsa tillgång beroende på användare

Klientfunktioner

weave.informera.defineArea.polygon.new

Markera ett eller flera områden manuellt med polygonverktyg

Parameter

Krävs

Default

Beskrivning

doSelect

nej

false

Gör en spatial sökning för aktivt dataslag

singleFeature

nej

true

Tillåt enbart en polygon och ta bort föregående när en ny skapas. Användaren dubbelklickar på bakgrunden för att ta bort polygonen.

Om attributet är satt till 'false' kan flera polygoner ridas upp. Användaren dubbelklickar på en av polygonerna för att ta bort den.

deselectOnRemove

nej

true

Om 'doSelect' är satt till 'true' tas eventuell selektion bort när polygonen tas bort.

weave.informera.sendSelectionGeometry

Skicka selektion från aktivt dataslag till Informera.

Parameter

Krävs

Default

Beskrivning

enableFor

nej

(ingen begränsning)

Lista med dataslag där urvalet får skickas till Informera. Listan kan vara kommaseparerad eller så kan flera 'enableFor'-attribut

läggas efter varandra. Om attributet inte anges kan samtliga dataslag användas för att skicka selektionen. Observera att enbart polygonobjekt

kan skickas. Om något objekt är av annat slag skickas ett felmeddelande till användaren

weave.informera.sendArea

Skicka aktiv manuell markering från polygonverktyget.

Konfiguration

<!-- Server -->
<config xmlns="urn:com.cohga.server.config#1.0" 
...
xmlns:informera= "urn:se.viamap.janjoo.informera.InformeraService#1.0">

<informera:config id="informera.viamap">
	<url>https://url-to-informera/api/informera</url>
	<apikey>api67845</apikey>
</informera:config>
</config>


<!--Klient -->
<client:config id="informera">
...
<!-- Knappar med defaultinställningar -->
<item action ="weave.informera.defineArea.polygon.new" />
<item action ="weave.informera.sendArea" />
<item action ="weave.informera.sendSelectionGeometry" />

<!-- Tillåt att skicka selektion från två olika dataslag -->
<item action ="weave.informera.sendSelectionGeometry">
	<enableFor>fastigheter</enableFor>
	<enableFor>interna_omraden</enableFor>
</item>

<!-- Tillåt flera geometrier, markera underliggande dataslag och avmarkera dataslag och en polygon tas bort -->
<item action ="weave.informera.defineArea.polygon.new">
	<doSelect>true</doSelect>
	<singleFeature>false</singleFeature>
	<deselectOnRemove>true</deselectOnRemove>
</item>

</client:config>

API

Klient-api

För att starta en klient redo att skicka en polygon till Informera krävs en sessionsnyckel från Informera i URL:en. Den skickas med i som en HTTP GET.

Parameter	Krävs	Beskrivning
informerasession	Ja	Sessionsnyckel från Informera

Exempel: https://server-url.com/weave/informera.html?informerasession=informeraSessionKey-1234567

OBS! Om sessionsnyckeln inte finns med i anropet till klienten är samtliga knappar kopplade till Informera inaktiva.

Server-api

Servern skickar ett anrop till Informera. Anropet innehåller api-nyckel (från Weave-konfiguration), sessionsnyckel (från Informera) samt Polygonen som användaren skickat. Anropet skickas med HTTP POST och med Content-Type: application/json. Geometrin skickas t GeoJSON-formatet och omprojiceras till geografiska koordinater (EPSG:4326 / WGS84) innan den skickas till Informera.

Exempel på anrop

{
  "apikey": "api67845", 						// API-nyckel
  "sessionid": "informeraSessionKey-1234567",	// Sessionsnyckel för att identifiera transaktionen med Informera.
  "mapData": {
    "geometries": [
    "type": "GeometryCollection"
      {
        "coordinates": [
          [
            [
              17.15918321,
              60.67617631
            ],
            [
              17.15971914,
              60.67566988
            ],
            [
              17.16804736,
              60.67474963
            ],
            [
              17.16913409,
              60.67762766
            ],
            [
              17.16894522,
              60.67800378
            ],
            [
              17.16427994,
              60.67749103
            ],
            [
              17.15918321,
              60.67617631
            ]
          ]
        ],
        "type": "Polygon"
      },
      {
        "coordinates": [
          [
            [
              17.17319357,
              60.67424151
            ],
            [
              17.17587776,
              60.67407792
            ],
            [
              17.17682462,
              60.67650639
            ],
            [
              17.17414337,
              60.67682005
            ],
            [
              17.17319357,
              60.67424151
            ]
          ]
        ],
        "type": "Polygon"
      }
    ]
  }
}

Ikartan admin