Veelgestelde vragen over 6PP
Questioning the postcode?
FAQ: Vraag en antwoord.
Algemeen
- Vanwaar de naam 6PP?
- Wat is er nieuw in 6PP versie 2010?
- Waarom 6PP?
- Is dit legaal?
- Wat te doen bij het aantreffen van een illegale bron?
- Hoe volledig is de 6PP database?
Technisch
- De voorbeelden werken niet goed
- Waarom krijg ik meerdere straten terug?
- Hoe kan ik 6PP gegevens op een eigen server gebruiken?
- Hoe kan ik de 6PP gegevens synchroniseren met mijn eigen database?
- Hoe kan ik helpen?
- Hoe voeg ik (geautomatiseerd) data toe aan 6PP?
Algemeen
Vanwaar de naam 6PP?
Een Nederlandse postcode zoals "5616 JR" bestaat uit 4 cijfers plus 2 letters. Dit wordt een 6-positie postcode genoemd, afgekort 6PP.
Wat is er nieuw in 6PP versie 2010?
- 6PP ondersteunt internationale postcode systemen. We beginnen bij de buren, in België.
- 6PP wordt breder inzetbaar door meer API kits beschikbaar te stellen. Nieuw zijn de Javascript en PHP kits. (Met dank aan JwvdV)
- Geautomatiseerde feedback vanuit b.v. websites worden gefilterd en manueel gecontroleerd (dit geldt niet voor de wiki-edits, deze blijven instantaan).
- 6PP bevat nu gemeenten welke geen woonplaats zijn (en dus geen postcodes bevat).
- De database is klaargemaakt voor het op grote schaal importeren van geo-coordinaten op elk detail-niveau.
Het is nog onbekend of deze nieuwe features op tijd klaar zijn voor de volgende versie:
- 6PP kan meer informatie verstrekken dan postcodes alleen. Bijvoorbeeld het aanvullen van woonplaats en straat op invulformulieren.
- Vanuit OSM worden huisnummers door gebruikers manueel ingevoerd en naar 6PP doorgegeven (licentie compatible met zowel OSM als 6PP).
Waarom 6PP?
Omdat er nog geen vrije postcode database bestaat. Aan gebruik van gratis alternatieven zoals de Google Geocoding Service zijn helaas strenge eisen verbonden. Ook postcode.nl stelt beperkende voorwaarden.
Is dit legaal?
6PP gebruikt geen bronnen die (in)direct afkomstig zijn uit de officiële TNT databank. Dit zou inbreuk maken op het databankrecht van TNT.
6PP gebruikt enkel 'user-generated' data afkomstig van honderden websites, tientallen adresbestanden en zelfs reclamefolders.
Gebruik deze beschrijving om te bepalen of een bron aan de criteria voldoet.
Wat te doen bij het aantreffen van een illegale bron?
Neem contact op met de beheerder. De bron zal zo snel mogelijk verwijderd worden.
Hoe volledig is de 6PP database?
Zie de huidige statistieken. Doorgaans beantwoord 6PP de vraag naar postcodes >98% succesvol (aantal succesvolle lookup calls).
Volgens de laatst bekende getallen bevat de Reekstabel Nederland van Postcode.nl, editie mei 2009: 646855 records.
Voor de meest gebruikte toepassing voor 6PP (voer een postcode in en krijg de straat + woonplaats terug) is het niet interessant om te weten dat 5408 AJ zowel reeks 1 t/m 39 als 2 t/m 24 bevat. Laten we reeksen buiten beschouwing welke toch geen andere postcode opleveren dan zijn er nog 495195 records over.
Zelf beschik ik niet over een officiële bron, dus ben ik afhankelijk van cijfers geplubliceerd door derden om uitspraken te doen over compleetheid.
Technisch
De voorbeelden werken niet goed
Stappenplan om de fout te lokaliseren:
- Controleer of de HTML code voldoet aan de standaard met deze validatie tool.
- Controleer of er geen fouten in de JavaScript code zitten door in Firefox de 'error console' te bekijken (Ctrl-Shift-J).
Mocht het nog niet lukken, vraag om hulp in het 6PP forum.
Waarom krijg ik meerdere straten terug?
Meestal omvat één postcode één straat. Bij de uitzonderingen worden meerdere straten geretourneerd, zoals bij 2987 XS.
Hoe kan ik 6PP gegevens op een eigen server gebruiken?
Wie niet afhankelijk wil zijn van de 6PP webservice kan de gegevens ook downloaden als SQL, CSV of XLS bestanden.
Tevens is de broncode beschikbaar, waarmee het mogelijk wordt de 6PP webservice op eigen servers te hosten. Lees in dit geval ook meer over synchronisatie.
Hoe kan ik de 6PP gegevens synchroniseren met mijn eigen database?
Het is mogelijk om de laatste wijzigingen uit de 6PP database op te vragen en hiermee een eigen database synchroon te houden. Voorbeeld in de tutorial.
Hoe kan ik helpen?
- Vraag vrienden en bedrijven in je kennissenkring hun (geanonimiseerde) adresbestanden te uploaden als bron voor nieuwe postcodes en straten.
- Bekijk de eigen buurt in de wiki. Zijn de namen van steden, straten en postcodes volledig? Gebruik je eigen kennis en legale bronnen voor aanvullingen.
- Maak een scraper om geautomatiseerd adresgegevens aan 6PP toe te voegen. Kijk ook op de lijst van huidige en potentiële bronnen.
- Maak een API kit om 6PP te gebruiken vanuit jouw favoriete taal.
Hoe voeg ik (geautomatiseerd) data toe aan 6PP?
Bij integratie van 6PP in webformulieren komt het soms voor dat 6PP een postcode of adres niet kent. Om er voor te zorgen dat 6PP in toekomst deze postcode-adres combinatie wel bevat is er een mogelijkheid om de data automatisch aan te bieden.
De gebruiker vult op het webformulier zijn complete adres in, en op de achtergrond worden deze gegevens doorgegeven aan 6PP middels een feedback API call.
Dit proces is zeer eenvoudig en bestaat uit 2 stappen:
- Maak een 'source' aan. Zodat 6PP weet waar de gegevens vandaan komen. Probeer hier zo volledig mogelijk te zijn, zodat er in geval van grote hoeveelheden foutieve data contact opgenomen kan worden. Deze stap hoeft slechts eenmalig te worden uitgevoerd.
http://6pp.kvdb.net/services/setsource?name=Freelance Henk <henk@freelancehenk.nl>&source=Tuincentrum Knolweg <www.tcknolweg.nl>
Bewaar het teruggegeven 'id'. Dit is de source_id voor de opvolgende API calls. -
Om een nieuwe postcode-adres combinatie aan te bieden is er de 'feedback' API call. Bij parameter 'street' wordt een eventueel aanwezig huisnummer automatisch verwijderd.
http://6pp.kvdb.net/services/feedback?source_id=66008&postcode=5408XB&street=Reestraat
De gegevens verschijnen niet direct in de 6PP database maar worden aangeboden aan een moderator ter controle.
Er zijn alternatieve methoden om de data aan te bieden:
- De data lokaal verzamelen en in 1x aanbieden via de CSV/XLS uploader.
- Wanneer de kwaliteit van de aangeboden data hoog is, mag de data uiteraard ook direct in de 6PP database verwerkt worden, maar hiervoor dienen andere API calls te worden gebruikt. Zie hiervoor het complete API call overzicht.
Andere vraag?
Vul het reactieformulier in (inclusief email adres voor antwoord).