ترقية تطبيقك المزوّد لواجهة برمجة التطبيقات Maps JavaScript API من الإصدار 2 إلى الإصدار 3

حدث جديد لدعم MVC

تضيف واجهة برمجة التطبيقات v3 نوعًا جديدًا من الأحداث للإشارة إلى تغييرات حالة MVC. هناك الآن نوعان من الأحداث:

• يتم نشر أحداث المستخدمين (مثل أحداث الماوس "النقر") من DOM إلى Maps JavaScript API. وهذه الأحداث منفصلة ومختلفة عن أحداث DOM العادية.
• تعكس إشعارات تغيير حالة MVC التغييرات في عناصر Maps API ويتم تسميتها باستخدام اصطلاح property_changed.

يصدّر كل عنصر من عناصر Maps API عددًا من الأحداث المُسمّاة. على التطبيقات التي تهمّها أحداث معيّنة تسجيل أدوات معالجة الأحداث لهذه الأحداث وتنفيذ الرمز عند تلقّي هذه الأحداث. هذه المنظومة المستندة إلى الحدث هي نفسها في كلّ من الإصدارين GEvent وgoogle.maps.event من واجهة برمجة التطبيقات JavaScript لـ "خرائط Google"، باستثناء أنّ نطاق الاسم قد تغيّر من GEvent إلى google.maps.event:

GEvent.addListener(map, 'click', function() {
  alert('You clicked the map.');
});

google.maps.event.addListener(map, 'click', function() {
  alert('You clicked the map.');
});

إزالة أدوات معالجة الأحداث

لأسباب تتعلّق بالأداء، من الأفضل إزالة أداة معالجة الأحداث عندما لم تعُد ضرورية. تعمل إزالة أداة معالجة الأحداث بالطريقة نفسها في الإصدار 2 والإصدار 3:

1. عند إنشاء مستمع أحداث، يتم عرض عنصر غير شفاف (GEventListener في الإصدار 2، وMapsEventListener في الإصدار 3).
2. عندما تريد إزالة أداة معالجة الحدث، مرِّر هذا العنصر إلى الأسلوب removeListener() (GEvent.removeListener() في الإصدار 2 أو google.maps.event.removeListener() في الإصدار 3) لإزالة أداة معالجة الحدث.

الاستماع إلى أحداث DOM

إذا كنت تريد تسجيل أحداث DOM (نموذج معالجة المستندات) والاستجابة لها، يقدّم الإصدار 3 الطريقة الثابتة google.maps.event.addDomListener() ، وهي مكافئة للطريقة GEvent.addDomListener() في الإصدار 2.

استخدام الوسيطات التي تم تمريرها في الأحداث

غالبًا ما تُرسِل أحداث واجهة المستخدم مَعلمة حدث يمكن بعد ذلك لواجهة معالجة الحدث الاطّلاع عليها. تم تبسيط معظم مَعلمات الأحداث في الإصدار 3 لتكون أكثر اتساقًا مع العناصر في واجهة برمجة التطبيقات. (راجِع مرجع الإصدار 3 للاطّلاع على التفاصيل).

لا تتوفّر وسيطة overlay في أدوات معالجة الأحداث في الإصدار 3. إذا صعَّدت حدث click على خريطة الإصدار 3، لن يتم تسجيل callback إلا عند نقر المستخدم على الخريطة الأساسية. يمكنك تسجيل مزيد من callbacks على العناصر التي يمكن النقر عليها إذا كنت بحاجة إلى التفاعل مع هذه النقرات.

// Passes an overlay argument when clicking on a map

var map = new GMap2(document.getElementById('map'));
map.setCenter(new GLatLng(-25.363882, 131.044922), 4);
map.setUIToDefault();

GEvent.addListener(map,'click', function(overlay, latlng) {
  if (latlng) {
    var marker = new GMarker(latlng);
    map.addOverlay(marker);
  }
});

// Passes only an event argument

var myOptions = {
    center: new google.maps.LatLng(-25.363882, 131.044922),
    zoom: 4,
    mapTypeId: google.maps.MapTypeId.ROADMAP
};

var map = new google.maps.Map(document.getElementById('map'),
    myOptions);

google.maps.event.addListener(map, 'click', function(event) {
  var marker = new google.maps.Marker({
      position: event.latLng,
      map: map
  });
});

التغييرات في أنواع عناصر التحكّم

