Підключення javascript api

Якщо Вам сподобався цей матеріал, поділіться ним з вашими друзями в соц мережах

Компоненти розміщені на серверах Яндекса і доступні для використання відразу після їх завантаження на сторінку.

Для цього необхідно додати в заголовок head HTML-сторінки рядок наступного виду.

Підключенні API Яндекс.Карт можливо виконати використовуючи додаткові параметри. які будуть описані в таблиці нижче, при цьому URL матиме такий вигляд:

Параметри завантаження API

У таблиці наведено додаткові параметри завантаження API і приклади їх використання.

Список завантажуваних модулів.

Імена модулів перераховуються через кому. Наприклад, load = Map, Placemark, map.addon.balloon.

За замовчуванням завантажуються всі компоненти API (load = package.full), проте в цілях мінімізації обсягу трафіку, що передається клієнтському застосуванню, ви можете вказати список конкретних сутностей API, з якими працює ваш додаток.

package.full оптимізований таким чином, щоб довантажувати функціональність в момент її фактичного використання, тому в більшості випадків немає необхідності налаштовувати параметр load.

Компоненти також можна завантажувати "на вимогу", використовуючи функцію require.

Значення за замовчуванням: package.full.

Режим завантаження API.

Значення за замовчуванням: release.

вказуємо режим завантаження API: mode = debug

Простір імен, в якому локалізовані програмні компоненти API. За замовчуванням всі об'єкти належать простору імен ymaps (наприклад, ymaps.Map). Якщо при завантаженні API вказати ns = myNameSpace. то об'єкти будуть доступні вже як myNameSpace.Map.

Використання простору імен дозволяє уникнути перетинання назв функцій і інших програмних компонентів, що використовуються в API і призначеному для користувача / сторонньому коді.

Ви можете задати порожнє значення ns. В цьому випадку API не створюватиме об'єктів в глобальному контексті, і доступ до функціональності API отримає тільки функція, зазначена в параметрі onload.

Значення за замовчуванням: ymaps.

створимо карту не вказуючи простір імен, тобто використовую його значення за замовчуванням ns = ymaps

тепер створимо карту вказавши власний простір імен, наприклад ns = myNameSpace

Ім'я функції, яку необхідно викликати після того, як компоненти API будуть завантажені і готові до використання (callback). В цю функцію як аргумент буде переданий об'єкт-неймспейс з функціональністю API.

Допускається використання вкладених просторів імен:

Приклад використання наведено в таблиці нижче.

створимо карту викликавши функцію зазначену при завантаження API onload = initMap

Ім'я callback-функції, яка буде викликана в разі помилки завантаження API. В цю функцію як аргумент буде переданий об'єкт, що містить інформацію про помилку.