Raw schema
{
"type": "object",
"properties": {
"where": {
"description": "UNDE — LOCAȚIE structurată: județ / oraș / localitate / stațiune. Ex. \"Brașov\", \"Bran\", \"Mamaia\". Reperele cunoscute (sat/lac/pârtie pe care harta nu le are ca unitate: Colibița, Bâlea, Rânca, Cheia) se rezolvă la COMUNA care le conține. OPȚIONAL. Nu pune aici facilități/experiențe sau nume de cazare; facilitățile/experiențele merg în `tokeni`, numele cazării merge în `nume`.",
"type": "string"
},
"near": {
"description": "„Lângă mine\" / în jurul unui punct. Alternativ cu where.",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"radius_km": {
"description": "Rază (implicit 10)",
"type": "number"
}
},
"type": "object",
"required": [
"lat",
"lng"
]
},
"nume": {
"description": "DOAR nume de cazare/proprietate/brand, ex. \"Hotel Studis\", \"Vila Maria\". Nu folosi pentru facilități, experiențe, stil sau caracter; acelea merg în `tokeni`.",
"type": "string"
},
"tokeni": {
"description": "Interfața standard pentru agenți: tokeni publici într-o singură listă. Ex. [\"ciubar\"], [\"lux\"], [\"spa\"], [\"piscina\"], [\"drumetii\"], [\"mare\",\"retras\"], [\"munte\",\"liniste\"], [\"urban\",\"gastronomie\"]. Pentru orice user intent/facilitate/experiență/stil folosește acest parametru, nu `nume`, `teme` sau `criterii`. Vezi capabilities().vocabular.tokeni.",
"items": {
"type": "string"
},
"type": "array"
},
"criterii": {
"description": "AVANSAT/legacy: ranking pe semnale interne. Pentru agenți AI, preferă `tokeni`. Vocabular: popularitate,liniste,natura,munte,apa,plaja,family,gastro,vin_crame,crame,cultura_istorie,cultura,nightlife,business,relaxare,urbanitate,izolare,magnetism,turism,afluenta,afluenta_turistica,anvergura,farmec,dezirabilitate,animat,cafea,plimbare,aproape_de_mare,aproape_de_aeroport,aproape_de_tren.",
"items": {
"type": "string"
},
"type": "array"
},
"teme": {
"description": "AVANSAT/legacy: filtre UI/SEO interne. Pentru agenți AI, preferă `tokeni`; o temă este intern un set de tokeni.",
"items": {
"type": "string"
},
"type": "array"
},
"sort": {
"description": "AVANSAT/legacy: o singură dimensiune de ranking când nu dai tokeni/criterii: popularitate | liniste | natura | … (vezi criterii). Pentru user intent folosește `tokeni`; pentru potrivire personală, serverul calculează dinamic `potrivire` când există intenție.",
"type": "string"
},
"limit": {
"description": "Câte pe pagină (implicit 10, max 30)",
"type": "integer"
},
"page": {
"description": "Pagina (implicit 1) — total arată câte corespund",
"type": "integer"
}
}
}