Class StaticMap

StaticMap

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

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

// Create a map centered on Times Square.
var 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.
var 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 (var i = 0; i < corners.length; i++) {
  map.addAddress(corners[i]);
}
// All static map URLs require an API key.
var url = map.getMapUrl() + "&key=YOUR_API_KEY";

כדאי לעיין גם בפרטים הבאים

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
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משלימה הגדרת נתיב שהתחילה ב-startPath().
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מגדיר את השפה לשימוש בטקסט במפה (כאשר avaialbe).
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.
var 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.
var map = Maps.newStaticMap().addMarker(40.741799, -74.004207);

פרמטרים

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

החזרות

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

כדאי לעיין גם בפרטים הבאים


addMarker(address)

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

// Creates a map and adds a marker at the specified address.
var 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.
var 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.
var polyline = Maps.encodePolyline([40.714353, -74.005973, 42.358431, -71.059773]);
var map = Maps.newStaticMap().addPath(polyline);

פרמטרים

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

החזרות

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


addPoint(latitude, longitude)

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

// Creates a map and adds a path from New York to Boston.
var 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.
var 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.
var 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.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

החזרות

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


clearMarkers()

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

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

החזרות

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


clearPaths()

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

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

החזרות

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


clearVisibles()

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

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

החזרות

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


endPath()

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

// Creates a map and adds a path from New York to Boston.
var 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'.

החזרות

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


getBlob()

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

// Creates a map centered on Times Square and saves it to Google Drive.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.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.
var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
DocsList.createFile(Utilities.newBlob(map.getMapImage(), 'image/png', 'map.png'));

החזרות

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


getMapUrl()

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

// Creates a map centered on Times Square and gets the URL.
var 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.
var map = Maps.newStaticMap().setCenter(40.759011, -73.984472);

פרמטרים

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

החזרות

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

כדאי לעיין גם בפרטים הבאים


setCenter(address)

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

// Creates a map centered on Times Square, using its address.
var 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".
var 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.
var map = Maps.newStaticMap().setFormat(Maps.StaticMap.Format.PNG);

פרמטרים

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

החזרות

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

כדאי לעיין גם בפרטים הבאים


setLanguage(language)

מגדיר את השפה לשימוש בטקסט במפה (כאשר avaialbe).

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

פרמטרים

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

החזרות

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

כדאי לעיין גם בפרטים הבאים


setMapType(mapType)

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

// Creates a satellite map.
var 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".
var 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.
var 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.
var 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.
var map = Maps.newStaticMap().setSize(400, 300);

פרמטרים

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

החזרות

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

כדאי לעיין גם בפרטים הבאים


setZoom(zoom)

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

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

פרמטרים

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

החזרות

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

כדאי לעיין גם בפרטים הבאים