uk en pl it

.

Web Monarx
Категорія Головна  

Основні відомості про Google Maps JavaScript API V3


2015-12-27 00:00:00

Примітка. Пакет Google Maps javascript API V3, опис якого наводиться на цих сторінках, тепер має статус офіційного javascript API. Відповідно до правил версія 2 цього API є офіційно застарілою. Рекомендуємо перевести свій код на оновлену та покращену версію.

Представляємо оновлений і офіційний пакет Google Maps javascript API V3! Цей API офіційно прийшов на заміну пакету Google Maps javascript API V2. Зовні ці версії дуже схожі, але всередині багато чого змінилося: версія 3 для стислості що позначається як V3 в цьому документі оптимізована для швидкого завантаження, особливо в мобільних браузерах таких пристроїв, як iPhone ™ і смартфони на платформі Android.

Ми будемо раді отримати ваші відгуки та коментарі про цю версію в групі обговорення Google Maps API V3.

Представляємо API версії 3 Аудиторія Геопозиціювання Визначення місця розташування користувача Визначення параметрів датчика Розробка додатків для мобільних пристроїв iPhone і пристроїв на платформі Android Локалізація в Maps API V3 Бібліотеки в Maps API V3 Завантаження API по протоколу HTTPS Новинка! Асинхронная завантаження API Версії Типи версій Історія версій Усунення неполадок

Представляємо API версії 3

Представляємо версію 3 Google Maps API. Цей javascript API зовні схожий з існуючою версією 2 Google Maps API. Однак багато що змінилося всередині: версія 3 оптимізована для швидкого завантаження, особливо в мобільних браузерах таких пристроїв, як iPhone ™ і смартфони на платформі Android. У первинному випуску доступний скорочений набір функцій в порівнянні з API версії 2. Ми працюємо над перенесенням додаткових функцій з версії 2, а також над збереженням невеликого розміру коду javascript і оптимізованої швидкістю завантаження. Ми будемо раді отримати ваші відгуки та коментарі про цю версію в групі обговорення Google Maps API V3.

Остання версія Google Maps API розроблена з використанням зміненої архітектури MVC. Зміни стану об`єкта MVC наприклад, карти обробляються за допомогою сеттерів і геттеров певного формату. Всі стану об`єкта MVC зберігаються в якості властивостей цього об`єкта. Всі зміни стану, виконані в обробнику подій, також мають певний формат.

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

Примітка. Для цієї версії Google Maps javascript API більше не потрібні ключі API!

Аудиторія

Дана документація призначена для користувачів, що мають навички роботи з javascript і знайомих з принципами об`єктно-орієнтованого програмування. Слід також знати, що таке Google Maps з точки зору користувача. В Інтернеті доступна велика кількість посібників з javascript.

Ця концептуальна документація не є повною і вичерпною; вона підготовлена з тією метою, щоб спростити вивчення можливостей Google Maps API і розробку додатків з його допомогою. Крім того, опубліковано Довідкове керівництво по Google Maps API.

