Maps Service

מפות

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

שיעורים

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