From a49237d411125bf006703d89bb60897ba0251e3f Mon Sep 17 00:00:00 2001 From: Damian Date: Fri, 23 Oct 2026 11:55:48 +0200 Subject: [PATCH] "Enhance `MeetingPoint` schema: add `mapsUrl` with description and example, refine `name` and `instructions` descriptions for clarity; update `booking-confirmed` example accordingly." --- components/schemas/MeetingPoint.yaml | 13 ++++++++++--- examples/booking-confirmed.yaml | 4 +++- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/components/schemas/MeetingPoint.yaml b/components/schemas/MeetingPoint.yaml index 3e00781..acde8c9 100644 --- a/components/schemas/MeetingPoint.yaml +++ b/components/schemas/MeetingPoint.yaml @@ -4,8 +4,9 @@ required: [name] properties: name: type: string - description: Short human-readable name. - example: "Hyakumanben Chion-ji Temple" + description: >- + Short human-readable name. For a guest pickup it reads "Pickup at your accommodation". + example: "〒600-8012 Kyoto" address: type: string description: Formatted address line. @@ -22,4 +23,10 @@ properties: example: 135.7807599 instructions: type: string - description: Free-text guidance for finding the meeting spot. + description: Free-text guidance from the host for finding the meeting spot. + example: "Wait at the main gate" + mapsUrl: + type: string + format: uri + description: Link that opens the meeting spot in Google Maps. Present whenever `lat` and `lon` are present. + example: "https://www.google.com/maps/search/?api=1&query=35.0298797,135.7807599" diff --git a/examples/booking-confirmed.yaml b/examples/booking-confirmed.yaml index ecfdc0c..4b368cf 100644 --- a/examples/booking-confirmed.yaml +++ b/examples/booking-confirmed.yaml @@ -11,10 +11,12 @@ value: cancellationDeadline: "2026-07-08T08:00:00Z" createdAt: "2026-05-28T13:42:11Z" meetingPoint: - name: "Café Brecht" + name: "Weteringschans 157" address: "Weteringschans 157, 1017 SE Amsterdam, Netherlands" lat: 52.3617 lon: 4.8907 + instructions: "At the terrace tables, look for the host with the Withlocals sign" + mapsUrl: "https://www.google.com/maps/search/?api=1&query=52.3617,4.8907" tourLanguage: "en" mainGuest: firstName: "Anna"