Class StaticMap

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

// 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 – מופע המפה הזה, לצורך שרשור.

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

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

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

פרמטרים

חזרה

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

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

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

פרמטרים

חזרה

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

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

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

חזרה

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

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

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

חזרה

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

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

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

חזרה

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

השלמת הגדרת נתיב שהתחילה ב-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 – מופע המפה הזה, לצורך שרשור.

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

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

פרמטרים

חזרה

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

הפונקציה מקבלת את נתוני התמונה כ-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 — תמונה של המפה בפורמט התמונה שנבחר.

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

באופן כללי, מומלץ להשתמש ב-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[] — תמונה של המפה בפורמט התמונה שנבחר.

הפונקציה מקבלת את כתובת ה-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 של תמונת המפה.

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

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

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API

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

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

פרמטרים

חזרה

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

ראה גם

• Google Static Maps API