Input schema (JSON)
{
"type": "object",
"$defs": {
"ApiDiet": {
"oneOf": [
{
"enum": [
"vegan"
],
"type": "string"
},
{
"type": "string",
"const": "vegetarian",
"description": "Vegetarian, vegan dishes included."
}
],
"description": "A diet as a menu marks a dish, or the dish's name says it."
},
"ApiLang": {
"enum": [
"de",
"en"
],
"type": "string",
"description": "The language dish names, descriptions and section titles come in: the menus' own\nGerman, or English as bissl translated them."
},
"DishKind": {
"enum": [
"food",
"drinks"
],
"type": "string"
},
"DishSort": {
"oneOf": [
{
"type": "string",
"const": "recommended",
"description": "The best matches at the most useful places: with prices, open now, near the middle."
},
{
"type": "string",
"const": "match",
"description": "Best match first, then cheapest."
},
{
"type": "string",
"const": "price",
"description": "Cheapest first."
},
{
"type": "string",
"const": "distance",
"description": "Best match first, then nearest to `lat`, `lon` - the order whenever they are given,\nunless `price`."
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": [
"string",
"null"
],
"description": "Words a dish must match, as people say them, German or English: \"schnitzel\", \"vegan\ncurry\", \"glutenfreie pizza\". A diet, allergens or a cuisine among them are taken as\nfilters; misspelt German words are put right when that finds something."
},
"lat": {
"type": [
"number",
"null"
],
"format": "double",
"description": "The latitude of a point - the user's, or one they name - to measure distances from\nand sort nearest first; with `lon`."
},
"lon": {
"type": [
"number",
"null"
],
"format": "double",
"description": "The longitude of that point; with `lat`."
},
"bbox": {
"type": [
"string",
"null"
],
"description": "Keep to a map area: \"west,south,east,north\" in degrees - a town, a district, the\nstreets around a place. Everywhere when left out."
},
"diet": {
"anyOf": [
{
"$ref": "#/$defs/ApiDiet"
},
{
"type": "null"
}
],
"description": "Only dishes of this diet: vegan, or vegetarian (vegan dishes included)."
},
"lang": {
"anyOf": [
{
"$ref": "#/$defs/ApiLang"
},
{
"type": "null"
}
],
"description": "The language of dish names, descriptions and section titles: de, the menus' own, or\nen, as bissl translated them."
},
"sort": {
"anyOf": [
{
"$ref": "#/$defs/DishSort"
},
{
"type": "null"
}
],
"description": "The order of the places."
},
"limit": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Places to answer with: 1 to 30, 10 when left out."
},
"offset": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Places to skip, for the next ones: 0 when left out."
},
"cuisine": {
"type": [
"string",
"null"
],
"description": "Only at places of this cuisine, as OpenStreetMap names it: \"italian\", \"vietnamese\"."
},
"free_of": {
"type": [
"string",
"null"
],
"description": "Only dishes whose menu lists their allergens and none of these letters: \"A\" gluten,\n\"G\" milk, \"AG\" both."
},
"open_now": {
"type": [
"boolean",
"null"
],
"description": "Only places open right now."
},
"dish_kind": {
"anyOf": [
{
"$ref": "#/$defs/DishKind"
},
{
"type": "null"
}
],
"description": "Food or drinks only."
},
"max_price": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Only dishes costing at most this much, in whole euros."
},
"min_price": {
"type": [
"integer",
"null"
],
"format": "int64",
"description": "Only dishes costing at least this much, in whole euros."
}
},
"additionalProperties": false
}