הגדרת איכות של Polyline

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

מספר הנקודות שמרכיבות את הקו הפוליגוני

ככל שיש יותר נקודות, כך הקו הפוליגוני חלק יותר (במיוחד בעיקולים).

הדיוק של הנקודות בשיטת נקודה צפה

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

ציון איכות הקו הפוליגוני

כשמפעילים את ה-method‏ ComputeRoutes(), משתמשים בערך מספרי של המאפיין PolylineQuality כדי לציין את האיכות של הקו הפוליגוני.

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

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

דוגמה

בדוגמה הבאה מוסבר איך להגדיר את איכות הקו הפוליגוני בגוף הבקשה.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "polylineQuality":"HIGH_QUALITY"
}