واجهة برمجة التطبيقات Map Tiles API في مرحلة المعاينة حاليًا (ما قبل التوفّر للجمهور العام). قد يكون دعم المنتجات والميزات قبل التوفّر للجمهور العام محدودًا، وقد لا تتوافق التغييرات التي تطرأ على منتجات وميزات مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يمكنك الاطّلاع على أوصاف مرحلة الإطلاق.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Switch to English

نظرة عامة على "المربّعات الثنائية الأبعاد"

مثال على خارطة الطريق مربّعات الخريطة هي ببساطة تقسيم العالم إلى شبكة مفهرسة. ويتيح لك ذلك الوصول إلى بيانات الخرائط واستخدامها بكفاءة وديناميكية على مقاييس رسم خرائط متعددة. تتيح لك واجهة Map Tiles API إمكانية الوصول إلى مجموعات بيانات جغرافية متعدّدة مواضيعية، بما في ذلك البيانات التي نظّمها محرّك بحث Google:

مربعات صورة خارطة الطريق استنادًا إلى البيانات الطبوغرافية المتجهة إلى الرسم التخطيطي لـ Google.
ميزة "صور تقويمية" تم التقاطها بواسطة كل من كاميرات الأقمار الصناعية والكاميرات المحمولة والتي تعرض صورًا للأرض من الأعلى إلى الأسفل.
خرائط خطوط التلال.

جميع مربعات الخرائط ثنائية الأبعاد محددة جغرافيًا ومحاذاتها مع بعضها البعض. يتم تحديدها استنادًا إلى الامتداد الجغرافي لإطار العرض ومستوى التكبير/التصغير. تتراوح مستويات التكبير أو التصغير من صفر (لعرض العالم بكامله) إلى 22 (لعرض الشوارع والمباني).

مظاهر الخريطة

يمكنك الحصول على مربعات الخرائط لمظاهر الخرائط التالية.

مظهر الخريطة	الوصف
خارطة الطريق	الطرق والمباني ونقاط الاهتمام والحدود السياسية
القمر الصناعي	صور فوتوغرافية تم التقاطها من الفضاء
التضاريس	خريطة مخططة توضح الميزات الطبيعية، مثل النباتات

لطلب مربعات الخرائط من API Tiles API، يجب أولاً طلب رمز مميز للجلسة. يتتبع الرمز المميز للجلسة الحالة الحالية لخريطتك وإطار العرض. عند إعداد الرمز المميز لجلستك، يجب عليك تحديد القيمة mapType لمطابقة مظهر الخريطة الذي تريده. بعد ذلك، يجب تضمين الرمز المميز للجلسة في كل طلب من طلباتك إلى Map Tiles API.

طلبات معلومات إطار العرض

يحدد إطار العرض حجم المربع الذي يشكل إطارًا للمشهد العالمي. تعرض طلبات معلومات إطار العرض تفاصيل حول مربعات الخريطة التي تشكل إطار العرض الحالي. السبب في طلب معلومات إطار العرض هو ضمان تجنب طلب الصور بمستويات تكبير/تصغير غير موجودة.

على سبيل المثال، تمتلك معظم المدن صورًا عند مستوى التكبير/التصغير 22، ولكن ليس للمحيط حيث سينتهي بها الأمر بعرض مربعات زرقاء عديمة الميزات.

طلب إطار العرض هو طلب HTTPS GET في النموذج التالي.

curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&zoom=zoom&north=north&south=south&east=east&west=west"

ويحتوي الطلب على الحقول التالية:

zoom: مستوى تكبير/تصغير إطار العرض
north وsouth وeast وwest: نقاط أقصى شمال وجنوب وشرق وغرب في إطار العرض، ويتم التعبير عنها بالدرجات. يجب أن يكون الشمال والجنوب في النطاق (-90,90)، ويجب أن يكون الشرق والغرب في النطاق (-180، 180). للتعبير عن الحدود التي تعبر خط الطول والعرض، يمكن أن يكون الغرب إيجابيًا (على سبيل المثال، 170) ويمكن أن يكون الشرق سالبًا (على سبيل المثال، -170). جميع المعلَمات مطلوبة.

استجابات معلومات إطار العرض

وتوضّح لك استجابة إطار العرض المناطق التي تحتوي على صور ومستويات التكبير أو التصغير. يحتوي الرد على معلومات إطار العرض على النموذج التالي.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    {
      "maxZoom": 9,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    {
      "maxZoom": 14,
      "north": 84.375,
      "south": -84.375,
      "east": 180,
      "west": -180
    }, ...
  ]
}

يحتوي نص الاستجابة على الحقول التالية.

copyright: تحتوي على سلسلة إحالة يجب عرضها على خريطتك عند عرض خارطة الطريق ومربّعات الأقمار الصناعية. لمزيد من المعلومات، اطّلِع على سياسات Map Tiles API.
maxZoomRect: تحتوي على صفيف من المستطيلات الإحاطة التي تتداخل مع إطار العرض الحالي. يحتوي أيضًا على الحد الأقصى لمستوى التكبير/التصغير المتاح داخل كل مستطيل.

دوال إحداثيات المربعات

تتوفر الأدوات (الدوال البسيطة) في معظم لغات البرمجة للتحويل من أزواج خطوط الطول/العرض إلى إحداثيات المربعات عند مستوى تكبير/تصغير محدد. ضع في الاعتبار مثال رمز JavaScript التالي الذي يتم فيه التحويل أولاً من latLng إلى نقطة، ثم من نقطة إلى إحداثيات مربعة.

var TILE_SIZE = 256;

function fromLatLngToPoint(latLng) {
  var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
  return {
    x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
    y: TILE_SIZE / 2 * (1 +  mercator / Math.PI)
  };
}

function fromLatLngToTileCoord(latLng, zoom) {
  var point = fromLatLngToPoint(latLng);
  var scale = Math.pow(2, zoom);

  return {
    x: Math.floor(point.x * scale / TILE_SIZE),
    y: Math.floor(point.y * scale / TILE_SIZE),
    z: zoom
  };
}