Class StaticMap

StaticMap

מאפשר ליצור ולקשט תמונות סטטיות של מפות.

הדוגמה הבאה מראה איך אפשר להשתמש בכיתה הזו כדי ליצור מפה של רובע התיאטרון בניו יורק, כולל תחנות הרכבת הסמוכות, ולהציג אותה באפליקציית אינטרנט פשוטה.

// Create a map centered on Times Square.
const map = Maps.newStaticMap().setSize(600, 600).setCenter(
    'Times Square, New York, NY');

// Add markers for the nearbye train stations.
map.setMarkerStyle(
    Maps.StaticMap.MarkerSize.MID,
    Maps.StaticMap.Color.RED,
    'T',
);
map.addMarker('Grand Central Station, New York, NY');
map.addMarker('Penn Station, New York, NY');

// Show the boundaries of the Theatre District.
const corners = [
  '8th Ave & 53rd St, New York, NY',
  '6th Ave & 53rd St, New York, NY',
  '6th Ave & 40th St, New York, NY',
  '8th Ave & 40th St, New York, NY',
];
map.setPathStyle(4, Maps.StaticMap.Color.BLACK, Maps.StaticMap.Color.BLUE);
map.beginPath();
for (let i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
const url = `${map.getMapUrl()}&key=YOUR_API_KEY`;

ראה גם

• Google Static Maps API

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
addAddress(address)	StaticMap	הוספת כתובת חדשה להגדרת הנתיב הנוכחית.
addMarker(latitude, longitude)	StaticMap	הוספת סמן למפה באמצעות נקודה (קו הרוחב/קו האורך).
addMarker(address)	StaticMap	הוספת סמן למפה באמצעות כתובת.
addPath(points)	StaticMap	הוספת נתיב למפה באמצעות מערך של נקודות.
addPath(polyline)	StaticMap	הוספת נתיב למפה באמצעות קו פוליגון מוצפן.
addPoint(latitude, longitude)	StaticMap	הוספת נקודה חדשה (קו הרוחב/קו האורך) להגדרת הנתיב הנוכחית.
addVisible(latitude, longitude)	StaticMap	הוספת מיקום של נקודה (קו הרוחב/קו האורך) שצריכה להיות גלויה במפה.
addVisible(address)	StaticMap	הוספת מיקום של כתובת שצריך להיות גלוי במפה.
beginPath()	StaticMap	מתחילים להגדיר נתיב חדש.
clearMarkers()	StaticMap	ניקוי קבוצת הסימנים הנוכחית.
clearPaths()	StaticMap	ניקוי הקבוצה הנוכחית של הנתיבים.
clearVisibles()	StaticMap	ניקוי הקבוצה הנוכחית של המיקומים הגלויים.
endPath()	StaticMap	השלמת הגדרת נתיב שהתחילה ב-beginPath().
getAs(contentType)	Blob	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
getBlob()	Blob	הפונקציה מקבלת את נתוני התמונה כ-Blob.
getMapImage()	Byte[]	הפונקציה מקבלת את נתוני התמונה הגולמיים כמערך בייטים.
getMapUrl()	String	הפונקציה מקבלת את כתובת ה-URL של תמונת המפה.
setCenter(latitude, longitude)	StaticMap	הגדרת מרכז המפה באמצעות נקודה (קו הרוחב/קו האורך).
setCenter(address)	StaticMap	הגדרת מרכז המפה באמצעות כתובת.
setCustomMarkerStyle(imageUrl, useShadow)	StaticMap	הגדרת קובץ התמונה של הסמן המותאם אישית לשימוש ביצירת סמנים חדשים.
setFormat(format)	StaticMap	הגדרת הפורמט של תמונת המפה.
setLanguage(language)	StaticMap	הגדרת השפה שבה כתוב הטקסט במפה (אם היא זמינה).
setMapType(mapType)	StaticMap	מגדיר את סוג המפה שמוצגת.
setMarkerStyle(size, color, label)	StaticMap	הגדרת סגנון הסמן לשימוש ביצירת סמנים חדשים.
setMobile(useMobileTiles)	StaticMap	ההגדרה קובעת אם להשתמש בקבוצות משבצות מיוחדות למכשירים ניידים או לא.
setPathStyle(weight, color, fillColor)	StaticMap	הגדרת סגנון הנתיב לשימוש כשיוצרים נתיבים חדשים.
setSize(width, height)	StaticMap	הגדרת הרוחב והגובה של תמונת המפה בפיקסלים.
setZoom(zoom)	StaticMap	הגדרת גורם הזום, או רמת ההגדלה, של המפה.

מסמכים מפורטים

addAddress(address)

הוספת כתובת חדשה להגדרת הנתיב הנוכחית.

// Creates a map and adds a path from New York to Boston.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

פרמטרים

שם	סוג	תיאור
address	String	כתובת להוספה.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

addMarker(latitude, longitude)

הוספת סמן למפה באמצעות נקודה (קו הרוחב/קו האורך).

// Creates a map and adds a marker at the specified coordinates.
const map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של הסמן החדש.
longitude	Number	קו האורך של הסמן החדש.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

addMarker(address)

הוספת סמן למפה באמצעות כתובת.

// Creates a map and adds a marker at the specified address.
const map = Maps.newStaticMap().addMarker('76 9th Ave, New York NY');

פרמטרים

שם	סוג	תיאור
address	String	הכתובת שבה רוצים למקם את הסמן החדש.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

addPath(points)

הוספת נתיב למפה באמצעות מערך של נקודות.

// Creates a map and adds a path from New York to Boston.
const map = Maps.newStaticMap().addPath([
  40.714353,
  -74.005973,
  42.358431,
  -71.059773,
]);

פרמטרים

שם	סוג	תיאור
points	Number[]	מערך של צמדי קואורדינטות שמשמש להגדרת הנתיב.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

addPath(polyline)

הוספת נתיב למפה באמצעות קו פוליגון מוצפן.

// Creates a map and adds a path from New York to Boston.
const polyline = Maps.encodePolyline([
  40.714353,
  -74.005973,
  42.358431,
  -71.059773,
]);
const map = Maps.newStaticMap().addPath(polyline);

פרמטרים

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

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

addPoint(latitude, longitude)

הוספת נקודה חדשה (קו הרוחב/קו האורך) להגדרת הנתיב הנוכחית.

// Creates a map and adds a path from New York to Boston.
const map = Maps.newStaticMap()
                .beginPath()
                .addPoint(40.714353, -74.005973)
                .addPoint(42.358431, -71.059773)
                .endPath();

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של הנקודה.
longitude	Number	קו האורך של הנקודה.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

addVisible(latitude, longitude)

הוספת מיקום של נקודה (קו הרוחב/קו האורך) שצריכה להיות גלויה במפה.

// Creates a map where New York and Boston are visible.
const map = Maps.newStaticMap()
                .addVisible(40.714353, -74.005973)
                .addVisible(42.358431, -71.059773);

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של הנקודה.
longitude	Number	קו האורך של הנקודה.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

addVisible(address)

הוספת מיקום של כתובת שצריך להיות גלוי במפה.

// Creates a map where New York and Boston are visible.
const map =
    Maps.newStaticMap().addVisible('New York, NY').addVisible('Boston, MA');

פרמטרים

שם	סוג	תיאור
address	String	כתובת שצריכה להיות גלויה במפה.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

beginPath()

מתחילים להגדיר נתיב חדש. קריאות ל-addAddress() ול-addPoint() מגדירות כל קודקוד חדש בנתיב. הנתיב הושלם כשהקריאה ל-endPath() הושלמה.

// Creates a map and adds a path from New York to Boston.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

clearMarkers()

ניקוי קבוצת הסימנים הנוכחית.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all markers on the map.
map.clearMarkers();

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

clearPaths()

ניקוי הקבוצה הנוכחית של הנתיבים.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all paths on the map.
map.clearPaths();

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

clearVisibles()

ניקוי הקבוצה הנוכחית של המיקומים הגלויים.

const map = Maps.newStaticMap();
// ...
// Do something interesting here ...
// ...
// Remove all visible locations created with addVisible().
map.clearVisibles();

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

endPath()

השלמת הגדרת נתיב שהתחילה ב-beginPath().

// Creates a map and adds a path from New York to Boston.
const map = Maps.newStaticMap()
                .beginPath()
                .addAddress('New York, NY')
                .addAddress('Boston, MA')
                .endPath();

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

getAs(contentType)

החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, ההנחה היא שחלק משם הקובץ שמופיע אחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. כתוצאה מכך, הקובץ ShoppingList.12.25.2014 הופך לקובץ ShoppingList.12.25.pdf.

כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר מכסות לשירותי Google. יכול להיות שדומיינים חדשים של Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שם	סוג	תיאור
contentType	String	סוג ה-MIME שאליו רוצים להמיר. ברוב ה-blobs, 'application/pdf' היא האפשרות היחידה התקפה. בתמונות בפורמט BMP,‏ GIF,‏ JPEG או PNG, אפשר להשתמש גם ב-'image/bmp',‏ 'image/gif',‏ 'image/jpeg' או 'image/png'. במסמך ב-Google Docs, הערך 'text/markdown' תקף גם כן.

חזרה

Blob – הנתונים כ-blob.

---

getBlob()

הפונקציה מקבלת את נתוני התמונה כ-Blob.

// Creates a map centered on Times Square and saves it to Google Drive.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DriveApp.createFile(map);  // You can call map.getBlob() explicitly or use it
// implicitly by passing the map where a blob is expected.

חזרה

Blob — תמונה של המפה בפורמט התמונה שנבחר.

---

getMapImage()

הפונקציה מקבלת את נתוני התמונה הגולמיים כמערך בייטים.

באופן כללי, מומלץ להשתמש ב-getBlob(), שמאפשר אינטראקציות פשוטות יותר עם שירותים אחרים.

// Creates a map centered on Times Square and saves it to Google Drive.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DriveApp.createFile(
    Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'),
);

