Index

Another question?

Please leave your feedback in the form (optionally include your email address)



Wat is Pro6PP?

Pro6PP ontsluit 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.

Hoe voeg ik (geautomatiseerd) een postcode toe aan Pro6PP?

Wanneer er een bijvoorbeeld een nieuwe wijk is gebouwd welke nog niet beschikbaar is in Pro6PP is het mogelijk om gebruikersinvoer automatisch toe te voegen aan Pro6PP. Meer informatie over de feedback methode.

Kan ik een API methode in 'beta' gebruiken?

Ja. Maar let op, de input parameters en output kan (en zal) nog wijzigen totdat het Beta labeltje weg is. Dit is de kans om gewenste wijzigingen kenbaar te maken.

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.

Niet commercieel gebruik

Omdat rond 6PP een community is ontstaan met een niet-commerciële insteek kunnen personen met een niet-commercieel doel een aanvraag doen voor een gratis Pro6PP account.

Een postcode zit wel in 6PP, maar niet in Pro6PP?

Pro6PP werkt met snapshots van de 6PP database. Het zijn dus verschillende databases. 6PP werkt als een wiki. Dus de kwaliteit varieert. Om regressies in Pro6PP tegen te gaan wordt de synchronisatie pas na handmatige controle uitgevoerd. Het kan dus even duren voordat een postcode ook in Pro6PP opgenomen is.

Is de database ook te downloaden?

Ja, met sommige abonnementen zijn de gegevens ook beschikbaar als downloads. Een voorbeeldje afkomstig uit een van de downloadbare lijsten, het bestand "download_nl_sixpp.csv": 

province,municipality,city,areacode,nl_sixpp,street,lat,lng
Noord-Holland,Amsterdam,Amsterdam,020,1011EW,Koningsstraat,52.37276,4.90127
Noord-Holland,Amsterdam,Amsterdam,020,1011EX,Korte Koningsstraat,52.37164,4.90297

Ook beschikbaar is "download_nl_fourpp.csv" met daarin alle viercijferige postcodes. Deze lijst is tevens beschikbaar voor Belgie. 

country,province,municipality,city,nl_fourpp,lat,lng
NL,Noord-Holland,Amsterdam,Amsterdam,1011,52.37094,4.90339
NL,Noord-Holland,Amsterdam,Amsterdam,1012,52.37307,4.89472

De CSV bestanden zijn eenvoudig te importeren in een eigen database of direct te openen in Excel.

Updates van de database zijn eenvoudig periodiek in te laden, want de download URL blijft gelijk.

Hoe bouw ik mijn oude 6PP scripts om naar Pro6PP?

Het is vrij eenvoudig om scripts die voor 6PP gemaakt zijn te laten werken voor Pro6PP. De URL en de parameters zijn net even anders.

6PP aanvullen: http://6pp.kvdb.net/services/lookup?postcode=5408xb
Pro6PP aanvullen: http://api.pro6pp.nl/v1/autocomplete?auth_key=YOUR_AUTH_KEY&nl_sixpp=5408xb

6PP feedback: http://6pp.kvdb.net/services/feedback?postcode=5408xb&street=Reestraat&city=Volkel&streetnumber=1
Pro6PP feedback: http://api.pro6pp.nl/v1/feedback?auth_key=YOUR_AUTH_KEY&nl_sixpp=5408xb&street=Reestraat

Algemene parameters:

6PP parameter: jsonp
Pro6PP parameters: callback

6PP parameter: tg_format
Pro6PP parameters: format

6PP resultaat container: result
Pro6PP resultaat container: results

Foutmelding 'Unable to get required HTTP_REFERER'

