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