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