تستخدم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android أنظمة الإحداثيات التالية:
- قيم خطوط الطول والعرض التي تشير إلى نقطة على الكرة الأرضية بشكل فريد تستخدم Google معيار النظام الجيوديسي العالمي WGS84.
- إحداثيات العالم، والتي تشير إلى نقطة على الخريطة بشكل فريد.
- إحداثيات البكسل، والتي تشير إلى بكسل معيّن على الخريطة عند مستوى تكبير معيّن
- إحداثيات المربّعات، والتي تشير إلى مربّع معيّن على الخريطة عند مستوى تكبير معيّن.
الإحداثيات العالمية
عندما تحتاج واجهة برمجة التطبيقات إلى ترجمة موقع جغرافي في العالم إلى موقع جغرافي على خريطة، فإنّها تترجم أولاً قيم خطوط العرض وخطوط الطول إلى إحداثيات عالمية. تستخدم واجهة برمجة التطبيقات إسقاط مركاتور لإجراء هذه الترجمة.
لتسهيل حساب إحداثيات وحدات البكسل (انظر أدناه)، نفترض أنّ الخريطة في مستوى التكبير 0 هي مربّع واحد بحجم المربّع الأساسي. بعد ذلك، نحدّد الإحداثيات العالمية بالنسبة إلى إحداثيات البكسل عند مستوى التكبير 0، باستخدام الإسقاط لتحويل خطوط العرض وخطوط الطول إلى مواضع البكسل على هذا المربّع الأساسي. هذا الإحداثي العالمي هو قيمة نقطة عائمة يتم قياسها من نقطة بداية إسقاط الخريطة إلى الموقع الجغرافي المحدّد. يُرجى العِلم أنّه بما أنّ هذه القيمة هي قيمة نقطة عائمة، قد تكون أكثر دقة من درجة الدقة الحالية لصورة الخريطة المعروضة. بعبارة أخرى، يكون الإحداثي العالمي مستقلاً عن مستوى التكبير الحالي.
يتم قياس الإحداثيات العالمية في "خرائط Google" من نقطة الأصل لإسقاط مركاتور (الركن الشمالي الغربي من الخريطة عند خط طول 180 درجة وخط عرض 85 درجة تقريبًا) وتزداد في اتجاه x نحو الشرق (اليمين) وتزداد في اتجاه y نحو الجنوب (الأسفل). بما أنّ مربّع "خرائط Google" الأساسي لإسقاط مركاتور يبلغ 256 × 256 بكسل، فإنّ مساحة الإحداثيات العالمية القابلة للاستخدام هي {0-256}, {0-256}.
يُرجى العِلم أنّ إسقاط مركاتور له عرض محدود طوليًا ولكن ارتفاعه غير محدود عرضيًا. نحن نقتطع صور الخريطة الأساسية باستخدام إسقاط مركاتور عند حوالي +/- 85 درجة لجعل شكل الخريطة الناتج مربعًا، ما يتيح منطقًا أسهل لاختيار المربّعات. يُرجى العِلم أنّ الإسقاط قد ينتج عنه إحداثيات عالمية خارج مساحة الإحداثيات القابلة للاستخدام في الخريطة الأساسية إذا كنت ترسم بالقرب من القطبَين مثلاً.
إحداثيات البكسل
تشير إحداثيات البكسل إلى بكسل معيّن على الخريطة عند مستوى تكبير معيّن، بينما تعكس الإحداثيات العالمية المواقع الجغرافية المطلقة على إسقاط معيّن. يتم احتساب إحداثيات وحدات البكسل باستخدام الصيغة التالية:
pixelCoordinate = worldCoordinate * 2zoomLevel
من المعادلة أعلاه، يُرجى ملاحظة أنّ كل مستوى تكبير متزايد
يكون أكبر مرتين في كل من الاتجاهين x وy. وبالتالي، ينتج عن كل مستوى تكبير أعلى دقة أعلى بأربع مرات من المستوى السابق. على سبيل المثال، في مستوى التكبير 1، تتكوّن الخريطة من 4 مربّعات بحجم 256×256 بكسل، ما ينتج عنه مساحة بكسل تبلغ 512×512. عند مستوى التكبير 19، يمكن الإشارة إلى كل بكسل x وy على الخريطة باستخدام قيمة تتراوح بين 0 و256 * 219.
بما أنّنا استندنا في الإحداثيات العالمية إلى حجم مربّع الخريطة، فإنّ الجزء الصحيح من الإحداثيات البكسلية يحدّد البكسل الدقيق في ذلك الموقع الجغرافي ضمن مستوى التكبير الحالي. يُرجى العِلم أنّه بالنسبة إلى مستوى التكبير 0، تكون إحداثيات وحدات البكسل مساوية للإحداثيات العالمية.
تشير أنظمة الإحداثيات هذه بدقة إلى كل موقع جغرافي على الخريطة، عند كل
مستوى تكبير. تنشئ حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android إطار عرض استنادًا إلى مستوى التكبير،
ومركز الخريطة كـ LatLng، وحجم عنصر DOM الذي يحتوي عليه،
وتحوّل مربّع الإحاطة هذا إلى إحداثيات بكسل. بعد ذلك، تحدّد واجهة برمجة التطبيقات منطقيًا جميع مربّعات الخريطة التي تقع ضمن حدود وحدات البكسل المحدّدة. يمكنك الإشارة إلى كل مربّع من مربّعات الخريطة هذه باستخدام إحداثيات المربّعات، ما يسهّل إلى حد كبير عرض صور الخريطة.
إحداثيات المربّعات
لا يمكن لواجهة برمجة التطبيقات تحميل جميع صور الخريطة في آنٍ واحد لمستويات التكبير الأعلى. بدلاً من ذلك، يتم تقسيم الصور في كل مستوى تكبير إلى مجموعة من مربّعات الخريطة، والتي يتم ترتيبها منطقيًا بترتيب يمكن لتطبيقك استخدامه. عندما يتم الانتقال في الخريطة إلى موقع جغرافي جديد أو مستوى تكبير جديد، تحدّد واجهة برمجة التطبيقات المربّعات التي تحتاج إليها باستخدام إحداثيات البكسل، ثم تحوّل هذه القيم إلى مجموعة من المربّعات لاستردادها. ويتم تحديد إحداثيات المربّعات باستخدام مخطط يسهّل تحديد المربّع الذي يحتوي على الصور لأي نقطة معيّنة.
يتم ترقيم المربّعات في "خرائط Google" من المصدر نفسه الذي يتم ترقيم وحدات البكسل منه. في تطبيق Google لإسقاط مركاتور، يكون المربّع الأصلي دائمًا في الركن الشمالي الغربي من الخريطة، مع زيادة قيم x من الغرب إلى الشرق وزيادة قيم y من الشمال إلى الجنوب. وتتم فهرسة المربّعات باستخدام إحداثيات x,y من نقطة الأصل هذه. على سبيل المثال، في مستوى التكبير 2، عندما يتم تقسيم الأرض إلى 16 مربّعًا، يمكن الإشارة إلى كل مربّع من خلال زوج x,y فريد:
يُرجى العلم أنّه من خلال قسمة إحداثيات البكسل على حجم المربّع (256) وأخذ الأجزاء الصحيحة من النتيجة، يمكنك الحصول على إحداثيات المربّع عند مستوى التكبير الحالي كمنتج ثانوي.
مثال
يعرض المثال التالي إحداثيات مدينة شيكاغو في ولاية إلينوي: قيم خطوط العرض/الطول والإحداثيات العالمية وإحداثيات البكسل وإحداثيات المربّعات. استخدِم عنصر التحكّم في التكبير/التصغير للاطّلاع على قيم الإحداثيات في مستويات تكبير/تصغير مختلفة.
لمعرفة كيفية احتساب الإحداثيات، يمكنك الاطّلاع على الرمز.