Bonnes pratiques

Cette section décrit les meilleures pratiques relatives à l'utilisation de la compression et au choix entre Simple (GeoJSON) et les FlexiblePolyline formats lors de l'interaction avec l'API, en fournissant des conseils sur l'optimisation des performances, de la bande passante et de la gestion des données.

Compression

Pour améliorer les performances et l'efficacité de vos applications lors de l'interaction avec notre API, il est recommandé d'activer la compression des réponses, en particulier lorsque vous traitez de grandes charges utiles basées sur du texte. Vous pouvez activer la compression en incluant l'Accept-Encodingen-tête dans vos demandes d'API, en spécifiant votre méthode de compression préférée. Nous soutenons gzip et deflate soutenons leurs capacités de compression, en proposant gzip généralement de meilleurs taux de compression.

Quand activer la compression

Réponses volumineuses

Activez la compression pour les réponses textuelles volumineuses afin de réduire l'utilisation de la bande passante et d'améliorer les temps de chargement.

Contraintes du réseau

Si votre application fonctionne sur une bande passante limitée ou sur des réseaux à latence élevée, la compression peut améliorer l'efficacité du transfert de données.

Comment utiliser efficacement la compression

Définissez l'en-tête Accept-Encoding

Incluez Accept-Encoding: gzip, deflate dans vos requêtes HTTP pour informer notre API que vous acceptez ces méthodes de compression. La méthode d'activation et de gestion de la compression varie en fonction du SDK AWS et du langage de programmation. Par exemple, le SDK AWS pour Java v1 utilise la méthode de withGzip la classe pour activer gzip, tandis que ClientConfiguration le SDK AWS pour Go nécessite l'ajout d'un intergiciel spécifique pour la gestion de la compression. Pour les autres SDKs, reportez-vous au guide de référence du SDK AWS pour obtenir des instructions détaillées.

Gérez correctement la décompression

Assurez-vous que votre application cliente peut correctement décompresser les réponses en fonction de l'Content-Encodingen-tête renvoyé par notre API.

Testez et surveillez

Évaluez régulièrement l'impact de la compression sur les performances de votre application, en équilibrant les avantages de la réduction de la charge utile par rapport à la surcharge CPU supplémentaire résultant des processus de décompression.

Polyline

Les meilleures pratiques pour choisir entre des formats simples (GeoJSON) et des FlexiblePolyline formats lors de l'interaction avec notre API, afin d'optimiser à la fois les performances et la convivialité de vos données géospatiales.

Utiliser le format simple (GeoJSON)

Lisibilité et standardisation

À utiliser lorsque vous avez besoin d'un format largement reconnu et lisible par l'homme pour faciliter le débogage et l'interopérabilité avec divers outils géospatiaux.

Précision

Choisissez le format simple lorsque votre application a besoin d'une haute précision pour les coordonnées, car GeoJSON conserve une précision décimale complète sans perte.

Ensembles de données plus petits

Le format simple est idéal lorsque vous travaillez avec de petits ensembles de données de coordonnées où les avantages de la compression en termes de réduction de taille sont minimes.

Utiliser le FlexiblePolyline format

Réduction de la taille des données

FlexiblePolyline est idéal lorsque vous devez minimiser la quantité de données transmises, en particulier pour les grandes listes de coordonnées, en utilisant des techniques de compression avec perte.

Sécurité des URL

FlexiblePolyline fournit une chaîne compacte sécurisée pour les URL qui peut être utilisée directement dans les paramètres de requête sans encodage supplémentaire.

Optimisation des performances

FlexiblePolyline contribue à réduire la taille de la charge utile, ce qui accélère le transfert de données et réduit l'utilisation de la bande passante, ce qui en fait un outil crucial pour les applications à hautes performances ou celles fonctionnant sur des réseaux restreints.