Meedoen

Er ontbreekt iets. Waar hoort dat heen?

Bijna alles hoort niet bij ons, en dat is expres. Alleen een ontbrekende kéten heeft geen bovenliggende bron.

Vier gevallen, drie verschillende bestemmingen.
Wat er ontbreekt	Waar het heen gaat	Waarom daarheen
Een filiaal van een keten die we kennen	OpenStreetMap	Lost het voor iedereen op en komt via de normale bouw terug in de app
Een winkel die dicht is	OpenStreetMap	De enige route die sluitingen bij de bron oplost. Wij zien ze niet
Een keten of merk dat helemaal ontbreekt	Naar ons	Er is geen bovenliggende bron. Dit is de catalogus, en die is van ons
Eén losse zaak om de hoek	Nergens	Leg hem in de app vast als eigen punt. Dat werkt volledig en hoeft nergens heen

Een winkel die ontbreekt of dicht is

Voeg hem toe aan OpenStreetMap, met de editor op de site of met StreetComplete op je telefoon. Wat helpt: de merknaam precies zoals de keten hem schrijft, en het juiste winkeltype. Wij halen winkels op via de merkidentificatie van Wikidata, dus een correcte merktag komt aan.

In de tussentijd: leg hem zelf vast

Open je kaart bij de kassa terwijl er geen bekende winkel van die keten in de buurt is, en de app vraagt of je daar staat. Eén tik, en aankomstdetectie werkt er direct mee.

De coördinaten zijn het record; een adres is versiering. Zonder adres werkt alles.
Vastgelegde punten staan in hun eigen tabel, die de synchronisatie nooit aanraakt.
Ze krijgen voorrang boven de meegeleverde winkels bij het instellen van meldingen.
Komt de winkel later alsnog via OpenStreetMap binnen, dan wordt jouw punt overbodig gemaakt en niet verwijderd. Je krijgt te zien dat het aankwam.

Een keten die ontbreekt

De catalogus bevat 49 onderzochte Nederlandse ketens, waarvan 39 met een kaart. Mist er een, of klopt er een kleur of naam niet, dan is dat een echte fout; zes programma’s zijn in 2025 en 2026 hernoemd.

Stuur dit, of zoveel ervan als je weet:

{
  "key": "fitfun",
  "name": "Fit&Fun Ledenpas",
  "chain": "Fit&Fun",
  "aliases": ["Fit en Fun", "FitFun"],
  "colorHex": "#1D4E8F",
  "icon": "fitness_center",
  "preferredFormat": "CODE_128",
  "kind": "MEMBERSHIP",
  "confidence": { "color": "guess", "format": "guess" }
}

key — kort, kleine letters, uniek. Wij maken hem desnoods.
name is hoe het programma heet, chain hoe de winkel heet. Dat is vaak niet hetzelfde.
colorHex — de merkkleur, als je een bron hebt. Zonder bron liever niets dan een gok.
icon — een naam uit Material Symbols. De bouw weigert een naam die niet bestaat.
preferredFormat — alleen als je het écht weet. Bij 36 van de 49 ketens is dit een aanname, en daarom telt het alleen als hint voor met de hand ingetikte nummers.
kind — LOYALTY, VOUCHER of MEMBERSHIP. Een betaald abonnement is geen spaarkaart.
confidence — wees hier eerlijk. guess is een prima antwoord en veel bruikbaarder dan een verkeerde verified.

De vorm van een winkelrecord

Records zijn arrays op positie: bij ruim twaalfduizend records kosten veldnamen meer dan de gegevens zelf.

["ah", 52.38312, 4.88594, "Haarlemmerdijk 108", "1013JG", "Amsterdam"]
 ketensleutel, breedtegraad, lengtegraad, straat, postcode, plaats

Coördinaten staan op vijf decimalen, ongeveer een meter. Straat, postcode en plaats mogen leeg zijn; de coördinaten nooit.

Waar je het naartoe stuurt

Bij voorkeur een issue op de repository. Dat kost je geen mailadres, de JSON plakt als codeblok, en je kunt zelf zien wat ermee gebeurt.

Een issue openen

Liever mailen? hallo@square-management.nl. Een apart adres, nooit een persoonlijk. Een issue blijft beter, want daar kun je meelezen, maar niet iedereen wil een account op een codesite om een winkeladres door te geven.

Wat er gebeurt als je iets stuurt

Vanuit de app gaat een suggestie mee als bijlage bij een mail die jij verstuurt. Je ziet wat erin staat en kunt annuleren. De app verstuurt zelf niets en leert je adres nooit.
Eén item per bericht, nooit in bulk. Een bulkexport van al je vastgelegde winkels is een kaart van waar jij winkelt en wanneer.
Een suggestie voor de winkeldatabase kan gepubliceerd worden onder de ODbL. Dat staat in de app, op het moment van versturen.
Handmatige verwerking is prima tot ongeveer vijf à tien inzendingen per week.

Ben je een keten?

Wil je je naam, kleur of logo hier of in de app niet zien, dan halen we het weg. Eén bericht is genoeg. Wil je juist wél je echte logo getoond zien, dan vraagt dat schriftelijke toestemming, per stuk vastgelegd met bron en licentie.