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