Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Peta statis
**catatan**
Peta statis hanya mendukung gaya Standar dan Satelit. Untuk informasi selengkapnya, lihat [AWS gaya peta dan fitur](map-styles.md).
Peta statis menawarkan representasi data geografis yang telah dirender sebelumnya dengan opsi untuk melapisi penanda (atau pin), rute, dan area poligon, sesuai kebutuhan untuk aplikasi Anda. Peta Statis memungkinkan Anda menghasilkan gambar peta statis (non-interaktif) berdasarkan parameter dan input data yang dapat disesuaikan. Dengan menyesuaikan overlay, bentuk, atau menerapkan gaya kustom, Static Map memungkinkan Anda membuat visualisasi peta yang memenuhi kebutuhan spesifik, meningkatkan pengalaman pengguna akhir dan mengkomunikasikan informasi geografis secara efektif. Server menyesuaikan gambar peta yang diminta dan mengirimkannya ke klien sebagai file JPEG. Anda dapat secara terprogram meminta dan menghasilkan gambar peta yang disesuaikan dengan kebutuhan spesifik Anda.
*GetStaticMap API* menghasilkan gambar statis peta berdasarkan parameter tertentu seperti koordinat tengah, kotak pembatas, atau overlay. API memungkinkan penyesuaian fitur dan gaya peta, memungkinkan penggunaan dalam aplikasi web atau seluler tanpa fungsionalitas peta interaktif.
Untuk informasi selengkapnya, lihat [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)di *Referensi API Amazon Location Service*.
Misalnya permintaan, tanggapan, cURL, dan perintah CLI untuk API ini, lihat [Cara](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html) menggunakan peta Statis.
## Kasus penggunaan umum
+ **Peta tertanam di web atau aplikasi seluler:** Gambar peta statis dapat disematkan secara efisien di situs web atau aplikasi seluler untuk memberikan visualisasi lokasi, rute, atau tempat menarik dengan peta non-interaktif, mengurangi waktu muat dan penggunaan data. Contohnya termasuk mesin pencari (seperti Yahoo) yang menampilkan gambar peta dengan hasil pencarian POIs.
+ **Detail lokasi dalam email:** Gambar peta statis dapat digunakan untuk berbagi informasi lokasi melalui email untuk membantu pengguna akhir Anda memahami konteks email. Misalnya, aplikasi pengiriman makanan atau berbagi perjalanan menggunakan gambar peta statis untuk menampilkan lokasi penjemputan/pengantaran, rute, atau area sekitarnya dalam email pasca-perjalanan atau pengiriman yang berisi tagihan dan ringkasan.
+ **Materi pemasaran dan dokumen cetak:** Gambar peta statis yang disesuaikan dapat dimasukkan ke dalam brosur, selebaran, atau materi cetak lainnya, memberikan representasi informasi geografis yang menarik secara visual yang relevan dengan konten.
## Pahami permintaannya
Permintaan mencakup parameter URI opsional`BoundedPositions`, seperti`BoundingBox`,`Center`, dan, antara lain, untuk menentukan area yang terlihat dan hamparan peta. Parameter `Height` dan `Width` diperlukan untuk menentukan ukuran gambar. Untuk mempelajari selengkapnya, lihat [Sesuaikan peta statis](customizing-static-maps.md) dan [Hamparan pada peta statis](overlaying-static-map.md).
+ `BoundedPositions`: Koordinat untuk mencakup dalam gambar.
+ `BoundingBox`: Koordinat yang mendefinisikan tepi barat daya dan timur laut peta.
+ `Height`: Menentukan ketinggian gambar.
+ `Width`: Menentukan lebar gambar.
+ `GeoJsonOverlay`: Objek GeoJSON yang valid untuk menambahkan overlay.
## Pahami tanggapannya
Respons berisi header seperti`CacheControl`,, dan `ContentType``ETag`, dan mengembalikan peta statis sebagai gumpalan biner baik dalam format JPEG atau PNG. Header menyediakan metadata seperti kontrol cache, jenis konten, dan versi untuk gambar statis.
+ `CacheControl`: Menentukan konfigurasi caching untuk gambar peta.
+ `ContentType`: Menunjukkan format gambar peta (JPEG atau PNG).
+ `ETag`: Pengidentifikasi untuk versi gambar peta statis.
+ `Blob`: Merupakan gambar peta dalam format JPEG atau PNG.
# Sesuaikan peta statis
**catatan**
Peta statis hanya mendukung gaya Satelit. Untuk informasi selengkapnya, lihat [AWS gaya peta dan fitur](map-styles.md).
Bagian ini memberikan gambaran umum tentang cara menyesuaikan peta statis yang dihasilkan menggunakan Amazon Location Service. Ini mencakup berbagai fitur, seperti menyesuaikan posisi peta, ukuran, bahasa, skala, hamparan, dan atribusi, memungkinkan Anda untuk menyesuaikan peta dengan kebutuhan spesifik Anda.
Untuk informasi selengkapnya, lihat [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)di *Referensi API Amazon Location Service*.
## Posisi
Posisi ini memungkinkan Anda untuk menentukan pusat dan batas peta. Anda dapat mengontrol fokus peta dengan mengatur koordinat tengah, kotak pembatas, atau menggunakan tingkat zoom untuk menentukan berapa banyak area yang akan ditampilkan. Untuk mempelajari cara kerjanya, lihat[Cara mendapatkan peta statis dari posisi tertentu](get-static-map-specific-position.md).
+ `Center`: Mendefinisikan titik tengah peta menggunakan koordinat bujur dan lintang.
+ `Radius`: Menentukan radius (jarak dari pusat) yang akan ditampilkan pada peta statis.
+ `Bounding Box`: Mendefinisikan area persegi panjang peta, diatur dengan menyediakan koordinat sudut kiri atas dan kanan bawah.
+ `Zoom`: Mengontrol tingkat zoom peta. Tingkat zoom yang lebih tinggi menunjukkan lebih banyak detail di area yang lebih kecil, sementara tingkat zoom yang lebih rendah menunjukkan lebih sedikit detail di area yang lebih luas.
## Dimensi dan kualitas
Anda dapat menyesuaikan ukuran dan kualitas visual peta statis dengan menentukan dimensinya (tinggi dan lebar) dan menambahkan padding untuk presentasi penanda dan elemen lainnya yang lebih baik. Untuk mempelajari cara kerjanya, lihat[Cara mendapatkan peta statis dari dimensi tertentu](get-static-map-specific-dimension.md).
+ `Height and Width`: Menentukan ukuran gambar peta statis dengan mendefinisikan tinggi dan lebar dalam piksel.
+ `Padding`: Menambahkan ruang ekstra di sekitar tepi peta, memungkinkan visualisasi yang lebih baik saat menempatkan spidol, garis, atau bentuk.
## Penskalaan
Skala memberikan kontrol atas skala peta dan mendefinisikan satuan (kilometer, mil) untuk mengukur jarak. Ini berguna untuk merepresentasikan hubungan ukuran dan jarak peta secara akurat. Untuk mempelajari cara kerjanya, lihat[Cara menambahkan skala untuk peta statis](add-scale-static-map.md).
+ `Scale Unit`: Mendefinisikan unit untuk bilah skala peta (misalnya, kilometer atau mil), memungkinkan pengguna untuk mengukur jarak secara akurat di peta.
## Hamparan
Anda dapat menambahkan spidol, garis untuk menunjukkan rute, poligon untuk menampilkan area, dan banyak lagi. Untuk mempelajari cara kerjanya, lihat[Cara menambahkan penanda ke peta statis](add-marker-static-map.md),[Cara menambahkan garis ke peta statis](how-to-add-line-static.md), atau[Cara menambahkan rute ke peta statis](how-to-add-route.md).
# Hamparan pada peta statis
Bagian ini menjelaskan cara melapisi informasi tambahan ke peta statis menggunakan Amazon Location Service. Anda dapat menyesuaikan peta statis Anda dengan menambahkan berbagai fitur geografis, seperti titik, garis, dan poligon, untuk meningkatkan representasi visual peta. Amazon Location Service mendukung berbagai format, termasuk GeoJSON dan format overlay yang ringkas, untuk menyediakan cara menambahkan overlay yang fleksibel dan efisien.
Untuk informasi selengkapnya, lihat [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)di *Referensi API Amazon Location Service*.
## Dengan GeoJSON
GeoJSON adalah format serbaguna yang memungkinkan Anda untuk melapisi data khusus pada peta statis. Dengan mendefinisikan fitur geografis seperti titik, garis, dan poligon, Anda dapat meningkatkan representasi visual peta Anda, memberikan konteks yang berharga bagi pengguna. GeoJSON didukung secara luas dan menawarkan fleksibilitas dalam hal penataan dan penyesuaian hamparan peta, menjadikannya format yang ideal untuk menampilkan wilayah, merencanakan rute, atau menunjukkan hubungan spasial.
Dengan Amazon Location Service, Anda dapat memanfaatkan GeoJSON untuk menambahkan fitur dinamis berbasis lokasi langsung ke peta statis Anda. Ini memungkinkan Anda untuk membuat overlay yang sangat dapat disesuaikan yang dapat disesuaikan untuk memenuhi kebutuhan bisnis spesifik Anda. GeoJSON mendukung beberapa jenis geometri, `Point` termasuk,,`LineString`, `MultiPolygon` dan`Polygon`, memungkinkan Anda menampilkan berbagai fitur, mulai dari penanda dan rute hingga representasi area yang kompleks.
## Warna
Saat menata fitur GeoJSON, Anda memiliki fleksibilitas dalam menentukan warna. Anda dapat menentukan warna menggunakan format yang berbeda, seperti nilai heksadesimal (seperti \$1ff0000 untuk merah) atau dengan transparansi alfa (seperti \$1ff000080 untuk merah semi-transparan). Ini memastikan overlay Anda dapat konsisten secara visual dengan gaya peta. Jika tidak ada warna yang ditentukan, warna default untuk gaya peta yang dipilih akan diterapkan.
## Urutan menggambar
Hamparan khusus digambar dalam urutan tertentu untuk menjaga kejelasan dan menghindari kekacauan visual. Di Amazon Location Service, fitur overlay seperti poligon, garis, dan titik akan muncul di atas peta dasar, tetapi di bawah label peta. Urutan gambar memprioritaskan poligon terlebih dahulu, diikuti oleh garis, dan kemudian titik atau spidol.
## Satuan pengukuran
Untuk properti seperti `width` dan`outline-width`, Anda dapat menggunakan unit pengukuran yang berbeda untuk menentukan ukuran, termasuk piksel (px), meter (m), kilometer (km), mil (mi), dan persentase (%). Unit persentase menyesuaikan properti relatif terhadap nilai default, memberikan lebih banyak fleksibilitas dalam menata overlay Anda.
## Jenis geometri
Amazon Location Service mendukung beberapa jenis geometri GeoJSON, `Point` seperti`LineString`,,, dan. `Polygon` `MultiPolygon` Setiap jenis geometri dapat ditata dan disesuaikan menggunakan objek properti di GeoJSON, memungkinkan penyesuaian ekstensif penanda, rute, dan area di peta Anda.
## Dengan overlay kompak
**catatan**
Overlay kompak mendukung jenis geometri berikut: titik, garis, dan poligon. Itu tidak mendukung`multiPoint`,`multiLine`, atau`multiPolgyon`.
Opsi overlay ringkas memungkinkan Anda menampilkan beberapa geometri secara efisien pada peta statis dengan menggunakan satu parameter kueri. Pendekatan yang disederhanakan ini menyederhanakan format permintaan dan mengurangi ukuran permintaan, sehingga lebih mudah untuk mengirimkan data overlay. Pelanggan dapat memasukkan berbagai jenis geometri dan properti gaya yang sesuai dalam satu parameter kueri, dan Amazon Location Service akan menangani pengangkatan berat dengan mengurai dan merender overlay seperti yang ditentukan.
Saat menggunakan format overlay ringkas, perlu diingat bahwa ada batasan ukuran URL permintaan. Meskipun Amazon Location Service mengoptimalkan kueri, pastikan permintaan Anda tetap dalam batas yang wajar, terutama saat menangani beberapa geometri dan properti terkaitnya.
## Format
Format overlay ringkas disusun sebagai berikut: `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...`
Setiap jenis geometri didefinisikan bersama dengan sifat gayanya. Beberapa geometri dipisahkan oleh operator pipa (\$1), dan properti untuk setiap geometri dipisahkan menggunakan titik koma.
## Jenis geometri yang didukung
Amazon Location Service mendukung beberapa jenis geometri, termasuk`Point`,,`MultiPoint`, `LineString``Polygon`, dan`MultiPolygon`. Jenis geometri ini dapat digabungkan dan ditata dalam parameter kueri yang sama menggunakan format overlay ringkas.
## Properti styling
Setiap geometri dapat disesuaikan menggunakan berbagai sifat gaya, seperti warna, warna garis besar, ukuran, dan banyak lagi. Properti ini memungkinkan Anda untuk mengontrol tampilan setiap geometri pada peta, memastikan bahwa overlay selaras dengan kebutuhan bisnis Anda.