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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

  • مربّعات صور خريطة الطريق استنادًا إلى بيانات طبوغرافية متجهة مع تصميمات خرائط Google

  • الصور العمودية الملتقَطة بواسطة الأقمار الصناعية والكاميرات المحمولة جوًا والتي توفّر صورًا من الأعلى (نقطة سمت) للأرض

  • خرائط خطوط الظل

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

مواضيع الخرائط

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

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

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

طلبات الحصول على معلومات إطار العرض

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

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

طلب إطار العرض هو طلب استرداد بيانات باستخدام GET عبر HTTPS بالشكل التالي.

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
  };
}