Best practice

Questa sezione descrive le migliori pratiche per l'utilizzo della compressione e la scelta tra Simple (GeoJSON) FlexiblePolyline e formati durante l'interazione con l'API, fornendo indicazioni sull'ottimizzazione delle prestazioni, della larghezza di banda e della gestione dei dati.

Compressione

Per migliorare le prestazioni e l'efficienza delle applicazioni durante l'interazione con la nostra API, si consiglia di abilitare la compressione delle risposte, soprattutto quando si ha a che fare con payload di testo di grandi dimensioni. Puoi attivare la compressione includendo l'Accept-Encodingintestazione nelle tue richieste API, specificando il metodo di compressione preferito. Supportiamo gzip e sosteniamo deflate le loro capacità di compressione, offrendo gzip in genere rapporti di compressione migliori.

Quando abilitare la compressione

Risposte ampie

Abilita la compressione per risposte di testo di grandi dimensioni per ridurre l'utilizzo della larghezza di banda e migliorare i tempi di caricamento.

Vincoli di rete

Se l'applicazione funziona su reti a larghezza di banda limitata o ad alta latenza, la compressione può migliorare l'efficienza del trasferimento dei dati.

Come utilizzare la compressione in modo efficace

Imposta l'intestazione Accept-Encoding

Includi Accept-Encoding: gzip, deflate nelle tue richieste HTTP per informare la nostra API che supporti questi metodi di compressione. Il metodo per abilitare e gestire la compressione varia in base all'SDK AWS e al linguaggio di programmazione. Ad esempio, l'SDK AWS per Java v1 utilizza withGzip il metodo della classe per abilitare gzip, mentre ClientConfiguration l'SDK AWS for Go richiede l'aggiunta di un middleware specifico per la gestione della compressione. Per altre informazioni SDKs, consulta la AWS SDK Reference Guide per istruzioni dettagliate.

Gestisci correttamente la decompressione

Assicurati che la tua applicazione client possa decomprimere correttamente le risposte in base all'Content-Encodingintestazione restituita dalla nostra API.

Test e monitoraggio

Valuta regolarmente l'impatto della compressione sulle prestazioni dell'applicazione, bilanciando i vantaggi di dimensioni ridotte del payload con eventuali sovraccarichi aggiuntivi della CPU derivanti dai processi di decompressione.

Polilinea

Le migliori pratiche per scegliere tra Simple (GeoJSON) FlexiblePolyline e formati quando si interagisce con la nostra API, per ottimizzare sia le prestazioni che l'usabilità dei dati geospaziali.

Usa il formato semplice (GeoJSON)

Leggibilità e standardizzazione

Utilizzalo quando hai bisogno di un formato ampiamente riconosciuto e leggibile dall'uomo per facilitare il debug e l'interoperabilità con vari strumenti geospaziali.

Precisione

Scegli il formato Simple quando la tua applicazione richiede un'elevata precisione per le coordinate, poiché GeoJSON mantiene la massima precisione decimale senza perdite.

Set di dati più piccoli

Il formato semplice è ideale quando si lavora con set di dati di coordinate più piccoli in cui i vantaggi della compressione in termini di riduzione delle dimensioni sono minimi.

Usa il FlexiblePolyline formato

Riduzione delle dimensioni dei dati

FlexiblePolyline è ideale quando è necessario ridurre al minimo la quantità di dati trasmessi, soprattutto per elenchi di coordinate di grandi dimensioni, sfruttando tecniche di compressione con perdita di dati.

Sicurezza degli URL

FlexiblePolyline fornisce una stringa compatta e sicura per gli URL che può essere utilizzata direttamente nei parametri di query senza codifica aggiuntiva.

Ottimizzazione delle prestazioni

FlexiblePolyline aiuta a ridurre le dimensioni del payload, portando a un trasferimento dati più rapido e a un minore utilizzo della larghezza di banda, il che lo rende fondamentale per le applicazioni ad alte prestazioni o per quelle che operano su reti vincolate.