Class 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`;

ראה גם

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();

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.


addMarker(latitude, longitude)

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

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

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של הסמן החדש.
longitudeNumberקו האורך של הסמן החדש.

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


addMarker(address)

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

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

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


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,
]);

פרמטרים

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

חזרה

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);

פרמטרים

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

חזרה

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();

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של הנקודה.
longitudeNumberקו האורך של הנקודה.

חזרה

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);

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של הנקודה.
longitudeNumberקו האורך של הנקודה.

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


addVisible(address)

הוספה של מיקום כתובת שחייב להיות גלוי במפה.

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

פרמטרים

שםסוגתיאור
addressStringכתובת שחייבת להיות גלויה במפה.

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


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 יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שםסוגתיאור
contentTypeStringסוג ה-MIME שאליו רוצים להמיר. ברוב ה-blob, ‏ '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 של תמונת המפה.


setCenter(latitude, longitude)

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

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

פרמטרים

שםסוגתיאור
latitudeNumberקו הרוחב של המרכז.
longitudeNumberקו האורך של המרכז.

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setCenter(address)

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

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

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


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,
);

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setFormat(format)

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

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

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setLanguage(language)

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

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

פרמטרים

שםסוגתיאור
languageStringמזהה שפה בפורמט BCP-47.

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setMapType(mapType)

ההגדרה הזו קובעת את סוג המפה שתוצג.

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

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


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',
);

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setMobile(useMobileTiles)

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

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

פרמטרים

שםסוגתיאור
useMobileTilesBooleanהאם להשתמש במשבצות בנייד.

חזרה

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',
);

פרמטרים

שםסוגתיאור
weightIntegerרוחב הקווים בפיקסלים.
colorStringצבע הקו, כמחרוזת בפורמט '0xrrggbb' או כערך קבוע מתוך Color.
fillColorStringצבע המילוי, מחרוזת בפורמט '0xrrggbb' או ערך קבוע מתוך Color.

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setSize(width, height)

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

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

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם


setZoom(zoom)

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

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

פרמטרים

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

חזרה

StaticMap — מופע המפה הזה, לשרשור.

ראה גם