אסימון סשן הוא חלק מהנתונים (
UUID)
שמשמש בקריאות REST כדי לזהות
סשן –
של חילופי הודעות קשורים. עליך לכלול אסימון סשן בכל
בקשות למשבצות דו-ממדיות ולתמונות Street View.
צריך לכלול אותו כערך של פרמטר session
שמצורף לכל הבקשות
כתובות URL.
ב-מיפוי משבצות API, אסימון סשן מייצג קבוצה מוגדרת של
אפשרויות תצוגה. זה אומר שאתם לא צריכים להעביר קבוצה של אפשרויות תצוגה עם
בכל בקשה של משבצת. ניתן להשתמש באותו אסימון סשן במספר לקוחות.
אסימון סשן תקף כרגע למשך שבועיים
אבל הדבר עשוי להשתנות. תמיד אפשר לבדוק את תאריך התפוגה של
אסימון הסשן על ידי בדיקת השדה expiry
בהודעת התשובה.
בקשה לאסימון סשן
כדי לבקש אסימון סשן, צריך לשלוח בקשת HTTPS POST אל createSession
נקודת הקצה, כפי שמוצג בדוגמה הבאה. יש לשלוח את הבקשה עם
הכותרת Content-Type: application/json
.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
שדות חובה
mapType
סוג המפה הבסיסית. הערך הזה יכול להיות אחד מהערכים הבאים:
roadmap
- משבצות המפה המצוירות הרגילות במפות Google.
satellite
- צילומי לוויין.
terrain
- תמונות של פני השטח. כשבוחרים את
terrain
כסוג המפה, צריך גם כוללים את סוג השכבהlayerRoadmap
(כפי שמתואר שדות אופציונליים ). streetview
- תמונות פנורמה של Street View. מידע נוסף זמין במאמר הבא: כרטיסי מידע של Street View.
language
תג שפה של IETF שמציין את השפה להצגת המידע במשבצות. עבור לדוגמה,
en-US
מציין את השפה האנגלית כפי המדוברת בארצות הברית.region
א' מאגר נתוני מיקום נפוצים מזהה אזור (שתי אותיות רישיות) שמייצג את המיקום הפיזי של המשתמש. לדוגמה,
US
.
שדות אופציונליים
imageFormat
- קביעת הפורמט של הקובץ שיוחזר. הערכים החוקיים הם
jpeg
אוpng
. קובצי JPEG לא תומכים בשקיפות, ולכן הם לא מומלצים ליצור שכבת-על של משבצות. אם לא מצייניםimageFormat
, אז הפורמט הטוב ביותר עבור המשבצת נבחרת באופן אוטומטי. scale
התאמת גודל הרכיבים במפה (כגון תוויות של דרכים), תוך שמירה על גודל המשבצת ואזור הכיסוי של משבצת ברירת המחדל. גם הגדלת קנה המידה מפחית את מספר התוויות במפה, וכך להפחית את העומס. הבאים הערכים הם ערכי
scale
חוקיים:scaleFactor1x
: ברירת המחדל.scaleFactor2x
: להכפלת התווית והסרת התוויות המשניות של התכונות.scaleFactor4x
: גודל התווית יוכפל לארבעה והסרת תוויות משניות של תכונות.
הדוגמאות הבאות ממחישות את ההשפעה של שינוי קנה המידה של רכיבי מפה.
גורם קנה מידה 1x | גורם קנה מידה 2 |
---|---|
highDpi
- ההגדרה קובעת אם להחזיר משבצות ברזולוציה גבוהה. אם הגורם לקביעת קנה המידה הוא
גדל, הפונקציה
highDpi
משמשת להגדלת המשבצת. בדרך כלל, הגדלת גורם קנה המידה מגדילה את האריח שמתקבל לתמונה של בגודל זהה, מה שמקטין את האיכות. עםhighDpi
, גם הגודל שמתקבל גדל, שומר על האיכות. פירוש ראשי התיבות DPI הוא Dots per Inch ו-High DPI הרינדור של האריח מתבצע באמצעות יותר נקודות לאינץ' מהרגיל. אם הערך שלו הואtrue
, הערך של מספר הפיקסלים בכל אחד מהמאפיינים x ו-y מוכפל בקנה מידה או 2x או 4x. שטח הכיסוי של המשבצת נשאר ללא שינוי. הפרמטר הזה פועל רק עם ערכיscale
של 2x או 4x. אין לזה השפעה על 1x מספר משבצות.
גורם קנה מידה 1x | גורם קנה מידה פי 2 DPI גבוה |
---|---|
layerTypes
מערך ערכים שמציין את סוגי השכבות שנוספו למפה. נתונים תקפים הם:
layerRoadmap
- חובה אם מציינים את סוג המפה
terrain
. אפשר גם כשכבת-על על סוג המפהsatellite
. אין לכך השפעה על משבצות מפת הדרכים. layerStreetview
- הצגת רחובות ומיקומים שתומכים ב-Street View באמצעות קווי מתאר כחולים במפה.
layerTraffic
- הצגת מצב התנועה הנוכחי.
styles
מערך של אובייקטים בסגנון JSON שמציינים את המראה ורמת הפירוט של במפה, כגון כבישים, פארקים ואזורים מובנים. העיצוב משמש להתאים אישית את המפה הבסיסית הרגילה של Google. הפרמטר
styles
חוקי רק אם סוג המפה הואroadmap
. כדי לבדוק את התחביר המלא של הסגנון, אפשר לעיין חומר עזר לסגנון.overlay
ערך בוליאני שמציין אם
layerTypes
צריך להיות מוצגות כשכבת-על נפרדת או בשילוב עם התמונה הבסיסית. מתיtrue
, המפה הבסיסית לא מוצגת. אם לא הגדרתםlayerTypes
, המערכת תתעלם מהערך הזה.
לדוגמה, בקשת סוג מפה satellite
עם שכבת layerRoadmap
, וגם
הערך overlay
הוגדר לערך false
תוצאות במשבצות שוות ערך לסוג המפה hybrid
שנמצא בשימוש ב-Maps JavaScript API (תמונה משמאל). זהה
סוגי המפה והשכבות שבהם overlay
מוגדר כ-true
יוצרים משבצת שקופה
בשכבת-על של מפה, שעוצבה באופן המתאים לשכבת-על מעל צילומי לוויין
(תמונה מימין).
overlay : לא נכון |
overlay : נכון |
---|---|
קובץ ה-JSON הבא הוא דוגמה לגוף בקשה אופייני שמכיל את שתי האפשרויות שדות חובה ושדות אופציונליים.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
בדוגמה הזו מוצגת שכבת-על שמתאימה לשילוב עם לוויין של תמונות. הדוגמה כוללת גם מפת דרכים וגם שכבת-על של Street View. שהמפה שמתקבלת מעובדת עם שמות ונתונים בשפה האנגלית, המדוברות בארצות הברית.
apiOptions
: מערך ערכים שמציין אפשרויות נוספות להחלה.
האפשרויות הנתמכות הן:
MCYJ5E517XR2JC
- הבעת הסכמה ל מפה חדשה סגנון. במהלך תקופת ההצטרפות, הבקשות שלכם יקבלו את סגנון, אלא אם צוין ערך זה.
תגובה של אסימון סשן
קובץ ה-JSON הבא הוא דוגמה לגוף תגובה.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
הרשימה הבאה כוללת הגדרות של השדות בגוף התשובה.
session
- ערך אסימון סשן שצריך לכלול בכל ה-API של אריחי המפה בבקשות.
expiry
- מחרוזת שמכילה את השעה (בשניות מאז תחילת התקופה) שבה האסימון בתוקף עד. אסימון סשן תקף למשך שבועיים ממועד יצירתו אבל המדיניות הזו עשויה להשתנות ללא התראה.
tileWidth
- הרוחב של המשבצות נמדד בפיקסלים.
tileHeight
- גובה המשבצות שנמדד בפיקסלים.
imageFormat
- פורמט התמונה, שיכול להיות
png
אוjpeg
.