borders.js

ym.modules.define('borders', [
'util.crossDomainXhr',
'util.querystring',
'regions.decode'
], function (provide, crossDomainXhr, queryString, decode) {
var HOST = ym.env.hosts.api.services.regions + 'v2';

function createFeature (geometry, properties) {
properties.hintContent = properties.name;

return {
type: 'Feature',
geometry: {
type: geometry.type,
coordinates: geometry.coordinates,
// evenOdd нужно для правильного отображения заливки полигонов с внутренним
// контуром
fillRule: 'evenOdd'
},
properties: properties
};
}

function parseResponse (regionsData) {
var regions = regionsData.regions;
var geojson = { type: 'FeatureCollection', features: [] };

for (var iso3166 in regions) {
if (regions.hasOwnProperty(iso3166)) {
var geometry = decode.geometry(iso3166, regionsData);
geojson.features.push(createFeature(geometry, regions[iso3166]));
}
}

return geojson;
}

/**
* Provides access to the geometry of various regions and countries.
* If you are using a content security policy, then you need to add the 'connect-src' rule for the following hosts: https://api-maps.yandex.ru https://suggest-maps.yandex.ru https://*.maps.yandex.net https://yandex.ru
* @name borders.load
* @static
* @function
* @param {String} region The ISO_3166-1 country code (RU, UA, BY, KZ, TR) for loading
* the regional area, '001' for loading the geometry of country borders, or AQ for
* loading the geometry of Antarctic.
* @param {Object} [options] Display options.
* @param {String} [options.lang] Language (ru, en, uk, be, kk, tr).
* @param {Number} [options.quality = 1] Quality level. Available values:
* <ul>
* <li>0 - minimal quality</li>
* <li>1 - standard quality</li>
* <li>2 - improved quality</li>
* <li>3 - high quality</li>
* </ul>
* The quality level affects how accurately curves are represented, as well as the volume of the data file.
* @param {String} [options.disputedBorders] Two-letter code of the country to use as the official reference for determining the administrative subordination
* of disputed territories. Accepted values: 'RU', 'UA', 'UN'. By default, it coincides with the country code that is specified when loading the API.
* Unsupported country codes are reset to RU. For the region '001' (borders of countries),
* the code 'UN' is supported — world borders according to the United Nations.
* @returns {vow.Promise} Promise object.
* @example
* // Show objects on the map using ObjectManager
* ymaps.borders.load('RU', {
* lang: 'en'
* }).then(function (geojson) {
* var features = geojson.features.map(function (feature) {
* feature.id = feature.properties.iso3166;
* return feature;
* });
* var objectManager = new ymaps.ObjectManager();
* objectManager.add(features);
* myMap.geoObjects.add(objectManager);
* });
* @example
* // Show objects on the map using GeoObject
* ymaps.borders.load('RU', {
* lang: 'en'
* }).then(function (geojson) {
* for (var i = 0; i &lt; geojson.features.length; i++) {
* var geoObject = new ymaps.GeoObject(geojson.features[i]);
* myMap.geoObjects.add(geoObject);
* }
* });
*/
function load (region, options) {
options = options || {};
var lang = options.lang || ym.env.languageCode;
var quality = 'quality' in options ? options.quality : 1;
var disputedBorders = options.disputedBorders || ym.env.countryCode;

var query = {
lang: [lang, region].join('_'),
quality: quality,
disputedBorders: disputedBorders
};

var url = HOST + '?' + queryString.stringify(query);

return crossDomainXhr(url, { headers: { Accept: 'application/json' } }, true)
.then(function (response) {
return parseResponse(JSON.parse(response));
});
}

provide({ load: load });
});