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

ראה גם

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 שאליו רוצים להמיר. ברוב ה-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);

פרמטרים

שםסוגתיאור
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 – מופע המפה הזה, לצורך שרשור.

ראה גם