app_abfallplus_de add note that city can be initial street letter

custom_components/waste_collection_schedule/waste_collection_schedule/service/AppAbfallplusDe.py

@@ -589,7 +589,8 @@ class AppAbfallplusDe:
     def select_street(self, street=None):
         if street:
             self._strasse_search = street
-        for street in self.get_streets():
+        streets = self.get_streets()
+        for street in streets:
             if compare(street["name"], self._strasse_search):
                 self._f_id_strasse = self._strasse_id = street["id"]
                 if street["id_kommune"] is not None:
@@ -598,7 +599,9 @@ class AppAbfallplusDe:
                     self._bezirk_id = street["id_beirk"]
                 self._hnrs = street["hrns"]
                 return
-        raise Exception(f"Street {self._strasse_search} not found.")
+        raise Exception(
+            f"Street '{self._strasse_search}' not found., available: {streets}"
+        )
 
     def get_hrn_needed(self) -> bool:
         return self._hnrs

doc/source/app_abfallplus_de.md

@@ -27,6 +27,8 @@ waste_collection_schedule:
 **city**  
 *(String) (optional)*
 
+If you need to select a first letter of you street name, you can use the city argument to provide the first letter of your city name. (e.g. A for Bonn Orange)
+
 **strasse**  
 *(String) (required)*
 
@@ -62,6 +64,7 @@ waste_collection_schedule:
     - name: app_abfallplus_de
       args:
         app_id: de.k4systems.bonnorange
+        city: A
         strasse: Auf dem Hügel
         hnr: 6
 ```