חזרה

Byte[] — תמונה של המפה בפורמט התמונה שנבחר.

---

getMapUrl()

הפונקציה מקבלת את כתובת ה-URL של תמונת המפה.

// Creates a map centered on Times Square and gets the URL.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
// All static map URLs require an API key.
Logger.log(`${map.getMapUrl()}&key=YOUR_API_KEY`);

חזרה

String – כתובת URL כתובת ה-URL של תמונת המפה.

---

setCenter(latitude, longitude)

הגדרת מרכז המפה באמצעות נקודה (קו הרוחב/קו האורך).

// Creates a map centered on Times Square, using its coordinates.
const map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

פרמטרים

שם	סוג	תיאור
latitude	Number	קו הרוחב של המרכז.
longitude	Number	קו האורך של המרכז.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setCenter(address)

הגדרת מרכז המפה באמצעות כתובת.

// Creates a map centered on Times Square, using its address.
const map = Maps.newStaticMap().setCenter('Times Square, New York, NY');

פרמטרים

שם	סוג	תיאור
address	String	הכתובת של המרכז.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setCustomMarkerStyle(imageUrl, useShadow)

הגדרת קובץ התמונה של הסמן המותאם אישית לשימוש ביצירת סמנים חדשים. סמני זמן שכבר נוספו לא יושפעו.

