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

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

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

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

أحصل على المزيد من طلبات البحث التي تعرض ZERO_RESULTS باستخدام أداة الترميز الجغرافي. ما هي المشكلة؟

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

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

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

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

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

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

كيف يمكنني تقليل وقت الاستجابة في واجهة Directions API (الإصدار القديم) وواجهة Distance Matrix API (الإصدار القديم)؟

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

عندما يتم إرسال طلب بحث إلى Directions API (الإصدار القديم) أو Distance Matrix API (الإصدار القديم) باستخدام سلسلة عناوين بدلاً من رقم تعريف المكان أو خطوط عرض وطول، تستخدم واجهة برمجة التطبيقات الخلفية نفسها التي تستخدمها Geocoding API لتحويل هذا العنوان إلى رقم تعريف المكان قبل احتساب الاتجاهات. تكون ميزة "الإكمال التلقائي للأماكن" أسرع من الترميز الجغرافي للعناوين. بالنسبة إلى التطبيقات التي تستخدم Directions API (الإصدار القديم) أو Distance Matrix API (الإصدار القديم) في الحالات التي تتطلّب سرعة استجابة عالية، مثل الاستجابة لبيانات أدخلها المستخدم، ننصحك باستخدام الإكمال التلقائي للأماكن للحصول على أرقام تعريف الأماكن المتوافقة مع تلك العناوين، وتمرير أرقام تعريف الأماكن إلى Directions API (الإصدار القديم) أو Distance Matrix API (الإصدار القديم). يقلّل هذا النهج من وقت الاستجابة بشكل كبير. يمكنك الاطّلاع على مستنداتنا للحصول على مثال على كيفية استخدام ميزة "الإكمال التلقائي للأماكن" مع الاتجاهات.

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

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

لا يعرض برنامج الترميز الجغرافي نتائج جيدة لحالة الاستخدام الخاصة بي. ما هي المساعدة المتاحة؟

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

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

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

  • لحصر الرموز البريدية ببلد معيّن، احرص على تحديد القيود المفروضة على البلدان باستخدام رمز البلد ISO 3166-2. على سبيل المثال: تعرض components=country:CH|postal_code:8000 القيمة "8000 Zürich, Switzerland". 
    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
  • لن تعرض Geocoding API بالضرورة نتائج متعدّدة لطلبات البحث الغامضة. ويتم الرد على هذه الطلبات بشكل أفضل من خلال ميزة "الإكمال التلقائي للأماكن".

    أمثلة:

    • يؤدي الترميز الجغرافي لـ 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