Afstandsberekening

Christiaan Sluis · ‎25-05-2023

Afstandsberekening

Zoals je hebt kunnen lezen zijn wij met HR Self Service in oktober vorig jaar overgestapt op here.com als nieuwe route leverancier. Dit om meer uniformiteit te krijgen in de berekeningen die we via de verschillende toepassingen gebruiken en om zuiverdere routes te krijgen. In onze aankondiging hebben wij ook geadviseerd om de berekening niet alleen op basis van postcode, maar ook huisnummer te gebruiken. Een postcode kan immers een groot gebied beslaan.

Helaas hebben we in de afgelopen maanden verschillende meldingen ontvangen, met name dat nieuwer toegevoegde adressen niet goed of niet onder de volledige postcode gevonden konden worden.

Locatiebepaling

In Nederland bestaat een publiekelijk register van het Kadaster: de Basisregistratie Adressen en Gebouwen (BAG). Daar staan alle erkende adressen binnen Nederland in. Wij halen deze gegevens binnen en stellen het beschikbaar voor HR Self Service en de Routechecker via een API. Dit is een grote kwaliteitsslag, omdat het BAG een locatiebepaling mogelijk maakt op basis van postcode + huisnummer én zelfs huisletter of huisnummer-toevoeging. Alleen een exacte overeenkomst levert dan resultaat op, waar here.com anders zonder foutmelding het dichtstbijzijnde adres teruggeeft. Deze locaties nemen wij mee in onze uitvraag bij here.com voor de afstandsberekening. Zie in bijlage 1 de werkwijze met voorbeelden.

Let op: de routebepaling verandert niet.

Vanavond om 18.00 uur zullen wij deze service activeren. Het kan gedurende enkele minuten leiden tot een vertraging van het systeem. Voor de zekerheid adviseren wij om je werk voor die tijd op te slaan.

Uit te voeren acties

Omdat het BAG zuivere adresgegevens bevat, kan dit niet worden gebruikt om puur op postcode te zoeken. Bij het opvragen van een postcode komt immers de gehele lijst aan adressen op die postcode naar voren. Om deze nieuwe functionaliteit te benutten dient dus gebruik gemaakt te worden van de functie “GF_DistanceBetweenForeignAddress” en niet “GF_DistanceBetweenNLZipCodes”. Deze functionaliteiten staan beschreven in de bijgewerkte Beheerdershandleiding in HR Self Service. Zoek hier op “afstandsberekening” of klik als je bent ingelogd op deze link. Lees deze goed voordat je aanpassingen doorvoert.

De werking is in grote lijnen hetzelfde, zij het dat functie ForeignAddress meer gegevens kan verwerken om tot een locatie te komen. Naast postcode zijn dat ook huisnummer, straatnaam, woonplaats en land. Ook binnen Nederland is de toevoeging van het huisnummer dus mogelijk om preciezer de locatie te bepalen.

Wij hebben onze controles uitgebreid om ook te controleren op huisnummer formaat. Indien dit onjuist is krijgt de gebruiker de volgende melding:

“Huisnummer formaat is onjuist. Huisnummer (met eventuele toevoegingen) geeft u als volgt op: 12A-01”

Om te bepalen waar je dit kunt aanpassen in je inrichting kun je het beste het Inrichtingsrapport downloaden, te vinden onder Beheer > Statistieken. Door in kolom N te zoeken op bovengenoemde functies, vind je de formulieren waar dit op staat. Voor declaraties met rekenbladen zit dit in de rekenbladen zelf, en zul je deze zelf moeten nalopen.

Enkele aandachtspunten bij de overstap:

Excel bladen kunnen maximaal 52 kolommen bevatten
ForeignAddress vereist ook Land, dit kan eventueel een vaste waarde (NL) zijn
In HRSS formulieren (niet Excel) kun je bewerkingen alleen aanpassen op formulieren waar geen actieve (niet-geëxporteerde) mutaties meer van zijn. Indien je geen sandbox hebt, kan je een kopie maken van het formulier om de aanpassingen door te voeren. Dit koppel je, eventueel met een kopie dialoog, aan een kopie workflow.

Maak je gebruik van Beaufort Online dan is het ook mogelijk om declaraties aan te bieden via Youforce App & Desktop. Dit is gemakkelijk in gebruik en inrichting. Op de link naar de community vind je de handleidingen en antwoorden op veelgestelde vragen.

Buitenlandse adressen

Voor buitenlandse adressen blijven we here.com gebruiken voor de locatiebepaling, omdat deze niet in het BAG domein vallen. Mocht je hier problemen mee ervaren dan kun je dit middels een ticket bij het Service Center melden. Vervolgens geven wij de locatie door aan here.com om bij te werken. Geef daarbij duidelijk op wat je ingeeft en waar je dit op de kaart zou moeten vinden. Dezelfde werkwijze geldt voor afstandsberekening binnen Nederland op alleen de postcodes. Wij dringen er met deze informatie bij onze leverancier op aan om dit spoedig te verwerken, maar wij hebben hier geen directe invloed op.

Bijlage 1: Werkwijze met voorbeelden

Het format moet dan worden opgegeven als [huisnummer][huisletter]-[huisnummertoevoeging]: 12A-1. Alles na de - zien wij als toevoeging. Dit omdat binnen het BAG blijkt dat er verschillende formats worden gehanteerd.

Enkele voorbeelden ter verduidelijking van de resultaten. We hanteren postcode 2031CN vanwege de diversiteit in vastleggingen op deze postcode.

Opgave huisnummer	Resultaten BAG	Resultaat HRSS	Toelichting
24	-	Foutmelding	Adres bestaat niet
25	25A, 25B, 25C	25A	3 resultaten op basis van extra huisletter, eerste wordt gebruikt*
27	27, 27B-0001, 27B-0002,......, 27C, 27D, ….	27	Enige exacte resultaat
27B	27B, 27B-0001, 27B-0002, 27B-0003,...	27B	Enige exacte resultaat
27B-0001	27B-0001	27B-0001	Enige exacte resultaat
21	21-23	21-23	1 resultaat op basis van huisnummer, eerste wordt gebruikt**
21-23	21-23	21-23	Enige exacte resultaat
22	-	Foutmelding	Adres bestaat niet
23	-	Foutmelding	Adres bestaat niet

* Op basis van de opgegeven data vinden we de overeenkomst in de tabel bij huisnummer 25, in dit geval met huisletter A. We vereisen niet de huisletter erbij omdat we erkennen dat dit lang niet altijd relevant is (bijvoorbeeld bij een appartementencomplex).

Wij hanteren deze werkwijze omdat in de database altijd, indien aanwezig, het huisnummer zonder enige toevoeging bovenaan staat.

** Vergelijkbaar met bovenstaande, maar dan de niet-verplichte toevoeging in plaats van huisletter.

MarvinTergooi · ‎25-05-2023

@Christiaan Sluis

Door drukte heb ik de vooraankondiging gemist. Ik stap graag over naar de berekening op volledig adres maar dat ga ik vanmiddag niet meer redden. Blijft de GF_DistanceBetweenNLZipCodes nog wel werken na18.00 uur? Dat kan ik hier niet uit opmaken.

Ps. in het artikel van 18-10-2022 staat Er is geen verdere actie nodig, alles blijf werken zoals voorheen. Dat zal de reden zijn dat ik geen actie heb ondernomen destijds.

Christiaan Sluis · ‎25-05-2023

Beste @MarvinTergooi,

De GF_DistanceBetweenNLZipCodes blijft ongewijzigd werken. Er is alleen een actie nodig op het moment dat je gebruikt wilt maken van een exactere locatiebepaling (Van en Naar), of als je merkt dat er binnen de organisatie adressen niet gevonden kunnen worden op postcode alleen. Dan is de overstap naar GF_DistanceBetweenForeignAddress de oplossing, die wij overigens iedereen aanraden. Een reis van postcode naar postcode geeft veel ruimte voor interpretatie van de locatie, en van adres (obv postcode + huisnummer) is een precies punt.

Petra Gijse1 · ‎26-05-2023

Wij krijgen na gisteren opeens de volgende foutmelding:

Er is een foutmelding opgetreden bij het berekenen van deze afstand. Huisnummer formaat is onjuist. Huisnummer (met eventuele toevoegingen) geeft u als volgt op: 12A-01.

Dit bij iedereen ook al is er geen toevoeging van het huisnummer.

Is dit een bekend probleem? heb ook een incident melding aangemaakt.

Christiaan Sluis · ‎26-05-2023

Beste @Petra Gijse1

Allereerst: jammer om te horen dat dit jullie ervaring is. Er is hier geen algemeen probleem van: het systeem werkt zoals het moet. Wij zullen het incident analyseren en daarop reageren.

Gerda Woldring · ‎31-05-2023

@Christiaan Sluis

Een afstandsberekening van postcode naar postcode valt vanaf mei 12,18 km lager uit dan dezelfde berekening die in april van dezelfde postcode naar dezelfde postcode is aangeleverd.

Is dit een bekend probleem?

We hebben hier een incident melding voor aangemaakt.

Christiaan Sluis · ‎31-05-2023

Dag @Gerda Woldring,