Ця концептуальна документація включає в себе наступні розділи:

    Базові об`єкти карт Події карт Елементи управління карт Накладена графіка карт Служби карт

Будемо раді отримати відгуки про цю версію API та документації. Відправляйте свої відгуки в групу обговорення Google Maps javascript API V3.

Геопозиціювання

Геопозиціювання-це визначення географічного розташування користувача або мобільного пристрою за допомогою різноманітних методів збору даних. Як правило, більшість служб геопозиционирования використовують для визначення місця розташування адреси маршрутизації мереж або вбудовані модулі GPS. API геопозиционирования залежить від пристрою. Деякі браузери і пристрої не підтримують цей API, тому не можна покладатися на те, що реалізація геопозиционирования в веб-додатку можлива завжди.

Визначення місця розташування користувача

В даний час існує декілька способів визначення в браузері місця розташування користувача. Жоден з цих методів не входить в Google Maps API. Фактично це поширені галузеві стандарти.

    Більш нові браузери вже починають підтримувати стандарт W3C Geolocation. Цей стандарт є частиною HTML5 і, швидше за все, стане стандартом де-факто. Всі додатки, які використовують геопозиціонування, повинні його підтримувати. Деякі браузери з підтримкою Google Gears можуть використовувати службу Google Gears Geolocation API. Оскільки стандарт W3C поки не набув великого поширення, перевірка наявності Gears-непоганий резервний механізм. Деякі браузери використовують для визначення місця розташування користувача IP-адресу, але цей метод не відрізняється високою точністю.

Оскільки розташування користувача за IP-адресою визначається дуже приблизно, використовувати цей підхід для геопозиционирования не рекомендується. W3C-це найпростіший і найбільш повно підтримуваний спосіб, тому перш за все слід розглядати його. Якщо ви вирішите використовувати Google Gears, то попередньо потрібно перевірити, чи підтримує браузер стандарт W3C Зверніть увагу, що використання Google Gears потребують завантаження коду javascript для ініціалізації Gears.

У наступному прикладі робиться спроба визначити місце розташування користувача спочатку через властивість W3C navigator. geolocation, а потім через Google Gears. Якщо жоден з методів не спрацьовує, видається повідомлення про помилку.

//Note that using Google Gears requires loading the javascript 
//At Http ://code. google. com/apis/gears/gears_init. js

Var initialLocation;
Var siberia = new google. maps. LatLng60, 105;
Var newyork = new google. maps. LatLng40.69847032728747,-73.9514422416687;
Var browserSupportFlag = new Boolean;

Function initialize {
var myOptions = {
zoom: 6,
mapTypeId: google. maps. MapTypeId. ROADMAP
};
var map = new google. maps. Mapdocument. getElementById "map_canvas", myOptions;

//Try W3C Geolocation Preferred
ifnavigator. geolocation {
browserSupportFlag = true;
navigator. geolocation. getCurrentPositionfunctionposition {
initialLocation = new google. maps. LatLngposition. coords. latitude, position. coords. longitude;
map. setCenterinitialLocation;
}, Function {
handleNoGeolocationbrowserSupportFlag;
};
//Try Google Gears Geolocation
} Else if google. gears {
browserSupportFlag = true;
var geo = google. gears. factory. create `beta. geolocation `;
geo. getCurrentPositionfunctionposition {
initialLocation = new google. maps. LatLngposition. latitude, position. longitude;
map. setCenterinitialLocation;
}, Function {
handleNoGeoLocationbrowserSupportFlag;
};
//Browser doesn `t support Geolocation
} Else {
browserSupportFlag = false;
handleNoGeolocationbrowserSupportFlag;
}

function handleNoGeolocationerrorFlag {
if errorFlag == true {
alert "Geolocation service failed.";
initialLocation = newyork;
} Else {
alert "Your browser doesn ` t support geolocation. We `ve placed you in Siberia.";
initialLocation = siberia;
}
map. setCenterinitialLocation;
}
}

Переглянути приклад map-geolocation. php

Визначення параметрів датчика

При використанні Google Maps API потрібно вказувати, чи використовується в додатку датчик наприклад, пристрій GPS для визначення місця розташування користувача. Це особливо актуально для мобільних пристроїв. При додаванні коду javascript з Maps API додатки повинні передавати обов`язковий параметр sensor в тег

Зверніть увагу, що навіть якщо в додатку не використовується датчик розташування, все одно потрібно вказувати цей параметр, привласнюючи йому значення false.

Розробка додатків для мобільних пристроїв iPhone і пристроїв на платформі Android

Google Maps API V3 розроблений для швидкого завантаження і успішної роботи в мобільних пристроях. Зокрема, ми приділили особливу увагу розробці додатків для сучасних мобільних пристроїв, таких як iPhone і смартфони на платформі Android. Розмір екрану мобільних пристроїв набагато менше, ніж у звичайного комп`ютера. Крім того, в них реалізується особлива поведінка наприклад, функція масштабування двома пальцями Pinch-to-zoom в iPhone. Щоб додаток працювало на мобільних пристроях належним чином, ми рекомендуємо виконати наступні дії.