تمّت إضافة بعض التغييرات على أنواع control باستخدام واجهة برمجة التطبيقات v3 API.

1. تتيح واجهة برمجة التطبيقات v3 API استخدام أنواع خرائط إضافية بما في ذلك خرائط التضاريس وإمكانية إضافة أنواع خرائط مخصّصة.
2. لم يعُد عنصر التحكّم الهرمي في الإصدار 2، GHierarchicalMapTypeControl، متاحًا. يمكنك الحصول على تأثير مشابه باستخدام عنصر التحكّم google.maps.MapTypeControlStyle.HORIZONTAL_BAR.
3. لا يتوفّر التصميم الأفقي الذي يوفّره GMapTypeControl في الإصدار 2 في الإصدار 3.

إضافة عناصر التحكّم إلى الخريطة

باستخدام الإصدار 2 من واجهة برمجة التطبيقات JavaScript لـ "خرائط Google"، يمكنك إضافة عناصر تحكّم إلى خريطتك من خلال طريقة addControl() لعنصر الخريطة. في الإصدار 3، بدلاً من الوصول إلى عناصر التحكّم أو تعديلها مباشرةً، يمكنك تعديل عنصر MapOptions المرتبط. يوضّح المثال التالي كيفية تخصيص الخريطة لإضافة عناصر التحكّم التالية:

• أزرار تتيح للمستخدم التبديل بين أنواع الخرائط المتاحة
• مقياس خريطة

var map = new GMap2(document.getElementById('map'));
map.setCenter(new GLatLng(-25.363882, 131.044922), 4);

// Add controls
map.addControl(new GMapTypeControl());
map.addControl(new GScaleControl());

var myOptions = {
    center: new google.maps.LatLng(-25.363882, 131.044922),
    zoom: 4,
    mapTypeId: google.maps.MapTypeId.ROADMAP,

    // Add controls
    mapTypeControl: true,
    scaleControl: true
};

var map = new google.maps.Map(document.getElementById('map'),
    myOptions);

عناصر التحكّم في موضع العناصر على الخريطة

تم إجراء تغييرات كبيرة على عناصر التحكّم في الموضع في الإصدار 3. في الإصدار 2، تأخذ الطريقة addControl() مَعلمة ثانية اختيارية تتيح لك تحديد موضع عنصر التحكّم بالنسبة إلى زوايا الخريطة.

في الإصدار 3، يمكنك ضبط موضع عنصر تحكّم من خلال سمة position لخيارات عناصر التحكّم. إنّ موضع عناصر التحكّم هذه ليس مطلقًا، بل سترتّب واجهة برمجة التطبيقات عناصر التحكّم بذكاء من خلال "تدفقها" حول عناصر الخريطة الحالية ضمن قيود معيّنة (مثل حجم الخريطة). يضمن ذلك توافق عناصر التحكّم التلقائية مع عناصر التحكّم التي تستخدمها. اطّلِع على التحكّم في موضع الإعلان في الإصدار 3 للحصول على مزيد من المعلومات.

يعيد الرمز البرمجي التالي ترتيب عناصر التحكّم من العيّنات أعلاه:

var map = new GMap2(document.getElementById('map'));
map.setCenter(new GLatLng(-25.363882, 131.044922), 4);

// Add map type control
map.addControl(new GMapTypeControl(), new GControlPosition(
    G_ANCHOR_TOP_LEFT, new GSize(10, 10)));

// Add scale
map.addControl(new GScaleControl(), new GControlPosition(
    G_ANCHOR_BOTTOM_RIGHT, new GSize(20, 20)));

var myOptions = {
  center: new google.maps.LatLng(-25.363882, 131.044922),
  zoom: 4,
  mapTypeId: google.maps.MapTypeId.ROADMAP,

  // Add map type control
  mapTypeControl: true,
  mapTypeControlOptions: {
      style: google.maps.MapTypeControlStyle.HORIZONTAL_BAR,
      position: google.maps.ControlPosition.TOP_LEFT
  },

  // Add scale
  scaleControl: true,
  scaleControlOptions: {
      position: google.maps.ControlPosition.BOTTOM_RIGHT
  }
};

var map = new google.maps.Map(document.getElementById('map'),
    myOptions);

عناصر التحكّم المخصّصة

