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מוסיף סמן למפה באמצעות נקודה (קו רוחב/lng).
addMarker(address)StaticMapהוספת סמן למפה באמצעות כתובת.
addPath(points)StaticMapהוספת נתיב למפה באמצעות מערך של נקודות.
addPath(polyline)StaticMapהוספת נתיב למפה באמצעות קו פוליגוני מקודד.
addPoint(latitude, longitude)StaticMapהוספת נקודה חדשה (קו רוחב/lng) להגדרת הנתיב הנוכחית.
addVisible(latitude, longitude)StaticMapמוסיף מיקום של נקודה (קו רוחב/lng) שחייב להיות גלוי במפה.
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מגדיר את מרכז המפה באמצעות נקודה (קו רוחב/lng).
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.
var map = Maps.newStaticMap()
    .beginPath()
    .addAddress('New York, NY')
    .addAddress('Boston, MA')
    .endPath();

פרמטרים

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

חזרה

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


addMarker(latitude, longitude)

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

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

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

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

מוסיף מיקום של נקודה (קו רוחב/lng) שחייב להיות גלוי במפה.

// 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 שהומר לסוג התוכן שצוין. הזה method מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, "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.
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)

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

// 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, אם כי מומלץ להשתמש ב-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)

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

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

ראה גם