הגדרת איכות של 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"
}