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