Auslastungsdaten Doku

Wie können Auslastungen aus der BCT abgefragt werden

Überblick

Diese Dokumentation erklärt, wie Sie Auslastungsdaten über die BayernCloud API abrufen können. Der Endpunkt "list_occupancy" liefert alle Auslastungsobjekte zurück.

Detaillierte Informationen finden Sie in der offiziellen API-Dokumentation:

BayernCloud API Dokumentation

Auslastungsobjekte

Auslastungsobjekte sind zum aktuellen Zeitpunkt:

Auslastungen

Anzahl der Personen am aktuellen POI

Parkauslastungen

Anzahl der parkenden Fahrzeuge am POI

Personenzähler

Anzahl der Personen, die einen Wegpunkt überschritten haben

Auslastungsobjekte selbst haben keine Geoinformationen, sondern sind mit einem POI verknüpft. Der POI enthält alle weiteren Informationen, einschließlich Geokoordinaten.

Standorte von Auslastungsobjekten

Diese Karte zeigt die Standorte aller Auslastungsobjekte:

So binden Sie ein solches Kartenwidget auch auf Ihrer Seite ein: Kartenwidget Dokumentation

API Beispiele

Abfrage mit verknüpften Inhalten:

GET https://data.bayerncloud.digital/api/v4/endpoints/list_occupancy?include=about

Abfrage mit eingeschränkten Feldern:

GET https://data.bayerncloud.digital/api/v4/endpoints/list_occupancy?fields=name,capacity,dcls:currentOccupancy,about.geo.longitude,about.geo.latitude,cc:license,copyrightNotice

Beispielantwort:

{
  "@id": "ded054a7-489e-4401-8d78-6795a9cbc48a",
  "@type": [
    "Intangible",
    "dcls:ParkingCapacity"
  ],
  "name": "Parkplatz Kesselberg Nord - Kochel am See",
  "about": [
    {
      "@id": "d2383651-7c8d-47b1-a1bd-1668754b7599",
      "@type": [
        "Place",
        "TouristAttraction",
        "dcls:POI"
      ],
      "geo": {
        "@id": "d2383651-7c8d-47b1-a1bd-faa901a895b5",
        "@type": "GeoCoordinates",
        "longitude": 11.35266,
        "latitude": 47.62464
      }
    }
  ],
  "dcls:currentOccupancy": 19,
  "cc:license": "https://creativecommons.org/publicdomain/zero/1.0/"
}

Zeitreihen einschränken

Sie können die Timeseries über einen Parameter einschränken:

GET https://data.bayerncloud.digital/api/v4/things/ded054a7-489e-4401-8d78-6795a9cbc48a/dcls_occupancy?time[in][min]=2023-11-04T00:00Z&time[in][max]=2023-11-27T23:55Z

Pagination

Die API unterstützt Pagination für große Datenmengen:

Die Gesamtanzahl wird im meta.total Attribut zurückgegeben.
Die Anzahl der Seiten finden Sie im meta.pages Attribut.
Links zur nächsten und vorherigen Seite sind im links Attribut enthalten.

Beispielantwort mit Pagination:

{
  "meta": {
    "total": 6963,
    "pages": 279,
    "collection": {
      "id": "36a736f7-9e2d-4be5-b0f0-45ada2ff7013",
      "name": "Aktuelle Open Data Veranstaltungen",
      "slug": "list_current_events"
    }
  },
  "links": {
    "next": "https://data.bayerncloud.digital/api/v4/endpoints/36a736f7-9e2d-4be5-b0f0-45ada2ff7013?page%5Bnumber%5D=2&page%5Bsize%5D=25"
  }
}

Tipps zur Verwendung der Pagination

1. Rufen Sie zunächst den Endpunkt ab, um die Gesamtanzahl zu erhalten:

GET https://data.bayerncloud.digital/api/v4/endpoints/list_occupancy

2. Rufen Sie dann den Gesamtbestand ab oder blättern Sie seitenweise durch:

GET https://data.bayerncloud.digital/api/v4/endpoints/list_occupancy?page[size]=191

GET https://data.bayerncloud.digital/api/v4/endpoints/list_occupancy?page[number]=2&page[size]=25