تتيح لك واجهة برمجة التطبيقات Maps JavaScript API إنشاء عناصر تحكّم مخصّصة في التنقّل. لتخصيص عناصر التحكّم باستخدام واجهة برمجة التطبيقات v2، عليك إنشاء فئة فرعية من فئة GControl وتحديد معالِجات لطريقتَي initialize() وgetDefaultPosition(). لا تتوفّر فئة مكافئة لفئة GControl في الإصدار 3. وبدلاً من ذلك، يتم تمثيل عناصر التحكّم كعناصر نموذج عناصر المستند (DOM). لإضافة عنصر تحكّم مخصّص باستخدام واجهة برمجة التطبيقات v3، أنشئ بنية DOM للعنصر التحكّم في ملف سازند كعنصر تابع لعنصر Node (مثل عنصر <div>) وأضِف مستمعي أحداث للتعامل مع أي أحداث في DOM. ادفع العنصر Node إلى مصفوفة controls[position] للخرائط لإضافة مثيل من العنصر التحكّم المخصّص إلى خريطتك.

في ما يتعلّق بتنفيذ فئة HomeControl الذي يلتزم بمتطلبات الواجهة المذكورة أعلاه (اطّلِع على مستندات عناصر التحكّم المخصّصة لمعرفة التفاصيل)، توضّح عيّنات الرموز البرمجية التالية كيفية إضافة عنصر تحكّم مخصّص إلى خريطة.

map.addControl(new HomeControl(),
    GControlPosition(G_ANCHOR_TOP_RIGHT, new GSize(10, 10)));

var homeControlDiv = document.createElement('DIV');
var homeControl = new HomeControl(homeControlDiv, map);

map.controls[google.maps.ControlPosition.TOP_RIGHT].push(
    homeControlDiv);

إضافة الطبقات وإزالتها

إنّ أنواع الكائنات التي تمثّلها العناصر التي تظهر على سطح الفيديو هي نفسها في الإصدار 2 والإصدار 3، ولكن يتم التعامل معها بشكل مختلف.

تمت إضافة العناصر التي تظهر على سطح الخريطة في واجهة برمجة التطبيقات من الإصدار 2 وإزالتها منها باستخدام الطريقتَين addOverlay() وremoveOverlay() في عنصر GMap2. في الإصدار 3، يمكنك تعيين خريطة إلى عنصر "تراكب" من خلال سمة map لفئة خيارات التراكب المرتبطة. يمكنك أيضًا إضافة تراكب أو إزالته مباشرةً من خلال استدعاء setMap() طريقة كائن التراكب وتحديد الخريطة المطلوبة. يؤدي ضبط سمة الخريطة على null إلى إزالة التراكب.

لا تتوفّر طريقة clearOverlays() في الإصدار 3. إذا كنت تريد إدارة مجموعة من الصور المتراكبة، عليك إنشاء صفيف لتثبيت الصور المتراكبة. باستخدام هذه الصفيف، يمكنك بعد ذلك استدعاء setMap() على كلّ تراكب في الصفيف (مع تمرير null إذا كنت بحاجة إلى إزالته).

العلامات القابلة للسحب

تكون العلامات قابلة للنقر تلقائيًا، ولكن لا يمكن سحبها. في المثالين التاليين، تتم إضافة علامة قابلة للسحب:

var myLatLng = new GLatLng(-25.363882, 131.044922);
var map = new GMap2(document.getElementById('map'));
map.setCenter(myLatLng, 4);

var marker = new GMarker(latLng, {
  draggable: true
});
map.addOverlay(marker);

var myLatLng = new google.maps.LatLng(-25.363882, 131.044922);
var map = new google.maps.Map(
  document.getElementById('map'), {
  center: myLatLng,
  zoom: 4,
  mapTypeId: google.maps.MapTypeId.ROADMAP
});

var marker = new google.maps.Marker({
    position: myLatLng,
    draggable: true,
    map: map
});

الرموز

يمكنك تحديد رمز مخصّص ليظهر بدلاً من العلامة التلقائية. لاستخدام صورة مخصّصة في الإصدار 2، يمكنك إنشاء مثيل GIcon من G_DEFAULT_ICON type وتعديله. إذا كانت صورتك أكبر أو أصغر من الرمز التلقائي، يجب تحديدها باستخدام مثيل GSize. تعمل واجهة برمجة التطبيقات v3 API على تبسيط هذه العملية قليلاً. ما عليك سوى ضبط سمة icon للعلامة على عنوان URL لصورتك المخصّصة، وستضبط واجهة برمجة التطبيقات حجم الرمز تلقائيًا.