// Creates a map with markers set to be medium sized, black, and labeled with
// the number "1".
const map = Maps.newStaticMap().setCustomMarkerStyle(
    'http://www.example.com/marker.png',
    false,
);

פרמטרים

שם	סוג	תיאור
imageUrl	String	כתובת URL שתשמש כסמל המותאם אישית של הסמן. התמונות יכולות להיות בפורמטים PNG, ‏ JPEG או GIF, אבל מומלץ להשתמש בפורמט PNG.
useShadow	Boolean	המשמעות של הערך הזה היא שצריך ליצור צללית של הסמן על סמך האזור הגלוי של התמונה והעכירות או השקיפות שלה.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setFormat(format)

הגדרת הפורמט של תמונת המפה.

// Creates a map with the image format set to PNG.
const map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

פרמטרים

שם	סוג	תיאור
format	String	ערך קבוע מ-Format.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setLanguage(language)

הגדרת השפה שבה כתוב הטקסט במפה (אם היא זמינה).

// Creates a map with the language set to French.
const map = Maps.newStaticMap().setLanguage('fr');

פרמטרים

שם	סוג	תיאור
language	String	מזהה שפה לפי BCP-47.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• תמיכה בשפות ב-Google Maps APIs

---

setMapType(mapType)

מגדיר את סוג המפה שמוצגת.

