סקירה כללית של משבצות דו-ממדיות

דוגמה למפת דרכיםמשבצות מפה הן חלוקה של העולם ברשת של אינדקס. היא מאפשרת לגשת לנתוני המפה ולהשתמש בהם ביעילות ובאופן דינמי בקנה מידה קרטוגרפי אחד. ה-API של אריחי המפה מאפשר לך לגשת לכמה מערכי נתונים גיאוגרפיים לפי נושאים, כולל מערכי נתונים ש-Google אספה:

  • קטעי תמונות במפת דרכים על סמך נתונים טופוגרפיים וקטוריים עם הסגנון הקרטוגרפי של Google.

  • אורתופוטוגרפיה שמצולמת באמצעות מצלמות לוויין וגם מצלמות אוויריות שמספקות תמונות מלמעלה (נאדיר) של כדור הארץ.

  • מפות מתאר של צללים.

משבצות מפה דו-ממדיות מכילות הפניה גיאוגרפית ויישור קו אחד לשני. הן נבחרות בהתאם להיקף הגיאוגרפי של אזור התצוגה ולרמת המרחק מהתצוגה. רמות הזום נעות בין אפס (כדי להציג את העולם בשלמותו) ל-22 (כדי להציג רחובות ובלוקים).

עיצובי מפה

אתם יכולים לקבל אריחי מפה עבור נושאי המפה הבאים.

עיצוב מפה תיאור
מפת דרכים כבישים, מבנים, נקודות עניין וגבולות פוליטיים
לוויין תמונות מצולמות מהחלל
פני השטח מפת מתאר שמציגה ישויות טבעיות כמו צמחייה

על מנת לבקש אריחי מפה מה-API של אריחי המפה, קודם צריך לבקש אסימון הפעלה. אסימון הסשן עוקב אחרי המצב הנוכחי של המפה ואזור התצוגה. כשמגדירים את אסימון הסשן, צריך להגדיר את הערך mapType כך שיתאים לעיצוב המפה הרצוי. לאחר מכן, עליכם לכלול את אסימון הסשן בכל אחת מהבקשות לממשק ה-API של אריחי המפה.

בקשות לקבלת מידע על אזור התצוגה

אזור התצוגה מגדיר את גודל התיבה שמשמשת כמסגרת לסצנה בעולם. בקשות לקבלת מידע על אזורי התצוגה מחזירות פרטים על אריחי המפה שמהם מורכב אזור התצוגה הנוכחי. הסיבה לכך שמבקשים פרטים של אזור התצוגה היא כדי לוודא שאתם נמנעים מבקשות לתמונות ברמות זום שלא קיימות.

לדוגמה, ברוב הערים יש תמונות ברמת זום 22, אבל לא את הים, כי בסופו של דבר יופיעו ריבועים כחולים ללא חלק.

הבקשה של אזור התצוגה היא בקשת HTTPS GET שמופיעה בטופס הבא.

curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&zoom=zoom&north=north&south=south&east=east&west=west"

הבקשה כוללת את השדות הבאים:

zoom
רמת הזום של אזור התצוגה.
north, south, east, west
הנקודות המרוחקות ביותר מצפון, מדרום, ממזרח וממערב באזור התצוגה, ומבוטאת במעלות. צפון ודרום חייבים להיות בטווח (-90,90), מזרח ומערב צריכים להיות בטווח (-180, 180). כדי לבטא את הגבולות שחוצים את קו האורך 180, מערב יכול להיות חיובי (לדוגמה, 170) ומזרח יכול להיות שלילי (לדוגמה, 170-). כל הפרמטרים נדרשים.

תגובות לגבי מידע על אזור התצוגה

תגובת אזור התצוגה מציינת באילו אזורים יש תמונות ובאילו רמות מרחק התצוגה. תגובה עם מידע של אזור התצוגה בפורמט הבא.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    {
      "maxZoom": 9,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    {
      "maxZoom": 14,
      "north": 84.375,
      "south": -84.375,
      "east": 180,
      "west": -180
    }, ...
  ]
}

גוף התשובה מכיל את השדות הבאים.

copyright
מכיל מחרוזת ייחוס שצריך להציג במפה כשמציגים מפת דרכים וקטעי לוויין. למידע נוסף, קראו את המדיניות בנושא Map APIs API.
maxZoomRect
יש בו מערך של מלבנים עם גבולות שחופפים לאזור התצוגה הנוכחי. כולל גם את מרחק התצוגה המרבי הזמין בתוך כל מלבן.

פונקציות קואורדינטות של משבצות

כלים (פונקציות פשוטות) זמינים ברוב שפות התכנות כדי לבצע המרה מצמדי קווי אורך ורוחב לקואורדינטות משבצות ברמה ספציפית של מרחק מתצוגה. עיינו בדוגמה הבאה של קוד JavaScript, שממיר קודם כל מ-latLng לנקודה, ולאחר מכן מנקודה לקואורדינטות.

var TILE_SIZE = 256;

function fromLatLngToPoint(latLng) {
  var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
  return {
    x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
    y: TILE_SIZE / 2 * (1 +  mercator / Math.PI)
  };
}

function fromLatLngToTileCoord(latLng, zoom) {
  var point = fromLatLngToPoint(latLng);
  var scale = Math.pow(2, zoom);

  return {
    x: Math.floor(point.x * scale / TILE_SIZE),
    y: Math.floor(point.y * scale / TILE_SIZE),
    z: zoom
  };
}