Aan de werking van postcode naar postcode is niets veranderd. De routebepaling wordt in alle gevallen gedaan op basis van de snelste route, zonder actueel verkeer mee te nemen. Het kan zijn dat door (tijdelijke) wegafsluitingen en wijzigingen in wegen er een verschil ontstaat. Bijvoorbeeld als een weg alleen nog eenrichtingsverkeer toestaat, of als er een nieuwe weg is aangelegd. Dit zullen we vanuit de melding gaan bekijken.

Ons advies is wel om de overstap te maken naar een postcode + huisnummer, omdat berekeningen op alleen postcodes geen duidelijk start- en eindpunt hebben.

Paul Wevers - Ikazia · ‎05-06-2023

Hoi @Christiaan Sluis,

Wij hebben hetzelfde probleem als @Petra Gijse1.

Ik zal ook een melding bij de Servicedesk aanmaken.

Groet,

Paul

Lonneke van der Aar · ‎05-06-2023

Goedemorgen,

Maakt het uit welke volgorde je gebruikt in het javascript? Zo ja, welke is de juiste?

In de uitleg zie ik 2 verschillende volgordes: (de plek van straat en huisnr wisselt)

GF_DistanceBetweenForeignAddress (Postcode van, Huisnr van, Straat van, Stad van, Land van, Postcode tot, Huis No tot, Straat naar, Stad naar, Land naar, Retour).

en

var a = GF_DistanceBetweenForeignAddress(v_PCVAN#, v_STRAATVAN#, v_HUISNRVAN#, v_STADVAN#, v_LANDVAN#, v_PCTOT#, v_STRAATTOT#, v_HUISNRTOT#, v_STADTOT#, v_LANDTOT#, v_INDRETOUR#);

Christiaan Sluis · ‎05-06-2023

Hoi @Lonneke van der Aar,

Heel scherp gezien. Dat is een fout die we morgen gaan corrigeren. Deze zit er schijnbaar al lang in, en gaf onder here.com geen foutmelding omdat de hele informatiestring werd doorgestuurd in plaats van een exact adres in een bepaald format te zoeken.

De juiste werking is eerste:

GF_DistanceBetweenForeignAddress (Postcode van, Huisnr van, Straat van, Stad van, Land van, Postcode tot, Huis No tot, Straat naar, Stad naar, Land naar, Retour).

Het andere is een voorbeeld, waar het inderdaad goed had moeten staan. Dit is wellicht ook de reden van een aantal onjuiste implementaties bij organisaties.

TvanOudenaarden · ‎27-06-2023

@Christiaan Sluis
Ik ben bezig om GF_DistanceBetweenForeignAddress (Postcode van, Huisnr van, Straat van, Stad van, Land van, Postcode tot, Huis No tot, Straat naar, Stad naar, Land naar, Retour), in te richten op het formulier adreswijziging.
Waar ik tegenaanloop is wanneer ik het voorbeeld van hierboven 27B-0001 gebruik, ik een foutmelding ontvang.
Ik kan B-00001 namelijk niet kwijt als toevoeging, omdat P01018 maar 5 tekens toelaat. Wanneer ik B0001 invoer zie ik in dat geval de melding : Er is een foutmelding opgetreden bij het berekenen van deze afstand. Huisnummer formaat is onjuist. Huisnummer (met eventuele toevoegingen) geeft u als volgt op: 12A-01. B-0001 kan ik niet kwijt bij toevoeging en ik kan de lengte van P01018 ook niet aanpassen, niet in HR Core online en niet in Youforce - want die wordt overschreven.

Heeft iemand een tip?

Christiaan Sluis · ‎29-06-2023

Beste @TvanOudenaarden,

Als je rechtstreeks de Beaufort rubriek voor huisnummer toevoeging (P01018) gebruikt dan kan je hier tegenaan lopen. In praktijk zien we dat dit weinig gebruikt wordt als input voor de afstandsberekening (immers moet je bij de Beaufort rubrieken zelf eerst dit samenvoegen tot 1 "Huisnr van"). Vanwege de centrale plek in de Beaufort database is het momenteel niet mogelijk om de rubriek uit te breiden.

Het voorbeeld met B-0001 is natuurlijk een extreem voorbeeld, waar je vaak iets korter ziet (of zelfs geen toevoeging). Mocht het wel voorkomen dan kan je overwegen om een conditionele toevoeging te gebruiken, dat bij een lengte >4 je kiest om dit niet toe te voegen aan je "Huisnr van". Of dat je een extra rubriek toevoegt voor de PSA gebruiker met afwijkende Toevoeging, en dat als die gevuld is dat dan die waarde gebruikt wordt in plaats van de P01018.

Beiden zijn niet ideaal, maar we moeten het natuurlijk ook wel in perspectief plaatsen hoe vaak dit aan de orde is.

Ik hoop dat je er iets mee kan.

Afstandsberekening