feat: NAV-5430 Schema api /direct_stop_points (#4528)

* feat: NAV-5430 Schema api /direct_stop_points

* Fix lint

* Fix build

* Apply suggestion from @remi-lucas-hove

Author: remi-lucas-hove

source/jormungandr/jormungandr/interfaces/v1/direct_stop_points.py

@@ -0,0 +1,52 @@
+# Copyright (c) 2001-2026, Hove and/or its affiliates. All rights reserved.
+#
+# This file is part of Navitia,
+#     the software to build cool stuff with public transport.
+#
+# Hope you'll enjoy and contribute to this project,
+#     powered by Hove (www.hove.com).
+# Help us simplify mobility and open public transport:
+#     a non ending quest to the responsive locomotion way of traveling!
+#
+# LICENCE: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# Stay tuned using
+# twitter @navitia
+# channel `#navitia` on riot https://riot.im/app/#/room/#navitia:matrix.org
+# https://groups.google.com/d/forum/navitia
+# www.navitia.io
+
+from jormungandr.interfaces.v1.ResourceUri import ResourceUri
+from jormungandr.interfaces.v1.serializer.direct_stop_points import DirectStopPointsSerializer
+
+
+class DirectStopPoints(ResourceUri):
+    def __init__(self, *args, **kwargs):
+        ResourceUri.__init__(self, output_type_serializer=DirectStopPointsSerializer, *args, **kwargs)
+        parser_get = self.parsers["get"]
+        parser_get.add_argument(
+            "stop_point_id",
+            type=str,
+            required=True,
+            help="Id of the stop point from where we want to access others stop points",
+        )
+        parser_get.add_argument(
+            "line_id", type=str, required=True, help="Id of the line from where we want to access stop points"
+        )
+
+    def options(self, **kwargs):
+        return self.api_description(**kwargs)
+
+    def get(self, region=None, lon=None, lat=None, uri=None):
+        pass

source/jormungandr/jormungandr/interfaces/v1/serializer/direct_stop_points.py

@@ -0,0 +1,70 @@
+# Copyright (c) 2001-2026, Hove and/or its affiliates. All rights reserved.
+#
+# This file is part of Navitia,
+#     the software to build cool stuff with public transport.
+#
+# Hope you'll enjoy and contribute to this project,
+#     powered by Hove (www.hove.com).
+# Help us simplify mobility and open public transport:
+#     a non ending quest to the responsive locomotion way of traveling!
+#
+# LICENCE: This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# Stay tuned using
+# twitter @navitia
+# channel `#navitia` on riot https://riot.im/app/#/room/#navitia:matrix.org
+# https://groups.google.com/d/forum/navitia
+# www.navitia.io
+
+from __future__ import absolute_import
+import serpy
+from jormungandr.interfaces.v1.serializer import jsonschema
+
+
+accessible_stop_point_schema = {
+    "type": "object",
+    "properties": {
+        "id": {"type": "string"},
+    },
+}
+
+direct_stop_points_result_schema = {
+    "type": "object",
+    "properties": {
+        "from_stop_point_id": {"type": "string"},
+        "accessible_stop_points": {
+            "type": "array",
+            "items": accessible_stop_point_schema,
+        },
+    },
+}
+
+
+class AccessibleStopPointSerializer(serpy.DictSerializer):
+    id = serpy.StrField(display_none=True)
+
+
+class DirectStopPointsResultSerializer(serpy.DictSerializer):
+    from_stop_point_id = serpy.StrField(display_none=True)
+    accessible_stop_points = AccessibleStopPointSerializer(many=True, display_none=True)
+
+
+class DirectStopPointsSerializer(serpy.DictSerializer):
+    direct_stop_points = jsonschema.MethodField(
+        schema_metadata=direct_stop_points_result_schema,
+        display_none=True,
+    )
+
+    def get_direct_stop_points(self, obj):
+        return DirectStopPointsResultSerializer(obj.get('direct_stop_points', {})).data

source/jormungandr/jormungandr/modules/v1_routing/v1_routing.py

@@ -56,6 +56,7 @@
     opg_status,
     opg_excluded_zones,
     backends_status,
+    direct_stop_points,
 )
 from werkzeug.routing import BaseConverter, FloatConverter, PathConverter
 from jormungandr.modules_loader import AModule
@@ -376,5 +377,11 @@ def setup(self):
             endpoint='obstacles_nearby',
         )
 
+        self.add_resource(
+            direct_stop_points.DirectStopPoints,
+            region + 'direct_stop_points',
+            endpoint='direct_stop_points',
+        )
+
         self.add_resource(users.User, "/users", endpoint='users')
         self.add_resource(JSONSchema.Schema, '/schema', endpoint="schema")