Veelgestelde vragen over 6PP
Questioning the postcode?
FAQ: Vraag en antwoord.
Algemeen
- Vanwaar de naam 6PP?
- Waarom 6PP?
- Is dit legaal?
- Wat te doen bij het aantreffen van een illegale bron?
- Hoe volledig is de 6PP database?
Pro6PP
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.
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.
Pro6PP
Wat is Pro6PP?
Pro6PP onlsuit de vrije geografische gegevens van 6PP als webservice. Professioneel in 'de cloud' met extra functionaliteit en voorbeelden.
Motivatie achter Pro6PP?
In 2008 is 6PP ontstaan als klein open-source project. Het aantal gebruikers, waaronder veel bedrijven, groeide hard. Met Pro6PP komt D-centralize tegemoet aan de vraag naar support en professionalisering van de 6PP database.
Gevolgen voor 6PP?
De open-source postcode database zoals deze is te downloaden op 6PP zal blijven bestaan. Pro6PP zal ook bijdragen aan de kwaliteit van de 6PP database.
De webservice zoals deze op dit moment op de 6PP website gratis wordt aangeboden zal worden uitgefaseerd. Gebruikers kunnen (zoals altijd het geval was) de gratis 6PP database zelf verwerken in hun website of applicatie. Voor wie liever gebruikt blijft maken van een hosted webservice betaald voortaan een kleine jaarlijkse vergoeding.
Niet commercieel gebruik
Omdat rond 6PP een community is ontstaan met een niet-commerciële insteek komen personen met een niet-commercieel doel een aanvraag doen voor een gratis Pro6PP account.
Beveiliging
Bij elke Pro6PP webservice oproep dient de persoonlijk auth_key meegestuurd te worden. Wanneer Pro6PP gebruikt wordt binnen een (server-side)applicatie is dit geen probleem, niemand ziet deze auth_key. Maar wanneer vanaf de client-side een webservice oproep naar Pro6PP gedaan wordt (b.v. met Javascript) is de auth_key zichtbaar. Om ervoor te zorgen dat een 'gestolen' auth_key niet werkt op een andere website kan een auth_key worden gekoppeld aan een specifiek domein. Standaard staat deze beveiliging uit. Binnenkort is dit via een CMS in te stellen, voorlopig neem contact op.
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).