توفّر Maps JavaScript API أيضًا إمكانية استخدام الرموز المعقدة. قد يتضمّن الرمز المعقد عدة مربّعات أو أشكالًا معقّدة، أو يحدّد "ترتيب التجميع" لكيفية عرض الصور مقارنةً بالعناصر الأخرى التي تظهر على سطح الخريطة. لإضافة شكل إلى علامة في الإصدار 2، عليك تحديد السمة الإضافية في كل مثيل GIcon ونقلها كخيار إلى مُنشئ GMarker. في الإصدار 3، يجب أن تضبط الرموز المحدّدة بهذه الطريقة سمات icon كائن من النوع Icon. لا تتوفّر ظلال العلامات في الإصدار 3.

تعرض الأمثلة التالية علم شاطئ على شاطئ بونداي في أستراليا، مع عدم إمكانية النقر على الجزء الشفاف من الرمز:

var map = new GMap2(document.getElementById('map'));
map.setCenter(new GLatLng(-25.363882, 131.044922), 4);
map.setUIToDefault();

var flagIcon = new GIcon(G_DEFAULT_ICON);
flagIcon.image = '/images/beachflag.png';
flagIcon.imageMap = [1, 1, 1, 20, 18, 20, 18 , 1];
var bbLatLng = new GLatLng(-33.890542, 151.274856);

map.addOverlay(new GMarker(bbLatLng, {
  icon: flagIcon
}));

var map = new google.maps.Map(
  document.getElementById('map'), {
  center: new google.maps.LatLng(-25.363882, 131.044922),
  zoom: 4,
  mapTypeId: google.maps.MapTypeId.ROADMAP
});

var shape = {
    coord: [1, 1, 1, 20, 18, 20, 18 , 1],
    type: 'poly'
};
var bbLatLng = new google.maps.LatLng(-33.890542, 151.274856);

var bbMarker = new google.maps.Marker({
    icon: '/images/beachflag.png'
    shape: shape,
    position: bbLatLng,
    map: map
});

الخطوط المتعددة

يتألّف الخطّ المتعدّد من مصفوفة من LatLng، بالإضافة إلى سلسلة من أجزاء الخطوط التي تربط هذه المواقع الجغرافية في تسلسل مرتّب. إنّ إنشاء عنصر Polyline وعرضه في الإصدار 3 مشابه لاستخدام عنصر GPolyline في الإصدار 2. ترسم العيّنات التالية خطًا متعدد الأضلاع شبه شفافًا بعرض 3 بكسل وخطًا جيوديزيكيًا من زيورخ إلى سيدني عبر سنغافورة:

var polyline = new GPolyline(
  [
    new GLatLng(47.3690239, 8.5380326),
    new GLatLng(1.352083, 103.819836),
    new GLatLng(-33.867139, 151.207114)
  ],
  '#FF0000', 3, 0.5, {
  geodesic: true
});

map.addOverlay(polyline);

var polyline = new google.maps.Polyline({
  path: [
    new google.maps.LatLng(47.3690239, 8.5380326),
    new google.maps.LatLng(1.352083, 103.819836),
    new google.maps.LatLng(-33.867139, 151.207114)
  ],
  strokeColor: '#FF0000',
  strokeOpacity: 0.5,
  strokeWeight: 3,
  geodesic: true
});

polyline.setMap(map);

خطوط متعدّدة مُشفّرة

لا تتيح الإصدار 3 إنشاء عناصر Polyline مباشرةً من خطوط التي تم ترميزها. بدلاً من ذلك، توفّر مكتبة الهندسة طرقًا لترميز الخطوط المتعددة وفك ترميزها. اطّلِع على المكتبات في واجهة برمجة التطبيقات لإصدار "خرائط Google" 3 لمزيد من المعلومات حول كيفية تحميل هذه المكتبة.

ترسم الأمثلة أدناه الخط المتعدّد الأضلاع المشفَّر نفسه، ويستخدم رمز الإصدار 3 الإجراء decodePath() من النطاق google.maps.geometry.encoding.

var polyline = new GPolyline.fromEncoded({
  points: 'kwb`Huqbs@ztzwGgvpdQbw}uEoif`H',
  levels: 'PPP',
  zoomFactor: 2,
  numLevels: 18,
  color: '#ff0000',
  opacity: 0.8,
  weight: 3
});

map.addOverlay(polyline);

