На Я.Субботнике прошедшем октября в Казахстане был доклад и про API: "Яндекс.Карты: между пользователем и разработчиком". Вы можете скачать презентацию, но лучше посмотреть видео! В презентации нет массы примеров которые демонстрировались он-лайн.
Посмотреть все выступления, скачать все презентации можно на страничке Я.Субботников.