awv-api
TypeScript icon, indicating that this package has built-in type declarations

0.0.63 • Public • Published

AWV-API

npm package MIT last commit downloads week downloads total size dependencies

Npm publish Build status Quality Gate Bugs Coverage Code Smells Duplicated Lines (%) Maintainability Rating Reliability Rating Security Rating Technical Debt Vulnerabilities

Abfallwirtschaft Vechta - API

Disclaimer

This is not an official package from the "Abfallwirtschaft Vechta". It is only an API by parsing the informations from the website.

About

Since https://www.abfallwirtschaft-vechta.de/ is not offering an open and simple api for their calendar of trash-pickup dates was this package created. It offers a possibility to download all trash-pickup events for a specific year, downloading all cities and streets and puts them in a nice object.

Installation

npm install awv-api

Usage

import {AwvAPI} from "awv-api";

const allCities = await AwvAPI.downloadAllCities(year);
//or any other Function

Models

City

city.id : number // the id of the city
city.label : string // the display name of the city
city.value : string // the name of the city
city.getStreets() : Street[] // returns all associated streets

Street

street.id : number // the id of the street
street.label : string // the display name of the city
street.value : string // the name of the city
street.pamo: string // the district for pamo, 0 if not available
street.siemer: string // the district for siemer, 0 if not available
street.abfuhrbezirk: string // the district for the normal
street.getEvents() : Event[] // returns all associated events

Event

event.date: string // the date as String DD.MM.YYYY when the event happens
event.label: string // the trash which gets picked up
event.provider: string // the name of the provider

Provider

An enum:

VECHTA = 'AVZ Vechta'
SIEMER = 'Siemer'
PAMO = 'Pamo'

Documentation

params:

  • year: number (for example: 2021)
  • city: City (see /models/City.ts)
  • street: Street (see /models/Street.ts)
  • event: Event (see /models/Event.ts)

functions

  • AwvAPI.downloadAllCitiesAndStreetsAndEvents(year)

    • Downloads all cities and streets and events as a list of cities
  • AwvAPI.downloadAllCitiesAndStreets(year)

    • Downloads all cities and streets
  • AwvAPI.downloadAllCities(year)

    • Downloads all cities
  • AwvAPI.downloadAllStreetsForCity(year, city)

    • Downloads all streets for a city
  • AwvAPI.downloadEventsForStreet(year, city, street)

    • Downloads all events for a specific street in a city

Contributors

Contributors

Readme

Keywords

Package Sidebar

Install

npm i awv-api

Weekly Downloads

6

Version

0.0.63

License

MIT

Unpacked Size

77 kB

Total Files

37

Last publish

Collaborators

  • nilsbaumgartner1994