Class Maps

מפות

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

מאפיינים

נכס	סוג	תיאור
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
decodePolyline(polyline)	Number[]	מפענחת מחרוזת של קו פוליגוני מקודד בחזרה למערך של נקודות.
encodePolyline(points)	String	מקודדת מערך של נקודות למחרוזת.
newDirectionFinder()	DirectionFinder	יוצרת אובייקט DirectionFinder חדש.
newElevationSampler()	ElevationSampler	יוצרת אובייקט ElevationSampler.
newGeocoder()	Geocoder	יוצרת אובייקט Geocoder חדש.
newStaticMap()	StaticMap	יוצרת אובייקט StaticMap חדש.
resetAuthenticationApiKey()	void	איפוס פרטי האימות לשימוש במכסות ברירת המחדל.
setAuthenticationByApiKey(apiKey)	void	מאפשר להשתמש במפתח API כדי לאמת בקשות לניצול מכסות נוספות.
setAuthenticationByApiKey(apiKey, signingKey)	void	מאפשר להשתמש במפתח API ובמפתח חתימה כדי לאמת בקשות לניצול מכסות נוספות ב-StaticMap.

שיטות שהוצאו משימוש

שיטה	סוג הערך שמוחזר	תיאור קצר
setAuthentication(clientId, signingKey)	void	מאפשר להשתמש בחשבון Google Maps APIs Premium Plan שהוגדר חיצונית, כדי לנצל הקצאות נוספות של נפח אחסון.

תיעוד מפורט

decodePolyline(polyline)

מפענחת מחרוזת של קו פוליגוני מקודד בחזרה למערך של נקודות.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

פרמטרים

שם	סוג	תיאור
polyline	String	קו פוליגון מקודד לפענוח.

חזרה

‫Number[] – מערך של זוגות קו רוחב וקו אורך (lat0, long0, lat1, long1, ...).

ראה גם

• פורמט של קו פוליגון מקודד

---

encodePolyline(points)

מקודדת מערך של נקודות למחרוזת.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

פרמטרים

שם	סוג	תיאור
points	Number[]	מערך של זוגות של קווי רוחב ואורך לקידוד.

חזרה

‫String – מחרוזת מקודדת שמייצגת את הנקודות האלה.

ראה גם

• פורמט של קו פוליגון מקודד

---

newDirectionFinder()

יוצרת אובייקט DirectionFinder חדש.

חזרה

‫DirectionFinder — אובייקט חדש של כלי למציאת כיוון.

---

newElevationSampler()

יוצרת אובייקט ElevationSampler.

חזרה

‫ElevationSampler – אובייקט חדש של דוגם גבהים.

---

newGeocoder()

יוצרת אובייקט Geocoder חדש.

חזרה

‫Geocoder — אובייקט חדש של geocoder.

---

newStaticMap()

יוצרת אובייקט StaticMap חדש.

חזרה

‫StaticMap — אובייקט מפה סטטית חדש.

---

resetAuthenticationApiKey()

איפוס פרטי האימות לשימוש במכסות ברירת המחדל. השיטה הזו פועלת כשמשתמשים במפתח API כדי לאמת בקשות. אפשר להשתמש בשיטה הזו כדי לחזור למכסות ברירת המחדל אם רוצים להשתמש בשיטות Maps בלי לספק פרטי אימות.

Maps.resetAuthenticationApiKey();

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם נעשה שימוש ב-setAuthentication(clientId, signingKey) לאימות.

---

setAuthenticationByApiKey(apiKey)

מאפשר להשתמש במפתח API כדי לאמת בקשות לניצול מכסות נוספות.

השיטה הזו משמשת להגדרת מפתח API שמשמש לאימות בקשות. כשקוראים לשיטה הזו, צריכת המכסה והחיוב משויכים לפרויקט בענן ב-Google Cloud שמשויך למפתח ה-API שסופק, בהתאם לגיליון התמחור. אתם יכולים להשתמש בשיטות Maps עם הקצאות ברירת המחדל של המכסה בלי לספק פרטי אימות. אם אתם משתמשים ב-StaticMap, עליכם להשתמש במקום זאת בשיטה setAuthenticationByApiKey(apiKey, signingKey).

הערה: אם אתם משתמשים במזהה לקוח כדי לאמת בקשות, חשוב לדעת שמזהה הלקוח הוצא משימוש ב-26 במאי 2025, ולא ניתן להשתמש בו יותר אחרי 31 במאי 2026. במקום להשתמש במזהה לקוח, צריך להשתמש בפרטי כניסה של מפתח API כדי לאמת את התעבורה של שירות Google Maps API. מידע נוסף זמין במדריך.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

פרמטרים

שם	סוג	תיאור
apiKey	String	מפתח API שאפשר לקבל ממסוף Google Cloud על ידי ביצוע השלבים שמפורטים במדריך למתחילים.

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם apiKey הוא null, או אם כבר נעשה שימוש ב-setAuthentication(clientId, signingKey) לאימות

---

setAuthenticationByApiKey(apiKey, signingKey)

מאפשר להשתמש במפתח API ובמפתח חתימה כדי לאמת בקשות לניצול מכסות נוספות ב-StaticMap. הפרמטר signingKey נדרש לבקשות ל-Static Map API, אבל אפשר להשתמש בשיטה הזו גם כדי לאמת שירותים אחרים של מפות Google. במקרים כאלה, המערכת מתעלמת מהפרמטר signingKey.

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

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

פרמטרים

שם	סוג	תיאור
apiKey	String	מפתח API שאפשר לקבל ממסוף Google Cloud על ידי ביצוע השלבים שמפורטים במדריך למתחילים.
signingKey	String	מפתח חתימה שאפשר לקבל ממסוף Google Cloud על ידי ביצוע השלבים שמפורטים במדריך לחתימה דיגיטלית. הפרמטר הזה נדרש עבור StaticMap ומתעלמים ממנו בשירותים אחרים של Maps.

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם apiKey הוא null, או אם כבר נעשה שימוש ב-setAuthentication(clientId, signingKey) לאימות

ראה גם

• setAuthenticationByApiKey(apiKey)

שיטות שהוצאו משימוש

setAuthentication(clientId, signingKey)

הוצא משימוש. במקום זאת, אפשר להשתמש ב-setAuthenticationByApiKey(apiKey) שמשתמש במפתח API לאימות.

מאפשרת שימוש בחשבון תוכנית פרימיום של Google Maps APIs שהוגדר חיצונית, כדי לנצל הקצאות נוספות של מכסת שימוש. אפשר לקבל את מזהה הלקוח ואת מפתח החתימה מהקטע Maps במסוף Google Cloud. כדי לחזור לשימוש במכסות ברירת המחדל, צריך להגדיר את הערכים האלה ל-null.

הערה: השיטה הזו לא פועלת עם מפתחות API. בנוסף, חשוב לזכור שתוכנית פרימיום כבר לא זמינה ללקוחות חדשים. אם עדיין אין לכם רישיון לתוכנית פרימיום, אל תתקשרו למספר setAuthentication(clientId, signingKey). יש לך אפשרות להשתמש בשיטות Maps עם הקצאות ברירת המחדל של המכסות.

Maps.setAuthentication('gme-123456789', 'VhSEZvOXVSdnlxTnpJcUE');

פרמטרים

שם	סוג	תיאור
clientId	String	מזהה לקוח.
signingKey	String	מפתח פרטי לחתימה.

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם setAuthenticationByApiKey(apiKey) כבר נמצא בשימוש לאימות