Географические объекты и их коллекции

Для описания географического объекта в YMapsML используется элемент ymaps:GeoObject. Совокупность географических объектов может быть объединена в коллекцию, для описания которой предназначен элемент ymaps:GeoObjectCollection.

Чтобы обеспечить совместимость со стандартом GML каждый из этих элементов заключается в один из элементов-контейнеров — gml:featureMember или gml:featureMembers. Исключение составляет лишь элемент ymaps:GeoObjectCollection , находящийся в корневом элементе ymaps:ymaps.

Разница между этими контейнерами заключается в следующем. Элемент gml:featureMember может содержать либо описание одного географического объекта (ymaps:GeoObject), либо одной коллекции (ymaps:GeoObjectCollection). Элемент gml:featureMembers может содержать в себе произвольное количество описаний географических объектов и их коллекций.

Структура элемента ymaps:GeoObject, содержащего описание географического объекта, выглядит следующим образом.

С помощью коллекций можно объединять как географические объекты, так и сами коллекции. Если учесть приведённую выше информацию о том, что элементы ymaps:GeoObject и ymaps:GeoObjectCollection заключаются в контейнеры gml:featureMember и gml:featureMembers, структура элемента ymaps:GeoObjectCollection будет выглядеть достаточно предсказуемо.