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

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

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