DrinkedIn Night Out

Plan a walkable 2-4 stop night out around a place using only venues DrinkedIn has validated against the venue's own site or an official register. Read-only and free. The most reliable input is a point: give latitude and longitude. Choose it from the user's context, never from a default: 'near me' is the user's current location; an area the user names (a neighbourhood or district) is the centre of that area; for a trip the user is planning, look up the destination they name (use its country to pick the right place) and give its coordinates. If the context holds no location, ask the user. With no coordinates, a free-text address or landmark in address also works: it is geocoded to one point and planned like coordinates (coordinates win if both are given). The text is sent to a public geocoding service (OpenStreetMap Nominatim), which ranks matches and does not confirm them: the reply's geocoded_as says what it matched, so confirm that with the person when the text was ambiguous. A place name also works when it identifies one place, so give it with its country or region; a name several places share returns needs_input with labelled choices: pick the one that fits the user's context and call again with its place_key or coordinates. Never guess between choices. Walking times are estimates (straight line x 1.3). Hours and prices are never asserted: tell the user to check with the venue (its own site when the stop has own_site). Say the plan is for adults of legal drinking age where they are; never state an age as a number. If the user says they are under the legal drinking age, do not call this tool. Show only the stops returned and add no venues, details or place names of your own.

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Optional free text: a street address, a landmark or the name of an area, used only when no latitude and longitude are given. It is geocoded to one point and planned like coordinates. The address is sent to a public geocoding service (OpenStreetMap Nominatim) to find the point. The reply echoes geocoded_as and geocoded_point with the notice address_geocoded: a match is a ranking, not a confirmation, so confirm it with the person when the text was ambiguous. No match is needs_input.",
      "maxLength": 200,
      "type": "string"
    },
    "budget": {
      "description": "Accepted but ignored: never used to filter or sort the route; prices are not known. The reply adds the notice budget_not_verifiable.",
      "type": "object"
    },
    "city": {
      "description": "City name. Add the country or state when several places share the name.",
      "maxLength": 80,
      "type": "string"
    },
    "country": {
      "description": "Country name or code; narrows a name several places share.",
      "maxLength": 40,
      "type": "string"
    },
    "exclude_ids": {
      "description": "venue_id values to leave out, to swap a stop.",
      "items": {
        "type": "integer"
      },
      "maxItems": 50,
      "type": "array"
    },
    "language": {
      "default": "en",
      "maxLength": 10,
      "type": "string"
    },
    "latitude": {
      "maximum": 90,
      "minimum": -90,
      "type": "number"
    },
    "longitude": {
      "maximum": 180,
      "minimum": -180,
      "type": "number"
    },
    "max_walk_m": {
      "default": 900,
      "maximum": 2000,
      "minimum": 200,
      "type": "integer"
    },
    "near": {
      "description": "What the point stands for, e.g. 'near me' or the area the user named. Echoed back as the route's 'near_as_given'; it is your label, not ours, and never changes the plan.",
      "maxLength": 80,
      "type": "string"
    },
    "party_size": {
      "description": "Informational only: does not change the route.",
      "minimum": 1,
      "type": "integer"
    },
    "place_key": {
      "description": "From a needs_input answer: names exactly one of its choices.",
      "maxLength": 120,
      "type": "string"
    },
    "region": {
      "description": "State or province, a name or a code such as a two-letter US state code; narrows a name several places share.",
      "maxLength": 40,
      "type": "string"
    },
    "start_time": {
      "description": "Local HH:MM. Informational only: does not change the route.",
      "maxLength": 10,
      "type": "string"
    },
    "stops": {
      "default": 3,
      "maximum": 4,
      "minimum": 2,
      "type": "integer"
    },
    "style": {
      "description": "Optional route shape, from the styles in drinkedin_get_guide. It limits which kinds of place the route uses and sets the default stops and walking limit; your own stops and max_walk_m win. It says nothing about hours, prices or atmosphere. Too few matching venues gives partial or no_coverage, never other kinds of place. The reply echoes style_applied.",
      "enum": [
        "bar_crawl",
        "craft_beer_crawl",
        "dinner_and_drinks",
        "club_night"
      ],
      "type": "string"
    },
    "vibes": {
      "description": "From drinkedin_get_guide. Vibes we cannot verify yet are noted, not applied.",
      "items": {
        "maxLength": 40,
        "type": "string"
      },
      "maxItems": 10,
      "type": "array"
    }
  },
  "additionalProperties": false
}

How to use the night-out planner: some places with validated venues (not a ranking and not a coverage claim), supported vibes, route styles, and the rules to follow when relaying a plan (validated venues only, no invented details, legal drinking age where they are). Read-only and free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}