29 точек на карте

Читаю документацию и удивляюсь!

Для кого она написана???

Вот есть у меня код,

var hotels = [

  { point: '37.646768,55.822463', name: 'Имя1', description: 'Описание 1' },

  // И так 29 раз

];

function getCollection (data) {

   var collection = new YMaps.GeoObjectCollection();

   YMaps.jQuery.each(data, function (i, element) {

       var pm = new YMaps.Placemark(YMaps.GeoPoint.fromString(element.point));

       pm.name = element.name;

       pm.description = element.description;

       collection.add(pm);

   });

   return collection;

}

function show_hotels () {

   map.addOverlay(getCollection(hotels));

}

Теперь для точек перечисленных в массиве я хочу задать позиционирование и масштаб!

Для этого есть класс 
                    YMaps.Bounds. и констуктор YMaps.CollectionBounds(point) но как его применять непонятно!!!

Возникает путаница!

Подскажите пожалуйста как мне задать центр карты имея:

var hotels = [
    { point: '37.646768,55.822463', name: 'Имя1', description: 'Описание 1' },
];

function getCollection (data) {
var seton = new YMaps.GeoCollectionBounds();
    var collection = new YMaps.GeoObjectCollection();
    YMaps.jQuery.each(data, function (i, element) {
        var pm = new YMaps.Placemark(YMaps.GeoPoint.fromString(element.point), {style: "default#houseIcon"});
        pm.name = element.name;
        pm.description = element.description;
        collection.add(pm);
        seton.add([new YMaps.GeoPoint(element.point)]);

    });
    return collection;
}
function list_hotels () {
    map.removeAllOverlays();
    map.addOverlay(getCollection(hotels));
}

скрывайте код под врезки.

 seton.add([new YMaps.GeoPoint(element.point)]);

у вас element.point - строка

конструктор new YMaps.GeoPoint ждет два Number-а (долготу и широту)

нужно использовать YMaps.GeoPoint.fromString который на 5 строчек выше в вашем коде

И массив (квадратные скобки) не нужен вы же по одной точке добавляете

Документация нормальная. Рекомендую почитать книжку по javascript

Читал и использую как настольную!

Но доки непонятные!

Что из себя представляет YMaps.GeoCollectionBounds(); что возвращает в результате и где использовать этого ненаписано!

как добавляет метогд add и куда он добавляет, в каком виде!

И основное, нет записей типа

Метод: add

Синтаксис: YMaps.GeoCollectionBounds.add (point)

Описание: add - метод для GeoCollectionBounds, добавляет новую точку куда то там после чего что там происходи, неясно что и в результате карта устанавливается по центру и сама масштабируется!

В качестве point - строка с координатами гео точки.

Пример использования метода:

****************

Вот так например!  Ну и естественно зависимости и с чем можно использовать!

Может тот кто хочет написать себе сервис на основе ваших карт, который он не напишет сам  и будет разбираться и каждую строчку вычитывать ваших доков, но те кому нужно побыстрому склепать простую карту и вывести 2 функции, то это очень геморойно и за 10 минут не разобраться!

Есть справочник по програмному интерфейсу 

Он написан как референс. там есть описания всех методов и свойств их тип и возвращаемое значение.

Примеров использования каждого метода в справочнике нет иначе он будет огромный.

Есть руководство разработчика которое от простого к сложному на понятном языке с примерами объясняет основные сценарии работы с АПИ.

что именно, на ваш взгляд, не так написано?

На мой взгля отделять справочник по програмному интерфейсу  и руководство разработчика не стоит, т.к справочник и сделан для разработчика! 

В руководстве должно быть все описано от програмного интерфейса до непосредственной разработки!

Должно быть написано доступным языком и последовательно (иерархично) типа что откуда и к чему! А то приходиться тут смотреть, там смотреть! А тут примеров нет идешь смотреть примеры в другое место ну и тд!

Неужели получилось!

function getCollection (data) {
var seton = new YMaps.GeoCollectionBounds();
    var collection = new YMaps.GeoObjectCollection();
    YMaps.jQuery.each(data, function (i, element) {
        var pm = new YMaps.Placemark(YMaps.GeoPoint.fromString(element.point), {style: "default#houseIcon"});
        pm.name = element.name;
        pm.description = element.description;
        collection.add(pm);
        seton.add(new YMaps.GeoPoint.fromString(element.point));
    });
    map.setBounds(seton);
    return collection;
}

Обидно что пришел я к результаты не прочитав документацию и разобравшись, а прочитав документацию, спросив 10 раз в клубе и потыкав непонятно как! Хотя в общем то сложного ничего нет, но представление информации очень и очень скудное!

Теперь я уже понимаю как тут у вас все устроено и как работает и дальше постараюсь детальней разбираться!!!

Всем большое спасибо за участие, очень признателен!

 map.setBounds(seton); это некместу. В в функции в которая возвращает коллекцию, двигаете карту. Выкидывайте это действие туда где добавляете эту коллекцию на карту. Работает оно и так, но как-то неаккуратненько.

Если почитать возможности апи, ты вы увидете что bounds для коллекции можно вычислить по другому.http://api.yandex.ru/maps/jsapi/doc/ref/reference/geoobjectcollection.xml

Что из себя представляет YMaps.GeoCollectionBounds(); что возвращает в результате и где использовать этого ненаписано!

Ай-я-яй! Вы даже не пытались смотреть документацию. Все там написанно(смотрите ссылочку выше).  Задать вопрос не попытавшись разобраться самостоятельно это очень плохая практика. Так как: а) получение ответа занимает больше времени б) создает о вас отрицательное мнение.