פרמטרים של כתובת URL עבור JavaScript ב-Maps

המסמך הזה דן בכל הפרמטרים שניתן לציין במחרוזת השאילתה של כתובת ה-URL לטעינת סקריפט במהלך טעינת API JavaScript של מפות Google. חלק מהפרמטרים נדרשים, ואילו אחרים הם אופציונליים. כמו בכל כתובת URL, כל הפרמטרים מופרדים באמצעות תו אמפרסנד (&).

בכתובת ה-URL לדוגמה הבאה יש ערכי placeholder לכל הפרמטרים האפשריים:

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 JavaScript API:

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

פרמטרים נדרשים

הפרמטרים הבאים נדרשים בעת טעינת ה-API של 'מפות Google JavaScript'.

  • key: מפתח API. ממשק ה-API של Maps JavaScript לא ייטען, אלא אם יצויין מפתח API תקין.

  • callback: השם של פונקציה גלובלית שיש להפעיל לאחר טעינת ה-API של JavaScript במפות Google.

פרמטרים אופציונליים

השתמשו בפרמטרים האלה כדי לבקש גרסה מסוימת של ה-JavaScript JavaScript API, לטעון ספריות נוספות, להתאים את המפה לשוק המקומי או לציין את המדיניות בנושא בדיקת הגורם המפנה של HTTP

  • v: הגרסה של ה-JavaScript JavaScript API שבה צריך להשתמש.

  • libraries: רשימה מופרדת בפסיקים של ספריות נוספות של JavaScript API ב'מפות'.

  • language: השפה שבה משתמשים. הדבר משפיע על השמות של אמצעי הבקרה, הודעות על זכויות יוצרים, מסלולי נסיעה ותוויות בקרה, וכן על התשובות לבקשות השירות. כאן אפשר לעיין ברשימת השפות הנתמכות.

  • region: קוד האזור שבו יש להשתמש. הפעולה הזו משנה את ההתנהגות של המפה בהתאם למדינה או לאזור ספציפיים.

  • solution_channel: פלטפורמת מפות Google מספקת סוגים רבים של קוד לדוגמה כדי לעזור לכם להתחיל במהירות. כדי לעקוב אחר השימוש בדוגמאות מורכבות יותר של קודים ולשפר את איכות הפתרון, Google כוללת בקוד המעקב שלנו את פרמטר השאילתה solution_channel בקריאות ל-API.

  • auth_referrer_policy: לקוחות JS של מפות Google יכולים להגדיר הגבלות על הפניות HTTP ב-Cloud Console, כדי להגביל את כתובות ה-URL שיכולות להשתמש במפתח API ספציפי. ניתן להגדיר את המגבלות האלה כברירת מחדל כך שרק נתיבים מסוימים יוכלו להשתמש במפתח API. אם כתובת URL כלשהי באותו דומיין או מקור עשויה להשתמש במפתח ה-API, ניתן להגדיר את auth_referrer_policy=origin כדי להגביל את כמות הנתונים שיישלחו בהרשאה של בקשות מ-Maps JavaScript API. האפשרות הזו זמינה החל מגרסה 3.46. אם הפרמטר הזה מוגדר והגבלות על הגורם המפנה של HTTP מופעלות ב-Cloud Console, ה-API של מפות JavaScript יוכל להיטען רק אם יש הגבלה על הגורם המפנה של HTTP שתואמת לדומיין של האתר הנוכחי בלי שצוין נתיב.