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

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

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

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

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

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

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

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

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

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

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

كيف يمكنني تقليل وقت الاستجابة في 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 زيورخ، سويسرا". 
    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