var polyline = new google.maps.Polyline({
  path: google.maps.geometry.encoding.decodePath(
    'kwb`Huqbs@ztzwGgvpdQbw}uEoif`H'),
  strokeColor: '#FF0000',
  strokeOpacity: 0.5,
  strokeWeight: 3,
});

polyline.setMap(map);

المضلّعات

يحدِّد المضلّع منطقة ضمن حلقة مغلقة. تمامًا مثل كائن Polyline، تتكون كائنات Polygon من سلسلة من النقاط في تسلسل مرتّب. تشبه فئة Polygon في الإصدار 3 إلى حد كبير فئة GPolygon في الإصدار 2، باستثناء أنّه لم يعُد عليك تكرار النقطة الأساسية في نهاية المسار لإغلاق الحلقة. ستغلق واجهة برمجة التطبيقات لإصدار 3 أي مضلّعات تلقائيًا من خلال رسم خط يربط الإحداثي الأخير بالإحداثي الأول. تنشئ المقتطفات التالية من الرموز البرمجية مضلّعًا يمثّل مثلث برمودا:

var map = new GMap2(document.getElementById('map'));

map.setCenter(new GLatLng(24.886436, -70.268554), 5);

var bermudaTriangle = new GPolygon(
  [
    new GLatLng(25.774252, -80.190262),
    new GLatLng(18.466465, -66.118292),
    new GLatLng(32.321384, -64.75737),
    new GLatLng(25.774252, -80.190262)
  ],
  '#FF0000', 2, 0.8, '#FF0000', 0.35);

map.addOverlay(bermudaTriangle);

var map = new google.maps.Map(document.getElementById('map'), {
  center: new google.maps.LatLng(24.886436, -70.268554),
  mapTypeId: google.maps.MapTypeId.TERRAIN,
  zoom: 5
});

var bermudaTriangle = new google.maps.Polygon({
  paths: [
    new google.maps.LatLng(25.774252, -80.190262),
    new google.maps.LatLng(18.466465, -66.118292),
    new google.maps.LatLng(32.321384, -64.75737)
  ],
  strokeColor: '#FF0000',
  strokeWeight: 2,
  strokeOpacity: 0.8,
  fillColor: '#FF0000',
  fillOpacity: 0.35
});

bermudaTriangle.setMap(map);

الأشكال القابلة للتعديل من قِبل المستخدم

يمكن للمستخدم تعديل الخطوط المتعددة والأشكال المتعددة الأضلاع. مقتطفات الرمز التالي متكافئة:

map.addOverlay(polyline);
polyline.enableEditing();

polyline.setMap(map);
polyline.setEditable(true);

للاطّلاع على مزيد من إمكانات الرسم المتقدّمة، اطّلِع على مكتبة الرسم في مستندات الإصدار 3.

نوافذ المعلومات

يعرض الرمز InfoWindow المحتوى في نافذة عائمة فوق الخريطة. هناك بعض الاختلافات الرئيسية بين نافذتَي المعلومات الإصدار 2 والإصدار 3:

• لا تتيح واجهة برمجة التطبيقات في الإصدار 2 سوى GInfoWindow لكل خريطة، في حين تتيح واجهة برمجة التطبيقات في الإصدار 3 InfoWindow متزامنة متعددة على كل خريطة.
• سيظلّ InfoWindow من الإصدار 3 مفتوحًا عند النقر على الخريطة. يتم إغلاق GInfoWindow الإصدار 2 تلقائيًا عند النقر على الخريطة. يمكنك محاكاة سلوك الإصدار 2 عن طريق إضافة مستمع click إلى العنصر Map.
• لا توفّر الإصدار 3 من واجهة برمجة التطبيقات دعمًا أصليًا لInfoWindow المُقسّمة إلى علامات تبويب.

تراكبات الأرض

لوضع صورة على خريطة، يجب استخدام كائن GroundOverlay. إنّ أسلوب الإنشاء لعنصر GroundOverlay هو نفسه بشكل أساسي في الإصدار 2 والإصدار 3: فهو يحدِّد عنوان URL للصورة وحدودها كمَعلمات.

يعرض المثال التالي خريطة قديمة لمدينة نيوارك في نيوجيرسي على الخريطة كعنصر مركّب:

var bounds = new GLatLngBounds(
    new GLatLng(40.716216, -74.213393),
    new GLatLng(40.765641, -74.139235));

var overlay = new GGroundOverlay(
    'http://lib.utexas.edu/maps/historical/newark_nj_1922.jpg',
    bounds);

map.addOverlay(overlay);

var bounds = new google.maps.LatLngBounds(
    new google.maps.LatLng(40.716216, -74.213393),
    new google.maps.LatLng(40.765641, -74.139235));

var overlay = new google.maps.GroundOverlay(
    'http://lib.utexas.edu/maps/historical/newark_nj_1922.jpg',
    bounds);

overlay.setMap(map);

أنواع الخرائط الشائعة

تتوفّر الأنواع الأربعة الأساسية من الخرائط في كلّ من الإصدار 2 والإصدار 3:

• MapTypeId.ROADMAP (يحلّ محلّ G_NORMAL_MAP) لعرض عرض خريطة الطرق
• ‫MapTypeId.SATELLITE (يحلّ محلّ G_SATELLITE_MAP) عرض صور الأقمار الصناعية من Google Earth
• MapTypeId.HYBRID (يحلّ محلّ G_HYBRID_MAP) لعرض مزيج من العرض العادي وعرض القمر الصناعي
• ‫MapTypeId.TERRAIN (يحلّ محلّ G_PHYSICAL_MAP) لعرض خريطة طبوغرافية استنادًا إلى معلومات التضاريس

في ما يلي مثال على الإصدارَين 2 و3 اللذَين يضبطان الخريطة على عرض التضاريس:

map.setMapType(G_PHYSICAL_MAP);
    

map.setMapTypeId(google.maps.MapTypeId.TERRAIN);
    

أجرت الإصدار 3 من واجهة برمجة التطبيقات JavaScript لـ "خرائط Google" بعض التغييرات على أنواع الخريطة الأقل شيوعًا أيضًا:

• لا تتوفّر أجزاء الخريطة الخاصة بالأجسام السماوية غير الأرض كأنواع خرائط في واجهة برمجة التطبيقات من الإصدار 3، ولكن يمكن الوصول إليها كأنواع خرائط مخصّصة كما هو موضّح في هذا المثال.
• لا يتوفّر نوع خريطة خاص في الإصدار 3 ليحلّ محل نوع G_SATELLITE_3D_MAP من الإصدار 2. بدلاً من ذلك، يمكنك دمج المكوّن الإضافي Google Earth في خرائط الإصدار 3 باستخدام هذه المكتبة.

صور بدرجة التكبير/التصغير القصوى

لا تتوفّر صور الأقمار الصناعية دائمًا عند مستويات التكبير أو التصغير العالية. إذا أردت معرفة أعلى مستوى تكبير متاح قبل ضبط مستوى التكبير، استخدِم فئة google.maps.MaxZoomService. تحلّ هذه الفئة محل طريقة GMapType.getMaxZoomAtLatLng() من الإصدار 2.

var point = new GLatLng(
    180 * Math.random() - 90, 360 * Math.random() - 180);
var map = new GMap2(document.getElementById("map"));
map.setUIToDefault();
map.setCenter(point);
map.setMapType(G_HYBRID_MAP);

map.getCurrentMapType().getMaxZoomAtLatLng(point,
  function(response) {
    if (response.status) {
      map.setZoom(response.zoom);
    } else {
      alert("Error in Max Zoom Service.");
    }
});

var myLatlng = new google.maps.LatLng(
    180 * Math.random() - 90, 360 * Math.random() - 180);
var map = new google.maps.Map(
  document.getElementById("map"),{
    zoom: 0,
    center: myLatlng,
    mapTypeId: google.maps.MapTypeId.HYBRID
});
var maxZoomService = new google.maps.MaxZoomService();
maxZoomService.getMaxZoomAtLatLng(
  myLatlng,
  function(response) {
    if (response.status == google.maps.MaxZoomStatus.OK) {
      map.setZoom(response.zoom);
    } else {
      alert("Error in Max Zoom Service.");
    }
});

صور جوية من منظور

عند تفعيل الصور الجوية في الإصدار 3، تكون عناصر التحكّم مشابهة لعنصر التحكّم GLargeZoomControl3D في الإصدار 2، مع عنصر تحكّم إضافي للتدوير من خلال الاتجاهات المتوافقة.

يمكنك تتبُّع المدن التي تتوفّر فيها حاليًا صور بزاوية 45 درجة على هذه الخريطة. عندما تتوفّر صور بزاوية 45 درجة، تتم إضافة خيار قائمة فرعية إلى زر "القمر الصناعي" في Maps API.