معلمات عنوان URL لواجهة برمجة تطبيقات JavaScript للخرائط

يناقش هذا المستند جميع المعلمات التي يمكنك تحديدها في سلسلة طلب البحث لعنوان URL لتحميل النص البرمجي عند تحميل واجهة برمجة تطبيقات JavaScript للخرائط. بعض المعلمات مطلوبة بينما تكون المعلمات الأخرى اختيارية. كما هو معتاد في عناوين URL، يتم فصل جميع المعلمات باستخدام رمز العطف اللاتيني (&).

يحتوي مثال عنوان URL التالي على عناصر نائبة لجميع المعلمات الممكنة:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

يعمل عنوان URL في المثال script على تحميل واجهة برمجة تطبيقات JavaScript للخرائط:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

المعلمات المطلوبة

المعلمات التالية مطلوبة عند تحميل واجهة برمجة تطبيقات JavaScript للخرائط.

  • key: مفتاح واجهة برمجة التطبيقات لن يتم تحميل واجهة برمجة تطبيقات JavaScript للخرائط ما لم يتم تحديد مفتاح واجهة برمجة تطبيقات صالح.

  • callback: اسم دالة عمومية سيتم استدعاؤها بعد تحميل واجهة برمجة تطبيقات JavaScript للخرائط بالكامل.

المعلمات الاختيارية

استخدم هذه المعلمات لطلب إصدار محدد من واجهة برمجة تطبيقات جافا سكريبت للخرائط، أو تحميل مكتبات إضافية، أو تعيين خريطتك أو تحديد سياسة فحص مُحيل HTTP

  • v: إصدار واجهة برمجة تطبيقات JavaScript للخرائط.

  • libraries: قائمة مفصولة بفواصل تتضمن المكتبات الإضافية لواجهة برمجة تطبيقات JavaScript المطلوب تحميلها

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

  • region: رمز المنطقة المطلوب استخدامه. يؤدي هذا إلى تغيير سلوك الخريطة استنادًا إلى بلد أو إقليم معين.

  • solution_channel: يوفّر Google Maps Platform أنواعًا عديدة من نماذج الرموز البرمجية لمساعدتك في تنفيذ الخطوات الأولى بسرعة. لتتبع استخدام نماذج الرموز الأكثر تعقيدًا وتحسين جودة الحلول، تُدرج Google معلمة طلب البحث solution_channel في طلبات البيانات من واجهة برمجة التطبيقات في نموذج التعليمات البرمجية.

  • auth_referrer_policy: يمكن لعملاء JavaScript JS ضبط قيود مُحيل HTTP في Cloud Console لتحديد عناوين URL المسموح لها باستخدام مفتاح واجهة برمجة تطبيقات معيّن. بشكل افتراضي، يمكن تهيئة هذه القيود للسماح لمسارات معينة فقط باستخدام مفتاح واجهة برمجة التطبيقات. إذا كان أي عنوان URL على النطاق أو الأصل نفسه قد يستخدم مفتاح واجهة برمجة التطبيقات، يمكنك ضبط auth_referrer_policy=origin للحدّ من كمية البيانات المرسَلة عند تفويض الطلبات من واجهة برمجة تطبيقات JavaScript للخرائط. تتوفر هذه الميزة بدءًا من الإصدار 3.46. عند تحديد هذه المعلمة وتفعيل قيود مُحيل HTTP على Cloud Console، لن تتمكن واجهة برمجة تطبيقات JavaScript للخرائط من التحميل إلا في حال وجود تقييد لمُحيل HTTP يتطابق مع نطاق موقع الويب الحالي بدون مسار محدد.