From e79b3f6852fbb929fbce3635f54eb1a74ee75b2b Mon Sep 17 00:00:00 2001
From: Birte Kristina Friesel <derf@finalrewind.org>
Date: Mon, 19 Aug 2024 19:35:42 +0200
Subject: [PATCH] HAFAS(3pm): get_service: Document coverage and homepage keys

---
 lib/Travel/Status/DE/HAFAS.pm | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/lib/Travel/Status/DE/HAFAS.pm b/lib/Travel/Status/DE/HAFAS.pm
index 3190bac..0a4d0e4 100644
--- a/lib/Travel/Status/DE/HAFAS.pm
+++ b/lib/Travel/Status/DE/HAFAS.pm
@@ -1124,18 +1124,29 @@ nothing otherwise. The hashref contains the following keys.
 
 =over
 
-=item B<name> => I<string>
+=item B<coverage> => I<hashref>
 
-service name, e.g. Bay Area Rapid Transit or Deutsche Bahn.
+Area in which the service provides near-optimal coverage. Typically, this means
+a (nearly) complete list of departures and real-time data. The hashref contains
+two optional keys: B<area> (GeoJSON) and B<regions> (list of strings, e.g. "DE"
+or "CH-BE").
 
-=item B<mgate> => I<string>
+=item B<homepage> => I<string>
 
-HAFAS backend URL
+Homepage URL of the service provider.
 
 =item B<languages> => I<arrayref>
 
 Languages supported by the backend; see the constructor's B<language> argument.
 
+=item B<name> => I<string>
+
+Service name, e.g. Bay Area Rapid Transit or Deutsche Bahn.
+
+=item B<mgate> => I<string>
+
+HAFAS backend URL
+
 =item B<productbits> => I<arrayref>
 
 MOT bits supported by the backend. I<arrayref> contains either strings
-- 
GitLab