Maps Service

מפות

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

שיעורים

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

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מחזירה נתוני גובה עבור סדרה של נקודות (קו רוחב/קו אורך).
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 חדש.
resetAuthenticationApiKey()voidמאפס את פרטי האימות כדי להשתמש במכסות ברירת המחדל.
setAuthenticationByApiKey(apiKey)voidמאפשר להשתמש במפתח API כדי לאמת בקשות לניצול מכסות נוספות.
setAuthenticationByApiKey(apiKey, signingKey)voidמאפשר להשתמש במפתח API ובמפתח חתימה כדי לאמת בקשות לניצול מכסות נוספות ב-StaticMap.

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שילוב של מפת הלוויין ומפת הדרכים, שבו מוצג שכבה שקופה של רחובות ראשיים ושמות מקומות על מפת הלוויין.