קטעי דרך למפת דרכים

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

המערכת מאחזרת משבצות של מפת הדרכים

אחרי שמקבלים אסימון סשן, אפשר להתחיל לשלוח בקשות למשבצת מפת הדרכים. מכיוון שאסימון הסשן חל על כל הסשן, לא צריך לציין את אפשרויות המפה בבקשות למשבצות.

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

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

כדי לקבל משבצות עם מפת דרכים, צריך לשלוח בקשת HTTPS GET כמו בדוגמה הבאה.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

בבקשת HTTPS GET הזו, z היא רמת הזום (בין 0 ל-22), ו-x ו-y הן קואורדינטות המשבצות של המשבצת שרוצים לאחזר.

הפרמטר orientation הוא אופציונלי. הערך שלו מציין את מספר המעלות של הסיבוב נגד כיוון השעון של תמונת המשבצת. אפשר להשתמש ב-orientation במשבצות roadmap, והוא נתמך גם בבקשות לוויין ושטח, כשתמונות הבסיס הוסרו באמצעות "overlay": true וכשמגדירים את layerTypes. הערכים התקינים של הפרמטר orientation הם 0 (ברירת המחדל), 90, 180 ו-270.

אם כוללים ערך orientation, רשת הקואורדינטות של המשבצות לא מסובבת. לדוגמה, אם מגדירים את orientation ל-90, אז הקואורדינטה x עדיין מגדירה את המיקום של המשבצת משמאל לימין, שבמקרה הזה הוא מצפון לדרום במפה.

כיוון של אפס מעלות כיוון של 90 מעלות
כיוון של אפס מעלות כיוון של 90 מעלות

דוגמה לבקשת משבצת

נבחן את הדוגמה הבאה, שמבקשת משבצת אחת שמכילה את כל העולם. בדוגמה הזו, רמת הזום היא 0 והקואורדינטות x ו-y הן 0, 0.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

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

כל העולם באריח אחד

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

למידע נוסף על כותרות של הודעות תגובה, ראו אחזור מראש, שמירה במטמון ואחסון של תוכן.