Для містить карту елемента

як значення атрибутів width і height встановіть 100%. Візьміть до уваги, що деякі браузери більш ранніх версій на ПК можуть неправильно працювати з цими значеннями.

IPhone і пристрої на платформі Android можна визначити по властивості navigator. userAgent об`єкта DOM:

 Function detectBrowser {
var useragent = navigator. userAgent;
var mapdiv = document. getElementById "map_canvas";

if useragent. indexOf `iPhone `! =-1 | | useragent. indexOf `Android `! =-1 {
mapdiv. style. width = `100%`;
mapdiv. style. height = `100%`;
} Else {
mapdiv. style. width = `600px `;
mapdiv. style. height = `800px `;
}
}

Завдяки цьому можна змінювати дизайн сторінки для певних пристроїв. У цьому прикладі представлений варіант зміни корисної площі екрану для всіх пристроїв.

IPhone враховує зміст наступного тега :

  

У цьому теге зазначено, що карта повинна бути показана в повноекранному режимі і її розмір не може бути змінений користувачем. Пристрої на платформі Android версії 1.5 Cupcake також підтримують ці параметри. Зверніть увагу, що для браузера Safari в iPhone потрібно включити тег в елемент сторінки .

Детальніше про розробку додатків для iPhone розказано в документації для розробників Apple. Детальніше про розробку додатків для пристроїв на платформі Android розказано в документації по Android.

Локалізація в Maps API V3

Щоб локалізувати додаток Maps API, можна змінити мовні налаштування за замовчуванням або встановити код регіону для програми, який змінить роботу програми в певній країні або на певній території.

Локалізація по мові

Google Maps API використовує параметр потрібної мови в браузері при виведенні тексту назв елементів управління, повідомлень про авторське право, маршрутів і міток на карті. У більшості випадків цей спосіб кращий; не рекомендується перевизначати мовні настройки, які задав користувач. Але якщо потрібно, щоб Maps API ігнорував мовні настройки браузера і видавав інформацію певною мовою, можна при включенні коду javascript Maps API додати необов`язковий параметр language в тег

Завантаження API по протоколу HTTPS

Доступ до Google Maps javascript API можна здійснювати по протоколу HTTPS , що дозволяє працювати з ним в додатках, що використовують цей захищений протокол. Щоб завантажити Google Maps javascript API Version 3 по протоколу HTTPS , завантажте API за допомогою наступного URL:

  ; 

Завантаживши Google Maps javascript API V3 по HTTPS, ви зможете працювати з Maps API на сторінках, що використовують цей безпечний протокол HTTP over the Secure Socket Layer SSL. Завантаження Maps API по HTTPS допоможе уникнути появи попереджень при роботі з SSL-додатками в більшості браузерів. Крім того, цей протокол рекомендується використовувати, якщо додаток передає в запитах конфіденційні дані користувачів наприклад, дані про місцезнаходження.

Асинхронная завантаження javascript API

Зазвичай javascript Maps API слід завантажувати одночасно зі сторінкою. Для цього API потрібно включити в тег


Подібні статті

 8coins-перевірена часом партнерка
 ПРОСУВАННЯ виразника НА DLE ЧАСТИНА # 1-ПЕРША ІНДЕКСАЦІЯ САЙТУ. ЯК ЇЇ ПРИСКОРИТИ?
 WebArtex. ru-Біржа статей, де "все включено". Відгуки
 Top-inspector. ru-безкоштовна перевірка позицій сайта
 


Сайт є приватним зібранням матеріалів і являє собою аматорський інформаційно-освітній ресурс. Вся інформація отримана з відкритих джерел. Адміністрація не претендує на авторство використаних матеріалів. Всі права належать їх правовласникам