Zoek een groep webservice

In het kader van “Open Data” heeft Scouts en Gidsen Vlaanderen een publieke webservice die informatie over onze groepen, zoals naam, adres, website uit de live databank weergeeft. De groepen beheren zelf de info die over hun groep beschikbaar is en houden deze up to date.

Onze groepenzoeker maakt gebruik van dezelfde webservice: http://www.scoutsengidsenvlaanderen.be/kennismaken/lid-worden/groepen

Deze informatie is voor iedereen toegankelijk, je bent dus vrij om deze te gebruiken voor andere toepassingen.

Je doet een GET aanvraag via onderstaande url, je krijgt dan van de server de gegevens terug in een XML (standaard) of KML formaat. Van welke groepen je de gegevens terug krijgt hangt af van de opties die je in de url meegeeft. De gegevens die je terug krijgt zijn gesorteerd op groepsnummer.

Deze url geeft alle groepen terug in een xml formaat:

https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=......&output=xml

Als je een output in KML vraagt kan je de url ook rechtstreeks doorgeven aan Google maps en daar verder integraties mee te doen.

Voorbeeld van L1 https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=L1....&output=kml

http://maps.google.be/maps?f=q&source=s_q&hl=nl&geocode=&q=https:%2F%2Fgroepsadmin.scoutsengidsenvlaanderen.be%2Fgroepsadmin%2Frest%2Fzoek-groepen%3Fnummer%3DL1....%26output%3Dkml&sll=0,0&sspn=174.768914,193.359375&ie=UTF8&ll=51.000279,5.435739&spn=1.064753,3.56781&t=h&z=9

Je kan dus verschillende opties meegeven waardoor er specifiekere resultaten terug gegeven worden.

Bevat een regular expression welke vergeleken zal worden met de groepsnummer.

A3143G zal één groep teruggeven. https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=A3143G&output=xml

A31… zal alle groepen van het district opsinjoor tonen. https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=A3...G&output=xml

…..G alle gemengde groepen https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=.....G&output=xml

enzovoort.

Je kan ook twee groepen combineren door ze gescheiden met een komma door te geven https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=A3143G,A2170G&output=xml of https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=A31...,A21...&output=xml

Meer info over de samenstelling van de groepsnummer.

De soort groep. Je kan meerdere items meegeven door ze te scheiden met een ‘+’ of een ‘,’. Soorten:

• Gewoon – Alle groepen
• Akabe – Akabe groepen
• Akabetak – Groepen met een apparte akabetak
• Zeescouts – Zeescouts groepen
• Jin – Jin groepen
• Inclusie – Groepen met akabe werking in de gewone takken

Geef een rechthoek op van het volgende formaat: lat1,lng1|lat2,lng2 Alle groepen waarvan de locatie binnen deze coördinaten valt worden dan terug gegeven. Voorbeeld: fits=40.737102,-73.990318|40.749825,-73.987963

Alle groepen die in de gemeente met die bepaalde postcode liggen.

XML of KML

• De XML bevat alle gegevens die opvraagbaar zijn. XML structuur.
• De KML is een op XML gebaseerde standaard opmaaktaal voor geografische data. Deze bevat veel minder informatie dan de XML. KML structuur.

Types

• S Jongens
• M Meisjes
• G Gemengd

• D Districtsploeg
• P Gouwploeg
• K Open Kamp

Overzicht Gouwen en Districten

http://www.scoutsengidsenvlaanderen.be/groepen-zoeker-tree

<groepen>
  <groepen>
    <groep id="61">
      <groepsnummer/>
      <groepsnaam/>
      <bankrekeningnummer/>
      <adressen>
        <adres post="true">
          <straat/>
          <nummer/>
          <bus/>
          <postcode/>
          <gemeente/>
          <land/>
          <beschrijving/>
          <point>
            <coordinates/>
          </point>
        </adres>
      </adressen>
      <website/>
      <type/>
      <description/>
    </groep>
  </groepen>
</groepen>

<kml xmlns="http://earth.google.com/kml/2.0">
  <Placemark>
    <description/>
    <name/>
    <Point>
      <coordinates/> 
    </Point>
  </Placemark>
</kml>