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

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

בבקשת ה-GET ב-HTTPS הזו, 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

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