Aanmelden | RegistrerenHelp

Dit is een oude revisie van het document!


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

Nog voorbeeld die de webservice gebruiken:

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

Werking

Je doet een aanvraag naar de database via bijvoorbeeld onderstaande url, je krijgt dan van de database 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

Query

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

nummer

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. XML structuur.
  • De KML is een op XML gebaseerde standaard opmaaktaal voor geografische data. Deze bevat veel minder informatie dan de XML. KML structuur.

Structuur

groepsnummer

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