====== 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

{{:handleidingen:groepsadmin:groepenzoekerlijst_1_.jpg|}}
{{:handleidingen:groepsadmin:groepzoekenkaart_1_.jpg|}}

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




[[handleidingen:groepsadmin:publieke_webservice#groepsnummer|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:
  * 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

==== 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
  * De XML bevat alle gegevens die opvraagbaar zijn.  [[handleidingen:groepsadmin:publieke_webservice#xml|XML structuur]].
  * De KML is een op XML gebaseerde standaard opmaaktaal voor geografische data. Deze bevat veel minder informatie dan de XML. [[handleidingen:groepsadmin:publieke_webservice#kml|KML structuur]].

===== Structuur =====
==== groepsnummer ====
{{:groepsadmin:groepsnummer.jpg?350|}}

**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

==== 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>