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

ראה גם

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

פרמטרים

שם	סוג	תיאור
`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

Class StaticMap קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

ראה גם

Methods

תיעוד מפורט

addAddress(address)

פרמטרים

חזרה

addMarker(latitude, longitude)

פרמטרים

חזרה

ראה גם

addMarker(address)

פרמטרים

חזרה

ראה גם

addPath(points)

פרמטרים

חזרה

addPath(polyline)

פרמטרים

חזרה

addPoint(latitude, longitude)

פרמטרים

חזרה

addVisible(latitude, longitude)

פרמטרים

חזרה

ראה גם

addVisible(address)

פרמטרים

חזרה

ראה גם

beginPath()

חזרה

clearMarkers()

חזרה

clearPaths()

חזרה

clearVisibles()

חזרה

endPath()

חזרה

getAs(contentType)

פרמטרים

חזרה

getBlob()

חזרה

getMapImage()

חזרה

getMapUrl()

חזרה

setCenter(latitude, longitude)

פרמטרים

חזרה

ראה גם

setCenter(address)

פרמטרים

חזרה

ראה גם

setCustomMarkerStyle(imageUrl, useShadow)

פרמטרים

חזרה

ראה גם

setFormat(format)

פרמטרים

חזרה

ראה גם

setLanguage(language)

פרמטרים

חזרה

ראה גם

setMapType(mapType)

פרמטרים

חזרה

ראה גם

setMarkerStyle(size, color, label)

פרמטרים

חזרה

ראה גם

setMobile(useMobileTiles)

Class StaticMap

`addAddress(address)`

`addMarker(latitude, longitude)`

`addMarker(address)`

`addPath(points)`

`addPath(polyline)`

`addPoint(latitude, longitude)`

`addVisible(latitude, longitude)`

`addVisible(address)`

`beginPath()`

`clearMarkers()`

`clearPaths()`

`clearVisibles()`

`endPath()`

`getAs(contentType)`

`getBlob()`

`getMapImage()`

`getMapUrl()`

`setCenter(latitude, longitude)`

`setCenter(address)`

`setCustomMarkerStyle(imageUrl, useShadow)`

`setFormat(format)`

`setLanguage(language)`

`setMapType(mapType)`

`setMarkerStyle(size, color, label)`

`setMobile(useMobileTiles)`

`setPathStyle(weight, color, fillColor)`

`setSize(width, height)`

`setZoom(zoom)`