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

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

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

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

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

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

עיצובי מפה

אפשר לקבל משבצות של עיצובי המפה עבור עיצובי המפה הבאים.

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

כדי לבקש אריחי מפה מ-Map Tiles 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
מכיל מחרוזת ייחוס שחובה להציג במפה כאשר להציג מפת דרכים ומשבצות לוויין. מידע נוסף זמין במאמר המדיניות בנושא 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
  };
}