add /epics-items

eth-library · Sep 11, 2024 · 7034579 · 7034579
1 parent b735c96
commit 7034579
Showing 1 changed file with 62 additions and 0 deletions.
diff --git a/geo-v1.yaml b/geo-v1.yaml
@@ -462,6 +462,68 @@ paths:
             description: bad request
           '500':
             description: server error
+  /epics-items:
+      get:
+        tags:
+          - Poi items
+        description: |-
+          Returns images from e-pics.
+        parameters:
+          - name: lat
+            schema:
+              type: number
+            in: query
+            required: false
+            description: |-
+              Returns the images near a point defined by lat (latitude) and lon (longitude) and optionally dist (distance) in metres (default: 1000).
+
+              Example: lat=47.349952
+          - name: lon
+            schema:
+              type: number
+            in: query
+            required: false
+            description: |-
+              Returns the images near a point defined by lat (latitude) and lon (longitude) and optionally dist (distance) in metres (default: 1000).
+
+              Example: lon=8.490838
+          - name: dist
+            schema:
+              type: number
+            in: query
+            required: false
+            description: |-
+              Returns the images near a point defined by lat (latitude) and lon (longitude) and optionally dist (distance) in metres (default: 1000).
+
+              Example: dist=1000
+
+          - name: q
+            schema:
+              type: string
+            in: query
+            required: false
+            description: |-
+              Returns the images for the search term (q).The parameter "q" is alternative to "lat"/"lon".
+
+              Example: q=uetliberg
+          - name: edges
+            schema:
+              type: boolean
+            in: query
+            required: false
+            description: |-
+              Should the edges/relations to contributors also be returned (default: true)?
+
+              Example: edges=false
+        responses:
+          '200':
+            description: Returns content items
+            content:
+              application/json: {}
+          '400':
+            description: bad request
+          '500':
+            description: server error
 
   /e-rara-maps:
     get: