Inhoud

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.

Werking

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

Google maps integratie

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

Query

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

nummer

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.

soort

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

fits

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

postcode

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

output

XML of KML

Structuur

groepsnummer

Types

Overzicht Gouwen en Districten

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

XML

<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

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