Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
Volgende revisie | Vorige revisie | ||
handleidingen:groepsadmin:publieke_webservice [2010/10/21 16:09] Wouter Van Scharen aangemaakt |
handleidingen:groepsadmin:publieke_webservice [2017/01/26 14:41] (huidige) Maarten Vanachter |
||
---|---|---|---|
Regel 1: | Regel 1: | ||
====== Zoek een groep webservice ====== | ====== Zoek een groep webservice ====== | ||
- | Scouts en Gidsen Vlaanderen heeft een publieke webservice die informatie over onze groepen, zoals naam, adres, website uit de live databank weergeeft. | + | 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 en houden deze up to date. | + | 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: | Onze groepenzoeker maakt gebruik van dezelfde webservice: | ||
- | http://www.scoutsengidsenvlaanderen.be/groepen-zoeker | + | 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. | Deze informatie is voor iedereen toegankelijk, je bent dus vrij om deze te gebruiken voor andere toepassingen. | ||
Regel 11: | Regel 14: | ||
===== Werking ===== | ===== 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. | + | 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. | De gegevens die je terug krijgt zijn gesorteerd op groepsnummer. | ||
Regel 18: | Regel 21: | ||
https://groepsadmin.scoutsengidsenvlaanderen.be/groepsadmin/rest/zoek-groepen?nummer=......&output=xml | 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 ===== | ===== Query ===== | ||
Regel 25: | Regel 36: | ||
Bevat een regular expression welke vergeleken zal worden met de groepsnummer. | Bevat een regular expression welke vergeleken zal worden met de groepsnummer. | ||
- | A3143G zal een groep teruggeven. A31… zal alle groepen van het district opsinjoor tonen. …..G alle gemengde groepen enzovoort. | ||
- | Meer info over de samenstelling van 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 ==== | ==== soort ==== | ||
Regel 54: | Regel 84: | ||
XML of KML | XML of KML | ||
- | * De XML bevat alle gegevens die opvraagbaar zijn. XML structuur. | + | * 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. KML 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 ===== | ===== Structuur ===== | ||
- | ====== groepsnummer ====== | + | ==== groepsnummer ==== |
{{:groepsadmin:groepsnummer.jpg?350|}} | {{:groepsadmin:groepsnummer.jpg?350|}} | ||
Regel 67: | Regel 96: | ||
* G Gemengd | * G Gemengd | ||
- | ====== XML ====== | + | * D Districtsploeg |
+ | * P Gouwploeg | ||
+ | * K Open Kamp | ||
+ | |||
+ | **Overzicht Gouwen en Districten** | ||
+ | |||
+ | http://www.scoutsengidsenvlaanderen.be/groepen-zoeker-tree | ||
+ | |||
+ | ==== XML ==== | ||
<groepen> | <groepen> | ||
Regel 96: | Regel 133: | ||
</groepen> | </groepen> | ||
- | ====== KML ====== | + | ==== KML ==== |
<kml xmlns="http://earth.google.com/kml/2.0"> | <kml xmlns="http://earth.google.com/kml/2.0"> |