realty.yandex.ru

ResolveEntities

Нормализует гео-объекты перед вызовом search: города, регионы, районы, улицы, дома, ЖК, застройщиков, метро, линии метро, шоссе, ж/д станции, топонимы и границы (МКАД, КАД), POI и ориентиры (парки, ТЦ, школы). Возвращает варианты с названиями, адресами, типами, scope и searchParams. Страницу не меняет. Передавай массив requests. В каждом объекте: - text — название гео-объекта или ориентира из запроса пользователя; - types — возможные типы сущности (необязательно, без ограничения — все типы); - rgid — известный ID региона (необязательно, без него поиск по всем регионам). Типы для поиска: - GEO — регионы, города, районы, топонимы, неформальные гео-объекты и границы; - METRO — станции и линии метро, включая строящиеся станции; - HIGHWAY — шоссе; - STREET — улицы; - HOUSE — дома; - NEWBUILDING — жилые комплексы; - DEVELOPER — застройщики; - RAILWAY_STATION — ж/д станции и вокзалы; - POI — конкретные места: парки, ТЦ, школы, памятники, достопримечательности. Сначала нормализуй город или регион отдельным запросом без rgid и получи его rgid из searchParams. Затем ищи остальные объекты с этим rgid. Не придумывай ID и не подставляй ID Яндекс.Карт вместо ID Недвижимости. При известном регионе не добавляй его в text: «улица Ленина» с rgid Санкт-Петербурга, а не «улица Ленина, Санкт-Петербург». Возвращает полный ответ ResolveEntitiesV2 без изменения структуры. responses соответствует requests по порядку. В каждом элементе responses находится result: - При result.$case = "response" варианты находятся в result.response.entries. - При result.$case = "emptyResponse" сообщение находится в result.emptyResponse.message. Из entries выбери не более одного варианта для каждого пользовательского гео-объекта: наиболее подходящий или ничего. При неоднозначности уточни у пользователя. Не смешивай варианты разных одноимённых объектов. Переноси значения из searchParams выбранного варианта в инструмент search: - rgid — в параметр rgid верхнего уровня; - остальные поля (districtId, toponymId, m…

Input schema

{
  "additionalProperties": false,
  "properties": {
    "requests": {
      "description": "Гео-объекты для нормализации. Ответы возвращаются в том же порядке.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "rgid": {
            "description": "Известный ID региона. Если не передан, поиск производится по всем регионам.",
            "pattern": "^[1-9][0-9]{0,18}$",
            "type": "string"
          },
          "text": {
            "description": "Название объекта. Не добавляй название региона, если передаёшь rgid.",
            "maxLength": 1000,
            "minLength": 1,
            "pattern": "\\S",
            "type": "string"
          },
          "types": {
            "description": "Возможные типы объекта. Если не переданы, поиск по всем типам.",
            "items": {
              "enum": [
                "GEO",
                "METRO",
                "HIGHWAY",
                "STREET",
                "HOUSE",
                "NEWBUILDING",
                "DEVELOPER",
                "RAILWAY_STATION",
                "POI"
              ],
              "type": "string"
            },
            "maxItems": 9,
            "type": "array",
            "uniqueItems": true
          }
        },
        "required": [
          "text"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "requests"
  ],
  "type": "object"
}