مؤشر المنطقة الجغرافية

نقطة على الخريطة

قد يمثل إحداثيات متوقعة.

x في [-1، 1]. اتجاه المحور طبيعي: تنمو ص باتجاه الشمال، بينما تنمو x باتجاه الشرق. (0، 0) هو مركز الخريطة.

راجِع GMSProject() وGMSUnproject().

عرض coordinate على الخريطة.

يجب أن تكون السمة coordinate صالحة.

إلغاء مشاريع point من الخريطة.

يجب أن تكون النقطة (point.x) في [ -1, 1].

عرض نقطة مستقراءة خطيًا في المقطع [a, b]، عند الكسر t من a.

t==0 يتجاوب مع a، t==1 يتجاوب مع b.

تتم عملية الاستكمال على طول المسار القصير بين النقاط التي يُحتمل أن تتجاوز خط التاريخ. مثلاً: الاستقراء الداخلي من سان فرانسيسكو إلى طوكيو سوف يمر شمال هاواي ويعبر خط التاريخ.

لعرض طول الجزء [a, b] في المساحة المتوقعة.

يتم حساب الطول على طول المسار القصير بين النقاط التي يُحتمل أن تتجاوز خط التاريخ. مثلاً: تقيس المسافة بين النقطتين المقابلتين سان فرانسيسكو وطوكيو الجزء الذي يمر شمال هاواي ويعبر خط التاريخ.

يعرض ما إذا كان point يقع داخل المسار.

يُعتبَر المسار دائمًا مغلقًا، بصرف النظر عمّا إذا كانت النقطة الأخيرة تساوي أول نقطة أم لا.

يُعرف الجزء الداخلي على أنّه لا يحتوي على القطب الجنوبي، ولكنّ القطب الجنوبي يكون بالخارج دائمًا.

تصف السمة path أجزاء الدائرة الكبيرة إذا كانت القيمة geodesic هي "نعم"، والأجزاء ذات الريمكسات (loxodromic) بخلاف ذلك.

إذا كانت point تساوي تمامًا أحد رؤوس الزوايا، فإن النتيجة هي نعم. توجد نقطة لا تساوي رأسًا على جانب واحد أو الآخر من أي جزء مسار - ولا يمكن أبدًا أن تكون "بالضبط على الحد".

راجع GMSGeometryIsLocationOnPath() لإجراء اختبار حدود باستخدام مقدار التفاوت.

لعرض ما إذا كان point يقع في path أو بالقرب منه، في نطاق tolerance المحدد بالأمتار.

تتكون path من قطاعات دائرة كبيرة إذا كانت geodesic هي YES، ومن الأجزاء غير اللاصقة (الملتوية) إذا كانت geodesic NO.

راجِع أيضًا GMSGeometryIsLocationOnPath(point, path, geodesic).

ويختلف نطاق التفاوت بالمتر عن نصف القطر الكروي للأرض. إذا كنت بحاجة إلى العمل على كرة ذات نصف قطر مختلف، يمكنك حساب مقدار التفاوت المكافئ من مقدار التفاوت المطلوب في مجال نصف القطر R: التفاوت = toleranceR * (Radius Earth / R)، مع Radius Earth==6371009.

مثل GMSGeometryIsLocationOnPath(point, path, geodesic, tolerance)، مع تفاوت تلقائي يبلغ 0.1 متر.

لعرض مسافة الدائرة الكبيرة بين إحداثيتين، بالمتر، على Earth.

هذه هي أقصر مسافة بين الإحداثيات على الكرة.

يجب أن تكون كلتا الإحداثيتين صالحتين.

لعرض طول الدائرة الكبير path بالمتر على الأرض.

هذا هو مجموع GMSGeometryDistance() على أجزاء المسار.

يجب أن تكون جميع إحداثيات المسار صالحة.

تعرض مساحة مضلّع جيوديسي محدّد بواسطة path على Earth.

"الداخل" المضلّع لا يحتوي على القطب الجنوبي.

إذا لم يتم إغلاق path، يتم التعامل معه ضمنيًا على أنّه مسار مغلق على الرغم من ذلك، وتكون النتيجة هي نفسها.

يجب أن تكون جميع إحداثيات المسار صالحة.

يجب أن يكون المضلّع بسيطًا (غير متداخل ذاتيًا) وقد يكون مقعرًا.

إذا كان أي جزء من المسار عبارة عن زوج من النقاط المضادة للضوء، تكون النتيجة غير محددة -- لأن نقطتي الأضلاع لا تشكلان قطعة فريدة للدائرة الكبيرة على الكرة.

تعرض المنطقة الموقَّعة لمضلّع جيوديسي تم تحديده من خلال path على Earth.

تكون للنتيجة القيمة المطلقة نفسها مثل GMSGeometryArea()؛ يكون موجبة إذا كانت نقاط المسار بترتيب عكس عقارب الساعة، وسالبة بخلاف ذلك.

تنطبق القيود نفسها التي تنطبق على GMSGeometryArea().

عرض العنوان الأولي (بالدرجات في اتجاه عقارب الساعة من الشمال) عند from من أقصر مسار إلى to.

تقع القيمة المعروضة في النطاق [0, 360).

تعرض 0 إذا كانت الإحداثيات متطابقة.

يجب أن تكون كلتا الإحداثيتين صالحتين.

للحصول على العنوان النهائي في to، يمكن للمرء استخدام (GMSGeometryHeading(to, from) + 180) modulo 360.

لعرض إحداثي الوجهة، عند البدء في from بحرف heading، مع السفر لمسافة distance متر على قوس دائري كبير، على الأرض.

خط الطول الناتج يقع في النطاق [ -180، 180).

يجب أن تكون كلتا الإحداثيتين صالحتين.

لعرض الإحداثي الذي يقع في fraction المحدد بين الإحداثيي from وto على أقصر مسار بينهما.

خط الطول الناتج يقع في النطاق [ -180، 180).

تعرض NSArray لـ GMSStyleSpan تم إنشاؤها من خلال التطبيق المتكرر لمعلومات النمط والطول من styles وlengths على path.

path المسار الذي يتم حساب امتدادات الإخراج على طوله. styles NSArray لـ GMSStrokeStyle لفائف عند استهلاكها. لا يمكن أن يكون هذا الحقل فارغًا. lengths NSArray لـ NSNumber؛ حيث يعطي كل إدخال طول النمط المقابل من styles. لفائف عند استهلاكها. لا يمكن أن يكون هذا الحقل فارغًا. lengthKind تفسير القيم من lengths (الجيوديسية أو Rالهوم أو المتوقعة)

مثال: خط متعدد بامتدادات متبادلة بالأبيض والأسود:

 GMSMutablePath *path;
 NSArray *styles = @[[GMSStrokeStyle solidColor:[UIColor whiteColor]],
                     [GMSStrokeStyle solidColor:[UIColor blackColor]]];
 NSArray *lengths = @[@100000, @50000];
 polyline.path = path;
 polyline.spans = GMSStyleSpans(path, styles, lengths, kGMSLengthRhumb);
 

على غرار GMSStyleSpans(path, terms, lengths, lengthKind)، ولكن بالإضافة إلى ذلك، تأخذ إزاحة أولية للطول يتم تخطّيها بالنسبة إلى المصفوفة lengths.

lengthOffset الطول (على سبيل المثال بالأمتار) الذي يجب تخطّيه في البداية من lengths.