تتناول هذه الأسئلة الشائعة أسئلة حول واجهة برمجة تطبيقات الترميز الجغرافي. يُرجى الرجوع إلى الأسئلة الشائعة حول "منصة خرائط Google" للاطّلاع على الأسئلة الشائعة حول "منصة خرائط Google ". يمكنك الاطّلاع أيضًا على أفضل الممارسات عند ترميز العناوين الجغرافية.
تحديد المشاكل وحلّها
- أتلقّى المزيد من طلبات البحث التي تؤدي إلى عرض ZERO_RESULTS باستخدام أداة ترميز البيانات. التحليل:
- أحتاج إلى ردود سريعة، وأداة الترميز بطيئة جدًا بالنسبة إلى تطبيقي. كيف يمكنني استخدام الردود السريعة؟
- كيف يمكنني تقليل وقت الاستجابة في واجهة برمجة تطبيقات الاتجاهات و واجهة برمجة تطبيقات مصفوفة المصفوفة؟
- أنا عميل خطة مميّزة و واجهة برمجة تطبيقات الأماكن باهظة الثمن. ما الذي يمكنني فعله لخفض التكاليف؟
- كيف يمكنني الإبلاغ عن أخطاء في أداة ترميز البيانات؟
- لا تؤدي أداة ترميز البيانات إلى تحقيق نتائج جيدة لحالة الاستخدام. ما هي المساعدة المتوفّرة؟
- كيف يمكنني الحصول على أفضل النتائج باستخدام أداة الترميز باستخدام فلترة المكوّنات؟
تحديد المشاكل وحلّها
- أتلقّى المزيد من طلبات البحث التي تؤدي إلى عرض ZERO_RESULTS باستخدام أداة ترميز البيانات. التحليل:
-
في أداة الترميز الجغرافي، تكون طلبات البحث الغامضة أو غير المكتملة أو التي تم تنسيقها بشكلٍ سيئ، مثل العناوين التي بها أخطاء إملائية أو غير موجودة، عرضةً لخطأ ZERO_RESULTS. في حال تعذّر العثور على العنوان، من المفضّل ZERO_RESULTS إلى نتيجة جزئية (على سبيل المثال، عرض الضواحي فقط بدلاً من العنوان).
إذا كان تطبيقك يتعامل مع إدخالات المستخدمين للعناوين، قد تعرض ميزة الإكمال التلقائي للأماكن في الأماكن API نتائج أفضل. تسمح ميزة "الإكمال التلقائي" للأماكن للمستخدمين بالاختيار من بين مجموعة من النتائج بناءً على ما يكتبونه، ما يتيح للمستخدمين الاختيار بين النتائج التي تحمل أسماء متشابهة، وتعديل طلبات البحث في حال كتابة عنوان بشكل خاطئ.
إذا كان لديك تطبيق يتعامل مع طلبات البحث أو طلبات البحث الغامضة أو غير المكتملة التي قد تحتوي على أخطاء، ننصحك باستخدام ميزة الإكمال التلقائي في واجهة برمجة تطبيقات الأماكن بدلاً من أداة الترميز المستقبلية المتاحة في واجهة برمجة التطبيقات لترميز المواقع الجغرافية. للحصول على مزيد من التفاصيل، اطّلِع على أفضل الممارسات عند ترميز العناوين الجغرافية و ترميز المواقع الجغرافية في العناوين ضمن مشاركة مدوّنة واجهات برمجة التطبيقات في "خرائط Google"..
- أحتاج إلى ردود سريعة، وأداة الترميز بطيئة جدًا بالنسبة إلى تطبيقي. كيف يمكنني استخدام الردود السريعة؟
-
ننصح التطبيقات التي تستجيب لإدخال المستخدم، وبالتالي حساسة جدًا بوقت الاستجابة، باستخدام ميزة الإكمال التلقائي في "واجهة برمجة تطبيقات الأماكن" (متاحة أيضًا في JavaScript أو Android أو iOS) بدلاً من استخدام الترميز الجغرافي. تم تحسين ميزة "الإكمال التلقائي" للأماكن من أجل استخدامها بشكل تفاعلي، وبالتالي لديها وقت استجابة منخفض جدًا.
تم تحسين ترميز الموقع الجغرافي في واجهة برمجة التطبيقات الخاصة بالترميز الجغرافي للاستخدام مع عناوين كاملة وغير واضحة ومنسّقة بشكل جيد، مثل عناوين التسليم التي تم إدخالها في النماذج على الإنترنت، وبالتالي يكون وقت الاستجابة أطول مقارنةً بإكمال الإكمال التلقائي للأماكن. يحظى برنامج ترميز الترميز الأمامي بتغطية أكبر وجودة أفضل للنتائج، ولكن مع وقت استجابة أعلى إلى حد ما.
- كيف يمكنني تقليل وقت الاستجابة في واجهة برمجة تطبيقات الاتجاهات و مصفوفة مصفوفة واجهة برمجة التطبيقات؟
-
بدلاً من استخدام العناوين، استخدِم أرقام تعريف الأماكن لتحديد نقاط المسار ونقطة الانطلاق والوجهة. يتم الحصول على معرّفات الأماكن على أفضل نحو من خلال ميزة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات الأماكن أو مكتبة الأماكن في واجهة برمجة تطبيقات JavaScript للخرائط. يمكنك أيضًا الاطّلاع على المعلومات المتاحة في
placeIdOnly
التي يمكن استخدامها لتقليل تكلفة الإكمال التلقائي للأماكن.عند الاستعلام عن واجهة برمجة تطبيقات الاتجاهات أو واجهة برمجة التطبيقات لمصفوفة المسافة باستخدام سلسلة عناوين بدلاً من رقم تعريف المكان أو خط العرض، فإنها تستخدم الخلفية نفسها مثل واجهة برمجة التطبيقات للترميز الجغرافي لتحويل هذا العنوان إلى رقم تعريف مكان قبل احتساب الاتجاهات. إنّ ميزة "الإكمال التلقائي" للأماكن أسرع من الترميز الجغرافي للعنوان. بالنسبة إلى التطبيقات التي تستخدم 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
منطقة "غالوس" الفرعية في "فرانكفورت أم ماين" في ألمانيا. ويرجع ذلك إلى أنّ رمز البلد المكوّن من 3 أحرف لفرنسا (FRA) غير متاح، لذا يُسمَح بعرض النتائج في أي بلد، ونتيجةً لذلك، يُعدّ البحث في فرانكفورت مناسبًا أكثر من أي مكان في فرنسا.https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
- يعرض الموقع الجغرافي لـ
- ولن تؤدي واجهة برمجة التطبيقات للترميز الجغرافي بالضرورة إلى عرض نتائج متعددة لطلبات البحث الغامضة. وتتم الإجابة عن مثل هذه الطلبات بشكل أفضل من خلال الإكمال التلقائي للأماكن.
أمثلة:
- يعرِض الترميز الجغرافي لـ
components=country:US|locality:madrid
سياسة "Madrid وNM 87010, USA"، ولا تتضمّن أي من المدن الأخرى في الولايات المتحدة اسمًا "Madrid".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
من أجل الانحياز إلى نتائج الموقع الجغرافي، يؤدي إلى إنشاء استجابة بعدة مدن في الولايات المتحدة الأمريكية باسم "Madrid".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
- يعرِض الترميز الجغرافي لـ
- لحصر الرموز البريدية ببلد محدد، احرص على تحديد القيود المفروضة على البلدان
باستخدام رمز بلد وفق المعيار ISO 3166-2.
على سبيل المثال: