ベストプラクティス

このセクションでは、API を操作するときに圧縮を使用し、Simple (GeoJSON) 形式と FlexiblePolyline 形式から選択するためのベストプラクティスについて説明し、パフォーマンス、帯域幅、データ処理を最適化するためのガイダンスを提供します。

圧縮

API を操作するときにアプリケーションのパフォーマンスと効率を向上させるために、特に大きなテキストベースのペイロードを処理する場合は、レスポンスの圧縮を有効にすることをお勧めします。API リクエストに Accept-Encodingヘッダーを含め、任意の圧縮方法を指定することで、圧縮をアクティブ化できます。圧縮機能deflateでは gzipと がサポートされており、gzip通常、圧縮率が向上します。

圧縮を有効にするタイミング

大規模なレスポンス

大きなテキストベースのレスポンスの圧縮を有効にして、帯域幅の使用量を減らし、ロード時間を短縮します。

ネットワークの制限

アプリケーションが限られた帯域幅または高レイテンシーネットワークで動作している場合、圧縮はデータ転送効率を向上させることができます。

圧縮を効果的に使用する方法

Accept-Encoding ヘッダーを設定する

HTTP リクエストAccept-Encoding: gzip, deflateに を含めて、これらの圧縮方法をサポートしていることを API に通知します。圧縮を有効にして処理する方法は、AWS SDK とプログラミング言語によって異なります。たとえば、AWS SDK for Java v1 は ClientConfiguration クラスの withGzipメソッドを使用して gzip を有効にしますが、AWS SDK for Go では圧縮処理に特定のミドルウェアを追加する必要があります。その他の SDKs の詳細については、AWS SDK リファレンスガイドを参照してください。

解凍を適切に処理する

クライアントアプリケーションが API によって返されたContent-Encodingヘッダーに基づいてレスポンスを正しく解凍できることを確認します。

テストとモニタリング

アプリケーションのパフォーマンスに対する圧縮の影響を定期的に評価し、ペイロードサイズを縮小する利点と、解凍プロセスによる追加の CPU オーバーヘッドとのバランスを取ります。

Polyline (ポリライン)

API を操作するときに Simple (GeoJSON) 形式と FlexiblePolyline 形式を選択し、地理空間データのパフォーマンスと使いやすさの両方を最適化するためのベストプラクティス。

Simple (GeoJSON) 形式を使用する

読みやすさと標準化

さまざまな地理空間ツールとのデバッグと相互運用性を容易にするために、広く認識され、人間が読める形式が必要な場合に使用します。

精度

GeoJSON は完全な 10 進精度を損失なく維持するため、アプリケーションで座標に高精度が必要な場合は Simple 形式を選択します。

小さいデータセット

シンプルな形式は、圧縮のサイズ削減の利点が最小限である、より小さな座標データのセットを操作する場合に最適です。

FlexiblePolyline 形式を使用する

データサイズの削減

FlexiblePolyline は、損失の大きい圧縮手法を活用して、特に座標の大きなリストで送信されるデータ量を最小限に抑える必要がある場合に最適です。

URL の安全性

FlexiblePolyline は、追加のエンコードなしでクエリパラメータで直接使用できる、コンパクトで URL に安全な文字列を提供します。

パフォーマンスの最適化

FlexiblePolyline はペイロードサイズを縮小し、データ転送を高速化し、帯域幅の使用量を減らすため、高性能アプリケーションや制約のあるネットワーク上で動作するアプリケーションにとって不可欠です。