אריחי פני שטח הם משבצות תמונה שמכילות מיפוי של צלע גבעה וקווי מתאר. הם כוללים תכונות טבעיות כמו צמחייה.
קבלת משבצות של פני שטח
אפשר להתחיל לשלוח בקשות למשבצת הווידאו אחרי שמקבלים אסימון סשן. מכיוון שאסימון סשן חל על כל הסשן, לא צריך לציין את אפשרויות המפה בבקשות למשבצות.
דוגמת הקוד הבאה מציגה בקשה אופיינית של אסימון סשן למשבצות פני שטח.
curl -X POST -d '{ "mapType": "terrain", "language": "en-US", "region": "US", "layerTypes": ["layerRoadmap"] }' \ -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
דוגמה לבקשת משבצת
נבחן את הדוגמה הבאה, שמבקשת אריח יחיד של פני שטח עם רמת זום 10, עם קואורדינטות x ו-y של (192, 401).
curl "https://tile.googleapis.com/v1/2dtiles/10/192/401?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY" --output /tmp/example_tile.png
בדוגמה הזו אין הודעת תגובה מהשרת. במקום זאת, המשבצת רק מורידה לקובץ מקומי.
למידע נוסף על כותרות של הודעות תגובה, ראו אחזור מראש, שמירה במטמון ואחסון של תוכן.