الأسئلة الشائعة عن الترميز الجغرافي

تتناول هذه الأسئلة الشائعة أسئلة خاصة بواجهة برمجة تطبيقات الترميز الجغرافي. يُرجى الرجوع إلى الأسئلة الشائعة حول "منصة خرائط Google" للاطّلاع على الأسئلة الشائعة حول جميع "منصة خرائط Google". راجِع أيضًا القسم أفضل الممارسات المتعلّقة بالترميز الجغرافي للعناوين.

تحديد المشاكل وحلّها

تحديد المشاكل وحلّها

أحصل على المزيد من طلبات البحث التي تعرض ZERO_RESULTS مع الرمز الجغرافي. التحليل:

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

إذا كان تطبيقك يعالج البيانات التي أدخلها المستخدمون للعناوين، قد تقدّم ميزة الإكمال التلقائي لمكان في واجهة برمجة تطبيقات الأماكن نتائج ذات جودة أفضل. تسمح ميزة "الإكمال التلقائي" لـ "الأماكن" للمستخدمين بالاختيار من بين مجموعة من النتائج استنادًا إلى ما كتبوه، ما يسمح للمستخدمين بالاختيار من بين النتائج التي تحمل أسماء متشابهة، وتعديل طلب البحث إذا أخطأوا في كتابة العنوان.

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

أحتاج إلى ردود سريعة، كما أن أداة الترميز الجغرافي بطيئة جدًا بالنسبة إلى تطبيقي. ما الذي يمكنني استخدامه لتقديم ردود أسرع؟

ننصح التطبيقات التي تستجيب للبيانات التي يدخلها المستخدم، وبالتالي التي تكون حساسة جدًا لوقت الاستجابة، باستخدام ميزة الإكمال التلقائي للأماكن في Places API (متاحة أيضًا في JavaScript أو Android أو iOS) بدلاً من الترميز الجغرافي للعناوين. تم تحسين ميزة "الإكمال التلقائي" لميزة "الأماكن التلقائية" لاستخدامها بشكل تفاعلي، وبالتالي فهي تستغرق وقتًا طويلاً جدًا.

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

كيف يمكنني الحد من وقت الاستجابة في Directions API وواجهة برمجة تطبيقات مصفوفة المسافة؟

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

عند إجراء طلب بحث عن واجهة برمجة تطبيقات الاتجاهات أو واجهة برمجة تطبيقات مصفوفة المسافة باستخدام سلسلة عنوان بدلاً من رقم تعريف مكان أو خط الطول والعرض، يتم استخدام الواجهة الخلفية نفسها الخاصة بواجهة برمجة التطبيقات الخاصة بالترميز الجغرافي لتحويل هذا العنوان إلى رقم تعريف مكان قبل احتساب الاتجاهات. إنّ ميزة "الإكمال التلقائي" لـ "الأماكن" أسرع من الترميز الجغرافي للعناوين. بالنسبة إلى التطبيقات التي تستخدم واجهة برمجة التطبيقات للاتجاهات أو واجهة برمجة التطبيقات لمصفوفة المسافات في المواقف الحسّاسة للغاية، مثل الاستجابة للبيانات التي أدخلها المستخدم، ننصحك باستخدام ميزة "الإكمال التلقائي" للحصول على أرقام تعريف الأماكن المتوافقة مع تلك العناوين، وتمرير معرّفات الأماكن إلى واجهة برمجة التطبيقات للاتجاهات أو واجهة برمجة التطبيقات لمصفوفة المسافات. تقلّل هذه الطريقة من وقت الاستجابة بشكلٍ كبير. راجِع مستنداتنا للاطّلاع على مثال على كيفية استخدام الإكمال التلقائي للأماكن مع الاتجاهات.

كيف يمكنني الإبلاغ عن الأخطاء في أداة الترميز الجغرافي؟

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

لا يقدم أداة الترميز الجغرافي نتائج جيدة لحالة الاستخدام التي أستخدمها. كيف يمكن الحصول على المساعدة؟

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

كيف يمكنني الحصول على أفضل النتائج باستخدام أداة الترميز الجغرافي باستخدام تصفية المكوّنات؟

في أداة الترميز الجغرافي، لا تفرض فلترة المكوّنات سوى قيود postal_code وcountry فقط. توضّح الأمثلة التالية أفضل طريقة لاستخدام فلترة المكوّنات، اعتمادًا على النتائج التي تريدها. في نماذج عناوين URL للطلب، تأكد من استبدال "YOUR_API_KEY" بمفتاح واجهة برمجة التطبيقات الفعلي.

  • لحصر الرموز البريدية ببلد معيّن، احرص على تحديد القيود المفروضة على البلد باستخدام رمز البلد ISO 3166-2. على سبيل المثال: تعرض السمة components=country:CH|postal_code:8000 "8000 زيورخ، سويسرا". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • لحصر طلبات البحث ببلد معيّن، احرص على تحديد القيود المفروضة على البلد باستخدام رمز البلد ISO 3166-2. لا نضمن أن تؤدي أسماء البلدان والاختصارات الأخرى إلى النتائج نفسها التي تنتج عن رموز البلدان.

    أمثلة:

    • يؤدي الترميز الجغرافي لـ components=country:FRA|locality:gallus إلى إرجاع المنطقة المحلية الفرعية Gallus في فرانكفورت أم ماين، ألمانيا. ويرجع ذلك إلى أنّ رمز البلد المؤلف من 3 أحرف لفرنسا (FRA) غير متاح، وبالتالي يمكن عرض النتائج في أي بلد، علمًا بأنّ النتيجة في فرانكفورت تناسب فرنسا بشكل أفضل من أي بلد آخر. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • لن تعرض واجهة برمجة التطبيقات للترميز الجغرافي بالضرورة نتائج متعددة لطلبات بحث غامضة. ويتم تقديم إجابات أفضل عن طلبات البحث هذه من خلال ميزة "الإكمال التلقائي" للمكان.

    أمثلة:

    • يعرض الترميز الجغرافي لـ components=country:US|locality:madrid عرض "مدريد، نيو ساوث ويلز 87010، الولايات المتحدة الأمريكية"، ولكن لا تظهر أي من المدن الأخرى في الولايات المتحدة التي تحمل اسم "مدريد". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • إنّ استخدام ميزة "الإكمال التلقائي" لميزة "الأماكن" في input=madrid&components=country:us&types=(regions)، وتحديد إطار عرض باستخدام الترميزَين location وradius لانحياز نتائج الموقع الجغرافي، يؤدي إلى إنشاء ردّ يتضمّن عدة مدن في الولايات المتحدة اسمها "مدريد". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY