Configurer la qualité des polylignes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La qualité d'une polyligne peut être décrite comme suit:
- Nombre de points qui composent la polyligne
- Plus il y a de points, plus la polyligne est fluide (en particulier dans les courbes).
- Précision à virgule flottante des points
- Les points sont spécifiés sous la forme de valeurs de latitude et de longitude, qui sont représentées au format à virgule flottante à précision simple. Cela fonctionne bien pour les petites valeurs (qui peuvent être représentées avec précision), mais la précision diminue à mesure que les valeurs augmentent en raison des erreurs d'arrondi à virgule flottante.
Spécifier la qualité des polylignes
Lorsque vous appelez la méthode ComputeRoutes(), vous utilisez une valeur d'énumération PolylineQuality pour spécifier la qualité de la polyligne.
Utilisez la valeur HIGH_QUALITY lorsque vous souhaitez créer une polyligne composée du nombre maximal de points pour obtenir une polyligne de la plus haute résolution possible. Cette qualité accrue se fait au détriment de la latence de réponse.
Utilisez la valeur OVERVIEW lorsque vous souhaitez créer un aperçu basse résolution de l'itinéraire, qui est une polyligne composée d'un nombre minimal de points. Cette option génère des réponses avec la latence la plus faible.
Exemple
L'exemple suivant montre comment définir la qualité de la polyligne dans le corps de la requête.
{
"origin":{
"location":{
"latLng":{
"latitude":37.419734,
"longitude":-122.0827784
}
}
},
"destination":{
"location":{
"latLng":{
"latitude":37.417670,
"longitude":-122.079595
}
}
},
"polylineQuality":"HIGH_QUALITY"
}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/04/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/04/25 (UTC)."],[[["\u003cp\u003ePolyline quality is determined by the number of points and their floating-point precision, impacting smoothness and accuracy.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eHIGH_QUALITY\u003c/code\u003e setting yields the most detailed polyline with maximum points, potentially increasing response time.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOVERVIEW\u003c/code\u003e setting creates a simplified polyline with minimal points, prioritizing faster response.\u003c/p\u003e\n"],["\u003cp\u003eYou can adjust the polyline quality using the \u003ccode\u003ePolylineQuality\u003c/code\u003e enumeration when making API requests, as shown in the example.\u003c/p\u003e\n"]]],["Polyline quality depends on the number of points and their floating-point precision. The `ComputeRoutes()` method uses `PolylineQuality` to set this. `HIGH_QUALITY` creates a polyline with the maximum points, resulting in high resolution but increased latency. `OVERVIEW` generates a low-resolution polyline with minimal points, reducing latency. The request body sets `polylineQuality` to specify either `HIGH_QUALITY` or `OVERVIEW`, which will influence the polyline's precision.\n"],null,["# Configure Polyline Quality\n\nThe quality of a polyline can be described in the following terms:\n\nThe number of points that make up the polyline\n: The more points there are, the smoother the polyline (especially in curves).\n\nThe floating-point precision of the points\n: Points are specified as latitude and longitude values, which are\n represented in single-precision floating-point format. This works well for\n small values (which can be represented precisely), but precision decreases\n as values increase because of floating-point rounding errors.\n\nSpecifying polyline quality\n---------------------------\n\nWhen you call the `ComputeRoutes()` method, you use a\n[`PolylineQuality`](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeRoutes#polylinequality)\nenumeration value to specify the quality of the polyline.\n\nUse the `HIGH_QUALITY` value when you want to create a polyline composed of the\nmaximum number of points, to produce a polyline of the highest resolution. This\nincreased quality comes at the expense of response latency.\n\nUse the `OVERVIEW` value when you want to create a low-resolution overview of\nthe route, which is a polyline composed of a minimal number of points. This\noption produces responses with the lowest latency.\n\n### Example\n\nThe following example demonstrates how to set the polyline quality in the\nrequest body. \n\n```cplint\n{\n \"origin\":{\n \"location\":{\n \"latLng\":{\n \"latitude\":37.419734,\n \"longitude\":-122.0827784\n }\n }\n },\n \"destination\":{\n \"location\":{\n \"latLng\":{\n \"latitude\":37.417670,\n \"longitude\":-122.079595\n }\n }\n },\n \"polylineQuality\":\"HIGH_QUALITY\"\n}\n```"]]