Er is via het CMS een beveiliging op domein ingesteld. Normaal gesproken stuurt een webbrowser de 'HTTP_REFERER' header met elk verzoek mee. Dus ook aan Pro6PP. Dit mechanisme werkt prima wanneer Pro6PP wordt gebruikt vanuit javascript op een webpagina. Dan is de 'referrer' namelijk de URL van die webpagina. Wanneer een Pro6PP URL direct opgeroepen wordt vanuit de browser (http://api.pro6pp.nl/v1/...) dan wordt deze aanvraag geblokkeerd.

Er is nog een situatie waar de header niet wordt meegestuurd. Wanneer de webpagina op een HTTPS adres staat en de Pro6PP API wordt aangeroepen op de standaard HTTP URL. Gebruik in dat geval de beveiligde HTTPS URL van Pro6PP.

Om Pro6PP toch makkelijk direct te kunnen testen vanuit de webbrowser is de oplossing eenvoudig. Schakel de beveiliging tijdelijk uit (via het CMS, verwijder de ingevulde domeinnaam). Zolang de auth_key nog niet publiekelijk gebruikt is, is dit geen probleem.

Hoe werkt de beveiliging met auth_key?

Bij elke Pro6PP webservice oproep dient de persoonlijke auth_key meegestuurd te worden. Wanneer Pro6PP gebruikt wordt binnen een applicatie of (server side) website is de auth_key niet zichtbaar. 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. Dit domein kan worden ingesteld via het Pro6PP CMS. Het is mogelijk meerdere domeinen in te vullen, zodat de auth_key werkt op de 'live server' en in een eventuele testomgeving (b.v. 'mydomain.nl; localhost' - invoeren zonder de quotes).

De beveiliging is onafhankelijk van IP, dus een website op een cluster met meerdere IP's werkt prima.

Kan ik HTTPS gebruiken?

De webservice is zowel met HTTP als HTTPS te benaderen. Webshops nemen vaak vanuit een beveiligde omgeving de bestelling op. Hierbij kan een webbrowser de communicatie naar een externe server blokkeren wanneer deze via een onbeveiligde (HTTP) verbinding zou lopen.

Gebruik hiertoe de basis URL: https://pro6pp.appspot.com
in plaats van de gebruikelijke: http://api.pro6pp.nl

Waarom krijg ik meerdere straten terug?

Meestal omvat één postcode één straat. Bij de uitzonderingen worden meerdere straten geretourneerd, zoals bij 2987 XS.

Voorlopig is het zo dat de gebruiker zelf een keus moet maken uit de straat. Wanneer we echter voldoende informatie middels de feedback methode hebben ontvangen kan op basis van het huisnummer een automatische keuze worden gemaakt.

Hoe gebruik ik jQuery met andere Javascript bibliotheken?

De Javascript voorbeelden gebruiken veelal de jQuery bibliotheek. Om Pro6PP te integreren in een website waar ook andere Javascript bibliotheken worden gebruikt (zoals Prototype, MooTools of YUI) is het raadzaam de jQuery documentatie over conflicten te volgen.

Hoe verleng ik mijn abonnement?

Door in te loggen op het Pro6PP CMS. De benodigde inloggegevens zijn reeds per e-mail verstrekt tijdens de aanmelding van het proefaccount.

Binnen het CMS worden onder kopje 'Overzicht' de lopende abonnementen getoond. Klik op de 'Verlengen' knop van het betreffende abonnement. Selecteer daar het gewenste type abonnement.

Tijdens het doorlopen van de stappen wordt om uw factuuradres gevraagd, de gewenste betaalmethode (iDeal, PayPal, handmatige bankoverschrijving of automatisch incasso) en zal u na de laatste stap de factuur per e-mail toegestuurd krijgen.

Hoe wordt ik geïnformeerd over het aflopen of verlengen van mijn abonnement?

14 dagen voor het verlopen van een (proef)abonnement wordt een herinnering verstuurd per email. Zonder actie te ondernemen loopt het abonnement na deze 2 weken automatisch af, er zijn geen verdere verplichtingen. Een verlopen abonnement kan op een later tijdstip altijd weer geactiveerd worden na betaling.

Om de dienstverlening echter te blijven gebruiken is het verstandig tenminste enkele dagen voor het verlopen een nieuwe betaling te doen binnen het Pro6PP CMS.
Sinds 2011 is hierbij automatisch incasso een mogelijkheid. In dat geval wordt geen herinneringsmail gestuurd maar wordt jaarlijks een nieuwe factuur opgestuurd en zal de dienstverlening jaarlijks worden verlengd tot de machtiging via het Pro6PP CMS wordt ingetrokken.

Verandert er wat bij het verlengen van een (proef)abonnement?

Nee, de situatie voor het gebruik van een proef-abonnement en het verlengen daarna brengt geen technische veranderingen met zich mee. De reeds verkregen auth_key wordt 'opgeladen' en gaat weer enige tijd mee.

Ik start met een standaard abonnement, maar wil binnenkort misschien al upgraden, kan dat?

Ja, een stapje hoger kan op elk moment en werkt altijd in uw voordeel. Dat wil zeggen: nu een standaard abonnement afsluiten voor 12 maanden, en over 1 maand willen overstappen naar een 'groot' abonnement geeft direct toegang tot de mogelijkehden van dit nieuwe 'groot' abonnement op het moment van upgraden. Er komt zoals bij elke verlenging 12 maanden looptijd bij (na het upgraden zijn er nog 23 maanden over).