Maps Service

מפות

השירות הזה מאפשר ל-Google Scripts ליצור מפות סטטיות, למצוא מסלולים, להמיר כתובות לקווי אורך ורוחב ולקבל דוגמאות לגובה.

שיעורים

שםתיאור קצר
Avoidמאפיין enum שמייצג את סוגי ההגבלות שצריך להימנע מהן כשמחפשים מסלול.
Colorמאפיין enum שמייצג את הצבעים הנתונים בשם שזמינים לשימוש בתמונות של מפות.
DirectionFinderמאפשרת אחזור מסלולים בין מיקומים.
DirectionFinderEnumsאוסף של ערכים מוגדרים מראש ש-DirectionFinder משתמש בהם.
ElevationSamplerמאפשרת לדגום גובה במיקומים ספציפיים.
Formatenum שמייצג את הפורמט של קובץ התמונה של המפה.
Geocoderמאפשרת המרה בין כתובת לבין קואורדינטות גיאוגרפיות.
Mapsמאפשרת למצוא מסלולים, לבצע גיאוקודינג, לדגום את הגובה וליצור תמונות סטטיות של מפות.
MarkerSizeמאפיין enum שמייצג את הגודל של סמן שנוסף למפה.
Modeenum שמייצג את אופן התחבורה שבו צריך להשתמש כשמחפשים מסלול.
StaticMapמאפשר ליצור ולקשט תמונות סטטיות של מפות.
StaticMapEnumsאוסף של ערכים מוגדרים מראש ש-StaticMap משתמש בהם.
Typeenum שמייצג את סוג המפה לעיבוד.

Avoid

מאפיינים

נכססוגתיאור
TOLLSEnumהימנעות מכבישי אגרה.
HIGHWAYSEnumהימנעות מכבישים מהירים.

Color

מאפיינים

נכססוגתיאור
BLACKEnum
BROWNEnum
GREENEnum
PURPLEEnum
YELLOWEnum
BLUEEnum
GRAYEnum
ORANGEEnum
REDEnum
WHITEEnum

DirectionFinder

Methods

שיטהסוג הערך המוחזרתיאור קצר
addWaypoint(latitude, longitude)DirectionFinderהוספת ציון דרך שהמסלול חייב לעבור דרכו, באמצעות נקודה (קו הרוחב/קו האורך).
addWaypoint(address)DirectionFinderהוספת ציון דרך שהמסלול חייב לעבור דרכו, באמצעות כתובת.
clearWaypoints()DirectionFinderניקוי הקבוצה הנוכחית של נקודות הדרך.
getDirections()Objectהפונקציה מקבלת את המסלול לפי נקודת המוצא, היעד והאפשרויות האחרות שהוגדרו.
setAlternatives(useAlternatives)DirectionFinderמגדיר אם להחזיר נתיבים חלופיים במקום רק את המסלול בעל הדירוג הגבוה ביותר (ברירת המחדל היא false).
setArrive(time)DirectionFinderמגדירים את שעת ההגעה הרצויה (אם רלוונטי).
setAvoid(avoid)DirectionFinderמגדיר אם להימנע מסוגים מסוימים של הגבלות.
setDepart(time)DirectionFinderמגדירים את שעת היציאה הרצויה (אם רלוונטי).
setDestination(latitude, longitude)DirectionFinderהגדרת מיקום הסיום שעבורו צריך לחשב מסלול, באמצעות נקודה (קואורדינטות צפון/דרום).
setDestination(address)DirectionFinderהגדרת המיקום הסופי שעבורו רוצים לחשב מסלול, באמצעות כתובת.
setLanguage(language)DirectionFinderהגדרת השפה שבה יושמעו ההנחיות.
setMode(mode)DirectionFinderהגדרת אמצעי התחבורה (ברירת המחדל היא 'רכב').
setOptimizeWaypoints(optimizeOrder)DirectionFinderקובע אם לבצע אופטימיזציה של המסלול שסופק על ידי סידור מחדש של נקודות העצירה בסדר יעיל יותר (ברירת המחדל היא false).
setOrigin(latitude, longitude)DirectionFinderהגדרת מיקום ההתחלה שממנו מחשבים מסלולים, באמצעות נקודה (קו הרוחב/קו האורך).
setOrigin(address)DirectionFinderהגדרת מיקום ההתחלה שממנו יחושבו המסלולים, באמצעות כתובת.
setRegion(region)DirectionFinderהגדרת אזור לשימוש בזמן הפענוח של שמות המיקומים.

DirectionFinderEnums

מאפיינים

