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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    أمثلة:

    • الترميز الجغرافي لإرجاع components=country:US|locality:madrid "Madrid, NM 87010, USA" ولكن لم تدع أي من المدن الأخرى في الولايات المتحدة الأمريكية اسم "مدريد". 
      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