---
metadata:
- name: generator
content: Diplodoc Platform v5.39.1
alternate:
- https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/ymapsml_polygon.md
- https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/ymapsml_polygon.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/en/llms.txt
# Polygon
Open in CodeSandbox
YMapsML is a language for describing geographical objects.
In YMapsML, each geographical object is associated with a geometric shape and a geo object that is used
for displaying this shape on the map. The shape definitions and their anchors to geographical coordinates are set in
corresponding YMapsML elements. The gml:Polygon element is designated
for the "polygon" shape.
It contains the gml:exterior element, which lists the coordinates of the
vertexes of the polygon's exterior contour. A polygon may also contain interior contours. Their vertexes
are set in the gml:interior element.
The geoXml.load function is used for loading YMapsML data. After data loads, the function converts it to
GeoObjectCollection and passes it to the handler function as a parameter. A GeoObjectCollection can be displayed
on the map.
{% list tabs %}
- index.html
```html
YMapsML examples. Adding placemarks to the map.
```
- ymapsml_polygon.js
```js
ymaps.ready(init);
function init() {
// Creating an instance of the map.
var myMap = new ymaps.Map(
"map",
{
center: [61.766513, 34.344165],
zoom: 12,
},
{
searchControlProvider: "yandex#search",
}
);
// Loading a YMapsML file.
ymaps.geoXml.load("data.xml").then(
function (res) {
// Adding geo objects to the map.
myMap.geoObjects.add(res.geoObjects);
// Called if loading the YMapsML file was unsuccessful.
},
function (error) {
alert("Error: " + error);
}
);
}
```
{% endlist %}