// Creates a satellite map.
const map = Maps.newStaticMap().setMapType(Maps.StaticMap.Type.SATELLITE);

פרמטרים

שם	סוג	תיאור
mapType	String	ערך קבוע מ-Type.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setMarkerStyle(size, color, label)

הגדרת סגנון הסמן לשימוש ביצירת סמנים חדשים. סמנים שכבר נוספו לא יושפעו.

// Creates a map with markers set to be medium sized, black, and labeled with
// the number "1".
const map = Maps.newStaticMap().setMarkerStyle(
    Maps.StaticMap.MarkerSize.MID,
    Maps.StaticMap.Color.BLACK,
    '1',
);

פרמטרים

שם	סוג	תיאור
size	String	ערך קבוע מ-MarkerSize.
color	String	מחרוזת בפורמט '0xrrggbb' או ערך קבוע מ-Color.
label	String	מחרוזת שמכילה תו יחיד מ-A-Z או מ-0-9.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setMobile(useMobileTiles)

ההגדרה קובעת אם להשתמש בקבוצות משבצות מיוחדות למכשירים ניידים או לא.

// Creates a map that uses mobile-friendly tiles.
const map = Maps.newStaticMap().setMobile(true);

פרמטרים

שם	סוג	תיאור
useMobileTiles	Boolean	אם להשתמש בכרזות ריבועיות לנייד או לא.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

---

setPathStyle(weight, color, fillColor)

הגדרת סגנון הנתיב לשימוש כשיוצרים נתיבים חדשים. נתיבים שכבר נוספו לא יושפעו.

// Creates a map with paths set to be 1 pixel wide with a black line and a white
// fill.
const map = Maps.newStaticMap().setPathStyle(
    1,
    Maps.StaticMap.Color.BLACK,
    'red',
);

פרמטרים

שם	סוג	תיאור
weight	Integer	רוחב הקווים בפיקסלים.
color	String	צבע הקו, כמחרוזת בפורמט '0xrrggbb' או ערך קבוע מ-Color.
fillColor	String	צבע המילוי, מחרוזת בפורמט '0xrrggbb' או ערך קבוע מ-Color.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setSize(width, height)

הגדרת הרוחב והגובה של תמונת המפה בפיקסלים.

// Creates a map 400px wide by 300px high.
const map = Maps.newStaticMap().setSize(400, 300);

פרמטרים

שם	סוג	תיאור
width	Integer	רוחב התמונה בפיקסלים.
height	Integer	הגובה של התמונה בפיקסלים.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API

---

setZoom(zoom)

הגדרת גורם הזום, או רמת ההגדלה, של המפה.

// Creates a map with a zoom factor of 10.
const map = Maps.newStaticMap().setZoom(10);

פרמטרים

שם	סוג	תיאור
zoom	Integer	ערך בין אפס ל-21, כולל.

חזרה

StaticMap – מופע המפה הזה, לצורך שרשור.

ראה גם

• Google Static Maps API