الترميز الجغرافي هو عملية تحويل العناوين (مثل عنوان الشارع) إلى إحداثيات جغرافية (خطوط الطول والعرض)، ويمكنك استخدامها لوضع العلامات على الخريطة أو تحديد موضع الخريطة. يركّز هذا المستند على توضيح الاعتبارات الواجب مراعاتها عند ترميز العناوين الجغرافية. وتوضّح هذه الإرشادات الحالات الأفضل لاستخدام واجهة برمجة التطبيقات للترميز الجغرافي والحالات التي يكون من المفيد فيها استخدام خدمة الإكمال التلقائي لميزة "الإكمال التلقائي" لواجهة برمجة تطبيقات الأماكن.
وبشكل عام، يمكنك استخدام واجهة برمجة تطبيقات الترميز الجغرافي عند إضافة رموز جغرافية إلى العناوين الكاملة (على سبيل المثال، "48 Pirrama Rd, Pyrmont, NSW, Australia"). استخدِم خدمة ميزة الإكمال التلقائي لواجهة برمجة تطبيقات الأماكن عند الترميز الجغرافي لعناوين غامضة (غير مكتملة) أو في التطبيقات التي تتأثر بوقت الاستجابة، مثلاً عند الردّ على البيانات التي أدخلها المستخدم.
حالات الاستخدام واقتراحات واجهة برمجة التطبيقات
| حالات الاستخدام واقتراحات واجهة برمجة التطبيقات | |
|---|---|
| الرد في الوقت الفعلي على إدخالات المستخدم (بما في ذلك العناوين الغامضة أو غير المكتملة أو المنسقة بشكل سيئ أو التي بها أخطاء إملائية والتي أدخلها المستخدم) | استخدِم خدمة الإكمال التلقائي لأماكن واجهة برمجة التطبيقات للحصول على رقم تعريف مكان، ثم واجهة برمجة التطبيقات للترميز الجغرافي لإنشاء معرّف المكان جغرافيًا. |
| معالجة الأنظمة الآلية للعناوين البريدية بالكامل بطريقة لا لبس فيها (على سبيل المثال، "48 شارع السلام، القاهرة، الرياض، نيو ساوث ويلز في أستراليا") | استخدام خدمة الويب لواجهة برمجة تطبيقات الترميز الجغرافي. |
| تعالج الأنظمة الآلية طلبات البحث الغامضة (على سبيل المثال، العناوين غير المكتملة أو المنسَّقة بشكل غير صحيح أو التي بها أخطاء إملائية) | ننصح بأن تستخدم الأنظمة الآلية خدمة الويب الخاصة بواجهة برمجة التطبيقات للترميز الجغرافي. في المقابل، قد تستفيد الأنظمة الآلية التي تسجّل نسبة عالية من طلبات البحث الغامضة أو غير المكتملة أو التي بها أخطاء إملائية المستمدة من إدخالات المستخدمين من إضافة أداة الإكمال التلقائي "الإكمال التلقائي" التفاعلية للسماح للمستخدمين باختيار نتيجة، وبالتالي تجنُّب الأخطاء الإملائية في العنوان. |
| مشاكل وقت الاستجابة باستخدام واجهة برمجة التطبيقات Directions API أو مصفوفة المسافة، مع تحديد المصادر أو الوجهات أو نقاط الطريق كسلاسل عناوين | يمكنك تقليل وقت استجابة الترميز الجغرافي عن طريق استخدام خدمة "الإكمال التلقائي" لمكان واجهة برمجة التطبيقات الخاصة بالأماكن للحصول على أرقام تعريف الأماكن، ثم تمرير معرّفات الأماكن إلى واجهة برمجة التطبيقات Directions API أو واجهة برمجة التطبيقات لمصفوفة المسافات. |
الاستجابة للبيانات التي أدخلها المستخدم
لدى التطبيقات التي تستجيب في الوقت الفعلي للبيانات التي يدخلها المستخدم اعتباران رئيسيان يؤثران في اختيار واجهة برمجة التطبيقات:
- وبشكل عام، تتضمّن البيانات التي يُدخلها المستخدمون العناوين تدريجيًا (على سبيل المثال، "123 الشارع الرئيسي")، لذلك فإن إمكانية ترميز العناوين غير كاملة والغامضة أمر مفيد لأنّ ذلك يتيح للمستخدم الحصول على النتيجة بشكل أسرع.
- تكون التطبيقات التي تستجيب للبيانات التي يدخلها المستخدم حسّاسة للغاية لوقت الاستجابة.
ويجعل هذان الاعتباران خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات الأماكن مثالية لحالات الاستخدام المتعلقة بالاستجابة للبيانات التي أدخلها المستخدم. صُممت ميزة "الإكمال التلقائي" لميزة "أماكن" لعرض خيارات متعددة محتملة وإتاحة الفرصة للمستخدم بالاختيار من بينها. يمكن تقييد واجهة برمجة تطبيقات الأماكن للبحث فقط عن الرموز الجغرافية أو العناوين مع استبعاد الأنشطة التجارية. علاوة على ذلك، يمكن انحياز وظيفة البحث ضمن ميزة الإكمال التلقائي لعرض نتائج خاصة بموقع جغرافي معيّن. تعرض واجهة برمجة تطبيقات الأماكن معرّف مكان يمكن تمريره كموقع مختلف تمامًا إلى خدمة الويب لواجهة برمجة تطبيقات الترميز الجغرافي، والتي تعرض بعد ذلك تفاصيل العنوان الكاملة وترميز العنوان جغرافيًا في خط الطول والعرض. يمكن أيضًا تمرير أرقام تعريف الأماكن إلى واجهات برمجة تطبيقات أخرى، مثل Directions API وواجهة برمجة تطبيقات مصفوفة المسافة (انظر أدناه).
إنّ وقت استجابة الترميز الجغرافي للعناوين في واجهة برمجة التطبيقات للترميز الجغرافي يؤدي إلى وقت استجابة أعلى بكثير، وينتج عنه أيضًا نتائج أقل دقة لطلبات البحث غير المكتملة أو الغامضة، لذلك لا يُنصح باستخدامه مع التطبيقات التي تستجيب في الوقت الفعلي للبيانات التي يُدخلها المستخدم.
يمكنك الحصول على مزيد من المعلومات حول خدمة الإكمال التلقائي للأماكن في Android وiOS وJavaScript و Places API.
أنظمة آلية
معالجة الأنظمة الآلية للعناوين البريدية الكاملة: من الأفضل معالجة طلبات البحث الواضحة، مثل سلاسل العناوين البريدية الكاملة (على سبيل المثال، " 48 Pirrama Rd, Pyrmont, NSW, Australia") من خلال خدمة الترميز الجغرافي لواجهة برمجة التطبيقات على الويب. توفّر الواجهة الخلفية لترميز المواقع الجغرافية للعناوين تغطية أكبر للعناوين على مستوى العالم، ويتم تحسينها للحصول على نتائج عالية الجودة باستخدام هذه الأنواع من طلبات البحث الكاملة وغير الغامضة.
معالجة النظام التلقائي لطلبات البحث الغامضة: طلبات البحث الغامضة هي تلك التي تحتوي على عناوين بتنسيق غير صحيح أو عناوين غير مكتملة أو أخطاء إملائية. بالنسبة إلى الأنظمة الآلية، ننصح باستخدام خدمة الويب الخاصة بواجهة برمجة التطبيقات Geocoding API. ومع ذلك، لم يتم تصميم واجهة برمجة تطبيقات الترميز الجغرافي للتعامل مع طلبات البحث الغامضة، وقد تؤدي إلى نتائج أقل دقة أو لا تؤدي إلى أي نتائج استجابةً لطلبات البحث الغامضة. إذا كان النظام التلقائي يعالج معدلاً كبيرًا من طلبات البحث الغامضة المشتقة من إدخالات المستخدمين، يمكنك الاستفادة من إضافة عنصر تفاعلي إلى تطبيقك باستخدام خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات الأماكن، إذ إنّه مصمم لعرض خيارات متعددة محتملة والسماح للمستخدم بالاختيار من بينها. تعرض واجهة برمجة تطبيقات الأماكن معرّف مكان يمكن تمريره كموقع مختلف تمامًا إلى خدمة الويب لواجهة برمجة تطبيقات الترميز الجغرافي، والذي يعرض بعد ذلك تفاصيل العنوان الكاملة وترميز العنوان الجغرافي إلى خط الطول والعرض. يمكنك الحصول على مزيد من المعلومات حول خدمة الإكمال التلقائي للأماكن في Android وiOS وJavaScript و Places API.
تقليل وقت الاستجابة لواجهة برمجة التطبيقات Directions API وواجهة برمجة التطبيقات لمصفوفة المسافات
عند تحديد المصادر أو الوجهات أو نقاط الطريق كسلاسل عناوين، تستخدم واجهة برمجة التطبيقات Directions API و واجهة برمجة تطبيقات مصفوفة المسافة الخلفية نفسها المستخدَمة في واجهة برمجة التطبيقات للترميز الجغرافي بهدف ترميز هذه العناوين جغرافيًا قبل احتساب الاتجاهات. ويؤدي ذلك إلى زيادة وقت الاستجابة بشكل كبير مقارنةً بتحديد المواقع الجغرافية نفسها لخطوط الطول والعرض أو أرقام تعريف الأماكن.
إذا كان تطبيقك يستخدم واجهة برمجة تطبيقات الاتجاهات أو واجهة برمجة تطبيقات مصفوفة المسافة في موقف حسّاس لوقت الاستجابة، مثل الاستجابة للبيانات التي أدخلها المستخدم، وإذا كانت المصادر أو الوجهات أو نقاط الطرق قد تم تحديدها بشكل مبدئي كسلاسل عناوين، ننصحك بتقليل وقت الاستجابة عن طريق استخدام خدمة الإكمال التلقائي للأماكن من واجهة Places API لتحويل سلاسل العناوين إلى معرّفات الأماكن، ثم تمرير أرقام تعريف الأماكن إلى واجهة برمجة التطبيقات Directions API أو واجهة برمجة التطبيقات لمصفوفة المسافات. يمكنك الحصول على مزيد من المعلومات حول خدمة الإكمال التلقائي للأماكن في Android وiOS وJavaScript و Places API. اطّلِع أيضًا على مثال JavaScript للإكمال التلقائي لمكان والاتجاهات.
الخاتمة
بالاستناد إلى حالة استخدامك، وعند ترميز العناوين الجغرافية، يتيح لك استخدام واجهة برمجة تطبيقات الترميز الجغرافي أو خدمة "الإكمال التلقائي لمكان " مع واجهة برمجة التطبيقات للترميز الجغرافي إنشاء تطبيقات تقدّم للمستخدمين نتائج ترميز جغرافي دقيقة بالإضافة إلى تقليل وقت الاستجابة.
إدارة الأخطاء وإعادة المحاولة
إذا تلقّيت UNKNOWN_ERROR ردود، يكون ذلك بسبب أخطاء عابرة
ومن الأفضل إعادة المحاولة بعد مهلة قصيرة. ننصحك بالاستفادة من
مكتبات العملاء لخدمات "منصة خرائط Google" على الويب التي تتضمّن إعادة المحاولة المنطقية وإتاحة مصادقة الخطة المميّزة
لمنصة خرائط Google.
Java Client
وPython Client
وGo Client
وNode.js Client
لخدمات "خرائط Google" هي مكتبات عملاء متوافقة مع المنتدى، ومتاحة للتنزيل
والمساهمات على GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت
ونموذج للرموز.
إذا تلقّيت رمز حالة OVER_QUERY_LIMIT كاستجابة، يعني هذا أنّك
تجاوزت حدود الاستخدام لواجهة برمجة التطبيقات. ننصحك
بتجربة
استراتيجيات تحسين الاستخدام هذه.