AirTag data-export en API
AirTag locatiedata exporteren en API-integratie
TagLogger exporteert AirTag-geschiedenis als CSV of JSON en biedt een API, zodat de data terechtkomt in het ERP, CMMS, TMS of FSM waar je operatie echt op draait.
Wat TagLogger exporteert
- Huidige en historische locatie van elke gekoppelde AirTag (lat/lon + tijdstempel)
- Binnenkomst- en vertrekgebeurtenissen van geofences, met tijdstempel
- Rapporten van stilstaande assets: assets die binnen een instelbaar tijdvenster niet hebben bewogen
- Assetmetadata: naam, kleur, categorie, toegewezen team
- Activiteitenlogboek: het volledige gebeurtenislog per AirTag over elke gekozen periode
- Status “batterij bijna leeg” en de rapportagefrequentie van de AirTag
Exportformaten
CSV is het meest gebruikte exportformaat: compatibel met Excel, Google Sheets en vrijwel elk bedrijfssysteem. De CSV-export van TagLogger bevat per AirTag kolommen voor tijdstempel, breedtegraad, lengtegraad, assetnaam en de geofencegebeurtenissen die bij die rij horen.
JSON-export behoudt de volledige geneste structuur van de data, inclusief geofencemetadata, assetcategorie en gebeurtenistypen. JSON is handig om data rechtstreeks programmatisch in te lezen in scripts, datawarehouses en maatwerkintegraties.
Veelgebruikte integratiepatronen
- Dagelijkse CSV-snapshot: een geplande export die op een gedeelde schijf of in een ERP-map wordt gezet voor batchafstemming
- Wekelijks auditrapport: een CSV van stilstaande assets plus een activiteitenoverzicht voor de operationele review
- Geofencewebhook: TagLogger vuurt een HTTP-webhook af bij een geofencegebeurtenis en post naar een FSM- of TMS-endpoint
- Live API-polling: eigen dashboards of monitoringtools halen locatiedata op met een vaste frequentie (meestal elke 1–5 minuten)
- Gebeurtenisgestuurde automatisering: een webhook start de volgende stap in de workflow (Slack-meldingen, tickets aanmaken, voorraadcorrecties)
Integratiedoelen: ERP, CMMS, TMS, FSM
AirTag-locatiedata sluit aan op vier brede categorieën operationele software. De vorm van de integratie is overal vergelijkbaar: een geolocatieveld op een assetrecord, bijgewerkt volgens schema of via een webhook.
ERP: NetSuite, SAP, Oracle, Dynamics
Lees de AirTag-locatiegeschiedenis in als een eigen assetrecord met geolocatieveld, bijgewerkt via dagelijkse CSV-imports of de API. Veelvoorkomend gebruik: de fysieke assetlocatie vergelijken met de locatie die in het ERP staat.
CMMS: Maximo, eMaint, Fiix, UpKeep
Stuur de AirTag-locatie naar het locatieattribuut van de asset voor de planning van preventief onderhoud (de asset vinden voor onderhoud zonder de werkvloer af te lopen), en naar de assetkoppeling van werkorders, zodat monteurs naar de huidige locatie worden gestuurd.
TMS / WMS: Oracle TM, SAP TM, Blue Yonder, Manhattan
Geofencegebeurtenissen worden als statusupdates op zendingen gepost; de locatie van aanhangers en containers voedt de rapporten voor terreinbeheer.
FSM: ServiceTitan, Housecall Pro, Jobber, FieldEdge
De AirTag-locatie van servicevoertuigen en gereedschapssets voedt de planningsbeslissingen voor opdrachten; aankomstgebeurtenissen van geofences worden als automatische klantmeldingen gepost.
API-toegang: de basis
De API van TagLogger geeft programmatisch toegang tot dezelfde data als de webinterface. Authenticatie gaat via een API-sleutel, afgebakend per workspace. Veelgebruikte endpoints: AirTags opvragen, de laatste locatie van een AirTag ophalen, de locatiegeschiedenis van een AirTag over een periode ophalen, geofences en geofencegebeurtenissen opvragen en de in de workspace gedefinieerde taglabels lezen.
Voor polling met hoge frequentie komen de meeste integraties uit op elke 1–5 minuten, wat overeenkomt met de praktische updatefrequentie van het Zoek mijn-netwerk (Find My). Vaker pollen levert niet meer data op, omdat de onderliggende relayfrequentie de beperkende stap is.
Voor gebeurtenisgestuurde integraties zijn webhookabonnementen efficiënter dan polling. Abonneer je op binnenkomst-/vertrekgebeurtenissen van geofences en laat TagLogger naar je endpoint posten zodra een relevante gebeurtenis plaatsvindt.
AirTag API-snelstart: installeer een SDK en doe je eerste verzoek
TagLogger publiceert twee SDK’s voor zijn AirTag-data-API, één voor TypeScript en JavaScript en één voor Python. Installeer er een, maak een workspacesleutel aan onder Instellingen → API-sleutels en haal je tags op in een paar regels. De API-snelstart loopt elke stap door, en de API-referentie somt elk endpoint op.
- TypeScript of JavaScript: npm install @taglogger/sdk (npm-pakket). Draait op Node 18 of hoger en levert zijn eigen types mee.
- Python: pip install taglogger-sdk (PyPI-pakket). Draait op Python 3.9 of hoger zonder andere afhankelijkheden en importeer je als taglogger_sdk.
- API-sleutel: zet TAGLOGGER_API_KEY op een workspacesleutel met de scope read:tags. Authenticatie behandelt scopes en headers.
import os
from taglogger_sdk import TagLoggerClient
client = TagLoggerClient(api_key=os.environ["TAGLOGGER_API_KEY"])
page = client.tags.list(limit=50)
for tag in page["data"]:
print(tag["id"], tag["name"] or "")De TypeScript-SDK heeft dezelfde vorm: new TagLoggerClient({ apiKey }), dan client.tags.list({ limit: 50 }). Beide SDK’s dekken ook locatiegeschiedenis, geofences, webhooks en de controle van webhookhandtekeningen.
Veelvoorkomende export- en integratietoepassingen
- Auditrapporten: maandelijkse of kwartaalexports die het beheer en de verplaatsingen van assets laten zien voor interne of externe audits
- Verzekeringsdossiers: CSV-export van locatiegeschiedenis voor schadeclaims en diefstalzaken
- Factuurafstemming: de gevolgde assetlocatie vergelijken met gecontracteerde verhuurdata of servicebezoeken
- Automatische voorraadtelling: periodieke snapshots van de hele vloot naar voorraadbeheersystemen
- Compliancelogs: locatiegeschiedenis met tijdstempel voor wettelijke eisen (SOX-assetcontroles, HIPAA-apparaattracking)
- Eigen dashboards: gecombineerde weergaven van AirTag-data plus andere operationele data (ERP, CRM, telemetrie)
- Analysepipelines: AirTag-geschiedenis laden in BigQuery/Snowflake/Redshift voor analyse van assetbenutting
Beveiliging van exports en API-toegang
AirTag-locatiedata is waardevol: die laat zien waar assets (en vaak ook mensen) zijn en zijn geweest. Behandel export- en API-data met passend toegangsbeheer. Beperk API-sleutels tot de minimaal benodigde scope. Bewaar API-sleutels in een secrets manager, niet in platte configuratiebestanden. Log API-toegang voor audits.
Deel je CSV-exports extern (met schade-experts, politie, klanten bij een geschil), deel dan alleen het benodigde tijdvenster en de betrokken assets in plaats van een dump van de hele vloot. TagLogger ondersteunt juist hiervoor exports per asset en per periode.
Klanten in gereguleerde sectoren (zorg, financiële dienstverlening) laten de export-/API-data van TagLogger vaak via hun complianceplatform lopen in plaats van rechtstreeks naar de eindsystemen. Dat is een verstandig patroon dat het exportformaat van TagLogger ondersteunt.
Aan de slag met exports en de API
Begin met CSV-export. Dat vraagt geen ontwikkelwerk, werkt in elk spreadsheetprogramma en dekt de meeste audit- en afstemmingstoepassingen. De meeste TagLogger-klanten gebruiken CSV in hun eerste 3–6 maanden en stappen pas over op API-integratie als ze een concrete automatiseringsbehoefte tegenkomen.
Voor API-integratie is de geofencewebhook het praktische eerste doel, omdat die gebeurtenisgestuurde signalen geeft zonder pollinginfrastructuur. Een webhook-endpoint plus een paar regels logica automatiseert al een flink deel van de workflow (Slack-meldingen, tickets aanmaken, statusupdates) zonder volledige maatwerkintegratie.
Volledige ERP-/CMMS-integratie is een groter project en komt meestal later. Tegen de tijd dat die nodig is, zijn de operationele patronen rond AirTag-tracking goed bekend, en richt de integratie zich op specifieke datastromen in plaats van op “alles koppelen”.
Veelgestelde vragen
Breng AirTag-data naar de systemen waar je operatie op draait
CSV-export, JSON-export, API-toegang en webhooks, zodat de locatiegeschiedenis van AirTags je ERP, CMMS, TMS, FSM en eigen workflows voedt zonder datasilo’s.
