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

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

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