נכססוגתיאור
AvoidAvoid
ModeMode

ElevationSampler

Methods

שיטהסוג הערך המוחזרתיאור קצר
sampleLocation(latitude, longitude)Objectהפונקציה מחזירה נתוני גובה של נקודה אחת (קו הרוחב/קו האורך).
sampleLocations(points)Objectהפונקציה מחזירה נתוני גובה של סדרת נקודות (lat/lng).
sampleLocations(encodedPolyline)Objectהפונקציה מחזירה נתוני גובה של הנקודות בקו פוליגון מוצפן.
samplePath(points, numSamples)Objectהפונקציה מחזירה נתוני גובה של מספר דגימות לאורך קו, שמוגדר באמצעות סדרה של נקודות.
samplePath(encodedPolyline, numSamples)Objectהפונקציה מחזירה נתוני גובה של מספר דגימות לאורך קו, שמוגדר באמצעות קו פוליגון מוצפן.

Format

מאפיינים

נכססוגתיאור
PNGEnumפורמט PNG של 8 ביט.
PNG8Enumפורמט PNG של 8 ביט.
PNG32Enumפורמט PNG של 32 סיביות.
GIFEnumפורמט GIF.
JPGEnumפורמט JPEG.
JPG_BASELINEEnumפורמט JPEG לא פרוגרסיבי.

Geocoder

Methods

שיטהסוג הערך המוחזרתיאור קצר
geocode(address)Objectהפונקציה מקבלת את הנקודות הגיאוגרפיות המשוערות של כתובת נתונה.
reverseGeocode(latitude, longitude)Objectהפונקציה מקבלת את הכתובות המשוערות של נקודה גיאוגרפית נתונה.
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)Geocoderהגדרת הגבולות של אזור שצריך לתת לו עדיפות נוספת בתוצאות.
setLanguage(language)Geocoderהגדרת השפה שבה יוצגו התוצאות.
setRegion(region)Geocoderהגדרת אזור לשימוש בזמן הפענוח של שמות המיקומים.

Maps

מאפיינים

נכססוגתיאור
DirectionFinderDirectionFinderEnums
StaticMapStaticMapEnums

Methods

שיטהסוג הערך המוחזרתיאור קצר
decodePolyline(polyline)Number[]פענוח של מחרוזת פוליגון מקודדת בחזרה למערך של נקודות.
encodePolyline(points)Stringהפונקציה מקודדת מערך של נקודות במחרוזת.
newDirectionFinder()DirectionFinderיצירת אובייקט חדש מסוג DirectionFinder.
newElevationSampler()ElevationSamplerיצירת אובייקט ElevationSampler.
newGeocoder()Geocoderיצירת אובייקט Geocoder חדש.
newStaticMap()StaticMapיצירת אובייקט StaticMap חדש.
setAuthentication(clientId, signingKey)voidמאפשרת להשתמש בחשבון Google Maps APIs Premium Plan שנוצר מחוץ ל-Cloud, כדי לנצל מכסות נוספות.

MarkerSize

מאפיינים

נכססוגתיאור
TINYEnumשווקים בגודל זעיר (הקטנים ביותר שזמינים).
MIDEnumסמנים בגודל בינוני (הגדולים ביותר שזמינים).
SMALLEnumסמנים בגודל קטן.

Mode

מאפיינים

נכססוגתיאור
DRIVINGEnumמסלול נסיעה בכבישים.
WALKINGEnumמסלולי הליכה דרך שבילים להולכי רגל ומדרכות (אם יש כאלה).
BICYCLINGEnumמסלולי אופניים דרך שבילי אופניים ורחובות מועדפים (אם הם זמינים).
TRANSITEnumמסלולי תחבורה ציבורית דרך נתיבים של תחבורה ציבורית (אם האפשרות הזו זמינה).

StaticMap

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הגדרת גורם הזום, או רמת ההגדלה, של המפה.

StaticMapEnums

מאפיינים

נכססוגתיאור
ColorColor
FormatFormat
MarkerSizeMarkerSize
TypeType

Type

מאפיינים

נכססוגתיאור
ROADMAPEnumמפת דרכים רגילה, כפי שהיא מוצגת בדרך כלל באתר של מפות Google.
SATELLITEEnumמפת לוויין.
TERRAINEnumמפת גובה פיזית, שמוצגים בה פני השטח והצמחייה.
HYBRIDEnumשילוב של מפת לוויין ומפת כבישים, שבו מוצגת שכבה שקופה של רחובות ראשיים ושמות מקומות במפת הלוויין.