מאפשר יצירה ועיטור של תמונות מפה סטטיות.
הדוגמה הבאה מראה איך אפשר להשתמש בכיתה הזו כדי ליצור מפה של תיאטרון תל אביב. מחוז, כולל תחנות רכבת קרובות, ולהציג אותו באפליקציית אינטרנט פשוטה.
// 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();
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | כתובת להוספה. |
חזרה
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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
latitude | Number | קו הרוחב של הסמן החדש. |
longitude | Number | קו האורך של הסמן החדש. |
חזרה
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');
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | הכתובת בוויץ' לצורך מיקום הסמן החדש. |
חזרה
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]);
פרמטרים
שם | סוג | תיאור |
---|---|---|
points | Number[] | מערך של צמדי קו רוחב/קו אורך שמגדירים את הנתיב. |
חזרה
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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
polyline | String | קו פוליגוני מקודד. |
חזרה
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();
פרמטרים
שם | סוג | תיאור |
---|---|---|
latitude | Number | קו הרוחב של הנקודה. |
longitude | Number | קו האורך של הנקודה. |
חזרה
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)
פרמטרים
שם | סוג | תיאור |
---|---|---|
latitude | Number | קו הרוחב של הנקודה. |
longitude | Number | קו האורך של הנקודה. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
addVisible(address)
הוספת מיקום כתובת שחייב להיות גלוי במפה.
// Creates a map where New York and Boston are visible. var map = Maps.newStaticMap() .addVisible('New York, NY') .addVisible('Boston, MA');
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | כתובת שחייבת להופיע במפה. |
חזרה
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 שייווצרו. במכסות.
פרמטרים
שם | סוג | תיאור |
---|---|---|
contentType | String | סוג ה-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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
latitude | Number | קו הרוחב של המרכז. |
longitude | Number | קו האורך של המרכז. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
setCenter(address)
מגדיר את מרכז המפה באמצעות כתובת.
// Creates a map centered on Times Square, using its address. var map = Maps.newStaticMap().setCenter('Times Square, New York, NY');
פרמטרים
שם | סוג | תיאור |
---|---|---|
address | String | הכתובת של המרכז. |
חזרה
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);
פרמטרים
שם | סוג | תיאור |
---|---|---|
imageUrl | String | מציינת כתובת URL שתשמש כסמל המותאם אישית של הסמן. התמונות יכולות להיות בפורמט PNG או JPEG או GIF בפורמט PNG, אם כי מומלץ להשתמש ב-PNG. |
useShadow | Boolean | מציין שעל הסמן להיווצר צל, על סמך הערך של התמונה את האזור הגלוי ואת השקיפות/השקיפות שלו. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
setFormat(format)
setLanguage(language)
הגדרת השפה לשימוש בטקסט במפה (היכן שזמין).
// Creates a map with the language set to French. var map = Maps.newStaticMap().setLanguage('fr');
פרמטרים
שם | סוג | תיאור |
---|---|---|
language | String | מזהה שפה מסוג BCP-47. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
setMapType(mapType)
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');
פרמטרים
שם | סוג | תיאור |
---|---|---|
size | String | ערך קבוע מ-MarkerSize . |
color | String | מחרוזת בפורמט "0xrrggbb" או ערך קבוע מ-Color . |
label | String | מחרוזת שמכילה את התווים A-Z או 0-9. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
setMobile(useMobileTiles)
המדיניות קובעת אם להשתמש בערכות משבצות מיוחדות למכשירים ניידים.
// Creates a map that uses mobile-friendly tiles. var 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. var map = Maps.newStaticMap() .setPathStyle(1, Maps.StaticMap.Color.BLACK , 'red');
פרמטרים
שם | סוג | תיאור |
---|---|---|
weight | Integer | רוחב הקווים בפיקסלים. |
color | String | צבע הקו, כמחרוזת בפורמט "0xrrggbb" או ערך קבוע מתוך
Color |
fillColor | String | צבע המילוי, מחרוזת בפורמט "0xrrggbb" או ערך קבוע מתוך
Color |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
setSize(width, height)
מגדיר את הרוחב והגובה של תמונת המפה בפיקסלים.
// Creates a map 400px wide by 300px high. var map = Maps.newStaticMap().setSize(400, 300);
פרמטרים
שם | סוג | תיאור |
---|---|---|
width | Integer | רוחב התמונה בפיקסלים. |
height | Integer | גובה התמונה בפיקסלים. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.
ראה גם
setZoom(zoom)
מגדיר את גורם הזום, או רמת ההגדלה, המשמשים במפה.
// Creates a map with a zoom factor of 10. var map = Maps.newStaticMap().setZoom(10);
פרמטרים
שם | סוג | תיאור |
---|---|---|
zoom | Integer | ערך בין אפס ל-21, כולל. |
חזרה
StaticMap
– מופע המפה הזה, ליצירת שרשור.