Mulai

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Pengantar

Maps Static API akan menampilkan gambar (baik GIF, PNG, atau JPEG) sebagai respons terhadap permintaan HTTP melalui URL. Untuk setiap permintaan, Anda dapat menentukan lokasi peta, ukuran gambar, tingkat zoom, jenis peta, dan penempatan penanda opsional di lokasi pada peta. Anda juga dapat memberi label tambahan pada penanda menggunakan karakter alfanumerik.

Gambar Maps Static API disematkan dalam atribut src dari tag <img>, atau yang setara dalam bahasa pemrograman lainnya.

Dokumen ini menjelaskan format URL Maps Static API yang diperlukan dan parameter yang tersedia. Halaman ini juga menunjukkan beberapa tips dan trik dalam menentukan URL Anda.

Sebelum memulai

Dokumen ini ditujukan untuk developer situs dan seluler yang ingin menyertakan gambar Maps Static API dalam halaman web atau aplikasi seluler. Bagian ini menyediakan pengantar tentang penggunaan API dan materi referensi tentang parameter yang tersedia.

Sebelum mulai mengembangkan aplikasi dengan Maps Static API, tinjau persyaratan autentikasi (Anda memerlukan kunci API) dan informasi penggunaan serta penagihan API (Anda perlu mengaktifkan penagihan pada project).

Parameter URL

URL Maps Static API harus dalam format berikut:

https://maps.googleapis.com/maps/api/staticmap?parameters

Jika situs Anda diakses melalui HTTPS, Anda juga harus memuat gambar Maps Static API melalui HTTPS untuk menghindari notifikasi keamanan browser. HTTPS juga direkomendasikan jika permintaan Anda menyertakan informasi sensitif pengguna, seperti lokasi pengguna:

https://maps.googleapis.com/maps/api/staticmap?parameters

Baik menggunakan HTTP atau HTTPS, parameter URL tertentu diperlukan, sedangkan parameter lainnya bersifat opsional. Seperti standar pada URL, semua parameter dipisahkan menggunakan karakter pengganti dan (&). Daftar parameter dan kemungkinan nilainya dihitung dalam dokumen ini.

Maps Static API mendefinisikan gambar peta menggunakan parameter URL berikut:

Parameter lokasi

  • center (wajib jika penanda tidak ada) menentukan bagian tengah peta, sama jaraknya dari semua tepi peta. Parameter ini mengambil lokasi sebagai pasangan {lintang,bujur} yang dipisahkan koma (misalnya, "40.714728,-73.998672") atau alamat string (mis. "balai kota, new York, ny") yang mengidentifikasi lokasi unik di permukaan bumi. Untuk informasi selengkapnya, lihat Lokasi.
  • zoom (wajib jika penanda tidak ada) menentukan tingkat zoom peta, yang menentukan tingkat pembesaran peta. Parameter ini mengambil nilai numerik yang sesuai dengan tingkat zoom pada region yang diinginkan. Untuk informasi selengkapnya, lihat Tingkat zoom.

Parameter peta

  • size (wajib) menentukan dimensi persegi panjang dari gambar peta. Parameter ini mengambil string dari format {horizontal_value}x{vertical_value}. Misalnya, 500x400 menentukan peta dengan lebar 500 piksel dan tinggi 400 piksel. Peta yang lebarnya lebih kecil dari 180 piksel akan menampilkan logo Google dengan ukuran yang diperkecil. Parameter ini dipengaruhi oleh parameter scale; ukuran output akhir adalah hasil dari nilai ukuran dan skala.
  • scale (opsional) memengaruhi jumlah piksel yang ditampilkan. scale=2 menampilkan piksel dua kali lebih banyak dari scale=1, dengan tetap mempertahankan area cakupan dan tingkat detail yang sama (yaitu konten peta tidak berubah). Hal ini berguna saat melakukan pengembangan untuk tampilan beresolusi tinggi. Nilai defaultnya adalah 1. Nilai yang diterima adalah 1 dan 2. Lihat Menskalakan Nilai untuk informasi selengkapnya.
  • format (opsional) menentukan format gambar yang dihasilkan. Secara default, Maps Static API akan membuat gambar PNG. Ada beberapa kemungkinan format, termasuk jenis GIF, JPEG, dan PNG. Format yang Anda gunakan bergantung pada cara Anda ingin menampilkan gambar. JPEG biasanya memberikan kompresi yang lebih baik, sedangkan GIF dan PNG memberikan detail yang lebih baik. Untuk mengetahui informasi selengkapnya, lihat Format Gambar.
  • maptype (opsional) menentukan jenis peta yang akan dibuat. Ada beberapa kemungkinan nilai jenis peta, termasuk roadmap, satellite, hybrid, dan terrain. Untuk informasi selengkapnya, lihat Jenis Peta Maps Static API.
  • language (opsional) menentukan bahasa yang akan digunakan untuk menampilkan label pada ubin peta. Perhatikan bahwa parameter ini hanya didukung untuk beberapa ubin negara; jika bahasa tertentu yang diminta tidak didukung untuk rangkaian ubin, maka bahasa default untuk kumpulan ubin tersebut akan digunakan.
  • region (opsional) menentukan batas yang sesuai untuk ditampilkan, berdasarkan sensitivitas geografis politik. Menerima kode wilayah yang ditentukan sebagai nilai ccTLD ('domain level teratas') yang terdiri dari dua karakter. Lihat Detail Cakupan Google Maps Platform untuk wilayah yang didukung.

Parameter fitur

  • map_id (opsional) menentukan ID untuk peta tertentu. ID Peta mengaitkan peta dengan gaya atau fitur tertentu, dan harus termasuk dalam project yang sama dengan kunci API yang digunakan untuk menginisialisasi peta. Untuk informasi selengkapnya, lihat Menggunakan ID Peta.
  • markers (opsional) menentukan satu atau beberapa penanda untuk dilampirkan ke gambar pada lokasi yang ditentukan. Parameter ini mengambil definisi penanda tunggal dengan parameter yang dipisahkan oleh karakter pipa (|). Beberapa penanda dapat ditempatkan dalam parameter markers yang sama selama penanda tersebut menunjukkan gaya yang sama; Anda dapat menambahkan penanda tambahan dengan gaya yang berbeda dengan menambahkan parameter markers tambahan. Perhatikan bahwa jika Anda menyediakan penanda untuk peta, Anda tidak perlu menentukan parameter center dan zoom (biasanya diperlukan). Untuk informasi selengkapnya, lihat Penanda Maps Static API.
  • path (opsional) menentukan satu jalur dari dua atau beberapa titik yang terhubung untuk menempatkan gambar di lokasi yang ditentukan. Parameter ini mengambil string definisi titik yang dipisahkan dengan karakter pipa (|), atau polyline yang dienkode menggunakan awalan enc: dalam deklarasi lokasi jalur. Anda dapat menyediakan jalur tambahan dengan menambahkan parameter path tambahan. Perhatikan bahwa jika Anda menyediakan jalur untuk peta, Anda tidak perlu menentukan parameter center dan zoom (biasanya diperlukan). Untuk informasi selengkapnya, lihat Jalur Maps Static API.
  • visible (opsional) menentukan satu atau beberapa lokasi yang harus tetap terlihat di peta, meskipun tidak ada penanda atau indikator lainnya yang akan ditampilkan. Gunakan parameter ini untuk memastikan bahwa fitur atau lokasi peta tertentu ditampilkan di Maps Static API.
  • style (opsional) menentukan gaya kustom untuk mengubah tampilan fitur tertentu (jalan, taman, dan fitur lainnya) pada peta. Parameter ini mengambil argumen feature dan element yang mengidentifikasi fitur yang akan ditata gayanya, dan serangkaian operasi gaya yang akan diterapkan pada fitur yang dipilih. Anda dapat menyediakan beberapa gaya dengan menambahkan parameter style tambahan. Untuk informasi selengkapnya, lihat panduan untuk peta bergaya.

Parameter kunci dan tanda tangan

  • key (wajib) memungkinkan Anda memantau penggunaan API aplikasi di Google Cloud Console, dan memastikan bahwa Google dapat menghubungi Anda terkait aplikasi jika diperlukan. Untuk informasi selengkapnya, lihat Menggunakan Kunci API dengan Maps Static API.
  • signature (direkomendasikan) adalah tanda tangan digital yang digunakan untuk memverifikasi bahwa situs yang membuat permintaan dengan kunci API Anda telah diberi otorisasi untuk melakukannya. Permintaan tanpa tanda tangan digital mungkin akan gagal. Untuk informasi selengkapnya, lihat Menggunakan Tanda Tangan Digital.

Pembatasan ukuran URL

URL Maps Static API dibatasi ukurannya hingga 8192 karakter. Dalam praktiknya, Anda mungkin tidak akan memerlukan URL lebih lama dari ini, kecuali jika Anda membuat peta yang rumit dengan jumlah penanda dan jalur yang tinggi.

Penggunaan Parameter

Maps Static API relatif mudah digunakan, karena hanya terdiri dari URL berparameter. Bagian ini menjelaskan cara menggunakan parameter ini untuk membuat URL.

Menetapkan Lokasi

Maps Static API harus dapat mengidentifikasi lokasi pada peta dengan tepat, baik untuk memfokuskan peta ke lokasi yang benar (menggunakan parameter center) maupun/atau menempatkan penanda letak opsional (menggunakan parameter markers) di lokasi pada peta. Maps Static API menggunakan angka (nilai lintang dan bujur) atau string (alamat) untuk menentukan lokasi ini. Nilai ini mengidentifikasi lokasi yang di-geocode.

Beberapa parameter (seperti parameter markers dan path) memerlukan beberapa lokasi. Dalam hal ini, lokasi dipisahkan dengan karakter pipa (|).

Lintang dan bujur

Lintang dan bujur ditentukan menggunakan angka dalam string teks yang dipisahkan koma yang memiliki presisi 6 tempat desimal. Misalnya, "40.714728,-73.998672" adalah nilai geocode yang valid. Presisi di luar 6 angka di belakang koma akan diabaikan.

Nilai bujur didasarkan pada jaraknya dari Greenwich, Inggris, yang merupakan pusat meridian utama. Karena Greenwich terletak di 51.477222 garis lintang, kita dapat memasukkan nilai center dari 51.477222,0 untuk memusatkan peta di Greenwich:

Greenwich, England

Nilai garis lintang dan garis bujur harus sesuai dengan lokasi yang valid di permukaan bumi. Lintang dapat mengambil nilai berapa pun antara -90 dan 90 sedangkan nilai bujur dapat berupa nilai apa pun antara -180 dan 180. Jika Anda menetapkan nilai lintang atau bujur yang tidak valid, permintaan akan ditolak sebagai permintaan yang buruk.

Alamat

Kebanyakan orang tidak berbicara dalam lintang dan bujur; mereka menandai lokasi menggunakan alamat. Proses mengubah alamat menjadi titik geografis dikenal sebagai geocoding dan layanan Maps Static API dapat melakukan geocoding untuk Anda jika Anda memberikan alamat yang valid.

Dalam parameter apa pun yang memungkinkan Anda menyediakan lintang/bujur, Anda dapat menentukan string yang menunjukkan alamat. Google akan melakukan geocoding alamat dan memberikan nilai lintang/bujur kepada layanan Maps Static API untuk digunakan dalam menempatkan penanda atau menentukan lokasi. String harus dienkodekan URL, sehingga alamat seperti "City Hall, New York, NY" harus dikonversi menjadi "City+Hall,New+York,NY", misalnya.

Perhatikan bahwa alamat dapat mencerminkan lokasi akurat, seperti alamat, polyline seperti rute yang dinamai, atau area poligon seperti kota, negara, atau taman nasional. Untuk hasil polylinear dan poligonal, server Maps Static API akan menggunakan titik tengah garis/area sebagai pusat alamat. Jika ragu tentang cara meng-geocoding alamat, Anda dapat menguji alamat menggunakan Utilitas Geocoding ini.

Contoh berikut menghasilkan gambar peta statis untuk Berkeley, CA:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Berkeley, CA

Tingkat zoom

Maps di Google Maps memiliki 'tingkat zoom' bilangan bulat yang menentukan resolusi tampilan saat ini. Tingkat zoom antara 0 (tingkat zoom terendah, tempat seluruh dunia dapat dilihat di satu peta) dan 21+ (sampai ke jalan dan masing-masing bangunan) dapat dilihat dalam tampilan roadmap default. Garis batas bangunan, jika tersedia, akan muncul pada peta di sekitar tingkat zoom 17. Nilai ini berbeda dari satu area ke area lain dan dapat berubah seiring waktu saat data berkembang.

Google Maps menetapkan tingkat zoom 0 yang mencakup seluruh bumi. Setiap tingkat zoom yang berhasil akan menggandakan presisi dalam dimensi horizontal dan vertikal. Informasi lebih lanjut tentang cara melakukannya tersedia di dokumentasi Google Maps JavaScript API.

Catatan: tidak semua tingkat zoom muncul pada semua lokasi di bumi. Tingkat zoom bervariasi, bergantung pada lokasi, karena data di beberapa bagian dunia lebih terperinci daripada di lokasi lain.

Jika Anda mengirim permintaan untuk tingkat zoom yang tidak tersedia pada ubin peta, Maps Static API akan menampilkan peta yang menampilkan tingkat zoom maksimum yang tersedia pada lokasi tersebut.

Daftar berikut menampilkan perkiraan tingkat detail yang akan Anda lihat di setiap tingkat zoom:

  • 1: Dunia
  • 5: Daratan luas/benua
  • 10: Kota
  • 15: Jalan
  • 20: Bangunan

Contoh ini meminta dua peta Manhattan dengan nilai center yang sama tetapi pada tingkat zoom 12 dan 14, secara berurutan:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Manhattan Dari Jauh  Manhattan Dari Dekat

Ukuran gambar

Parameter size, bersama dengan center, menentukan area cakupan peta. Ini juga menentukan ukuran output peta dalam piksel, yang dikalikan dengan nilai scale (yaitu 1 secara default).

Tabel ini menunjukkan nilai maksimum yang diizinkan untuk parameter size dalam setiap nilai scale.

scale=1 scale=2
640x640 640x640 (menampilkan 1280x1280 piksel)

Contoh ini meminta "irisan" bumi di khatulistiwa pada tingkat zoom 1:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Khatulistiwa

Contoh ini meminta peta kecil berukuran 100 x 100 piksel yang berpusat di region yang sama. Perhatikan logo Google yang lebih kecil:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Peta Ekuator Kecil

Nilai skala

Parameter size Maps Static API menentukan ukuran peta dalam piksel, sehingga peta dengan size=200x200 akan ditampilkan sebagai 200 piksel kali 200 piksel. Pada monitor komputer LCD, yang biasanya menampilkan sekitar 100 piksel per inci (ppi), peta 200x200 akan berukuran sekitar 2 inci di setiap dimensinya.

Namun, perangkat seluler semakin menyertakan layar resolusi tinggi dengan kepadatan piksel lebih dari 300 ppi, yang akan:

  • Mengurangi ukuran gambar 200x200 piksel menjadi hanya 0,7 inci, merender label dan ikon yang terlalu kecil untuk dibaca; atau
  • Skalakan (zoom) gambar untuk meningkatkan keterbacaan, sehingga menghasilkan gambar yang buram atau buram.
Terlalu kecil Terlalu kabur

Saat mengembangkan untuk perangkat seluler, Anda dapat menggunakan parameter scale API untuk menampilkan gambar peta beresolusi lebih tinggi yang menyelesaikan masalah di atas. Nilai scale dikalikan dengan size untuk menentukan ukuran output gambar yang sebenarnya dalam piksel, tanpa mengubah area cakupan peta. Nilai scale default adalah 1; nilai yang diterima adalah 1 dan 2.

Misalnya, nilai skala 2 akan menampilkan area cakupan peta yang sama dengan permintaan tanpa skala yang ditentukan, tetapi dengan piksel dua kali lebih banyak di setiap dimensi. Ini termasuk jalan dan label, sehingga dapat dibaca pada resolusi tinggi dan layar berukuran kecil, serta saat diskalakan oleh browser.

150x150 150x150&skala=2

Gambar tersebut juga akan ditampilkan dengan baik di browser desktop, jika dimasukkan ke dalam tag img atau div dengan tinggi dan lebar yang ditetapkan menggunakan CSS. Browser akan mengecilkan gambar ke ukuran yang tepat, tanpa kehilangan kualitas.

Tabel ini menampilkan tiga permintaan gambar yang berbeda.

  • Yang pertama adalah untuk gambar 100x100, tanpa menetapkan nilai skala. Ukurannya ditampilkan dengan benar di desktop, tetapi terlalu kecil untuk dibaca di perangkat seluler.
  • Permintaan kedua menggandakan ukuran peta. Di desktop, CSS akan mencocokkannya dengan elemen img 100x100 yang ditentukan, tetapi jika ukuran gambar diperkecil, jalan dan label akan menjadi terlalu kecil. Di perangkat seluler, ukuran gambar sudah tepat, tetapi sekali lagi, jalan dan label tidak terbaca.
  • Permintaan ketiga adalah untuk peta berukuran 100x100 dengan scale=2. Gambar ditampilkan dengan detail 200 piksel; desktop ini memperkecil skala dengan sempurna, sehingga tidak dapat dibedakan dengan permintaan 100x100 yang asli, sedangkan browser seluler diuntungkan dari resolusi tambahan yang ditampilkan oleh API.
Permintaan gambar
Perangkat 100x100 200x200 100x100&scale=2
Desktop
(dengan height="100px" dan
width="100px" pada
tag img)
Resolusi Tinggi
(simulasi)

Untuk informasi selengkapnya tentang cara mengembangkan aplikasi untuk layar seluler dan beresolusi tinggi, sebaiknya baca artikel berikut:

Format gambar

Gambar dapat ditampilkan dalam beberapa format grafis web umum: GIF, JPEG, dan PNG. Parameter format menggunakan salah satu nilai berikut:

  • png8 atau png (default) menentukan format PNG 8 bit.
  • png32 menentukan format PNG 32-bit.
  • gif menentukan format GIF.
  • jpg menentukan format kompresi JPEG.
  • jpg-baseline menentukan format kompresi JPEG non-progresif.

Contoh ini meminta peta dalam format gif dan png:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg dan jpg-baseline biasanya memberikan ukuran gambar terkecil, meskipun melakukannya melalui kompresi "lossy" yang dapat mendegradasi gambar. gif, png8, dan png32 memberikan kompresi lossy.

Sebagian besar gambar JPEG bersifat progresif, artinya gambar tersebut memuat gambar awal yang lebih kasar dan memperbaiki resolusi gambar saat lebih banyak data yang masuk. Dengan demikian, gambar dapat dimuat dengan cepat di halaman web dan saat ini paling banyak menggunakan JPEG. Namun, beberapa penggunaan JPEG memerlukan gambar non-progresif (dasar). Dalam kasus semacam itu, Anda mungkin ingin menggunakan format jpg-baseline, yang bersifat non-progresif.

Jenis peta

Maps Static API membuat peta dalam beberapa format, yang tercantum di bawah ini:

  • roadmap (default) menentukan gambar peta jalan standar, seperti yang biasanya ditampilkan di situs Google Maps. Jika tidak ada nilai maptype yang ditentukan, Maps Static API akan menampilkan ubin roadmap secara default.
  • satellite menentukan gambar satelit.
  • terrain menentukan gambar peta bantuan fisik, yang menampilkan medan dan vegetasi.
  • hybrid menentukan campuran gambar satelit dan peta jalan, yang menunjukkan lapisan transparan jalan utama dan nama tempat pada gambar satelit.

Anda dapat melihat perbedaan antara jenis peta jalan dan jenis medan dalam contoh kode ini.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Peta Normal Manhattan  Peta Medan Manhattan

Peta hybrid menggunakan gambar satelit dan fitur peta jalan yang menonjol untuk membuat peta kombinasi. Contoh berikut menunjukkan jenis peta satelit dan hibrida:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Peta Satelit Manhattan  Peta Medan Manhattan

Peta bergaya

Sesuaikan presentasi peta Google standar dengan menerapkan gaya Anda sendiri. Lihat panduan untuk peta bergaya.

Penanda

Parameter markers menentukan kumpulan satu atau beberapa penanda (pin peta) di serangkaian lokasi. Setiap penanda yang ditentukan dalam satu deklarasi markers harus menunjukkan gaya visual yang sama; jika ingin menampilkan penanda dengan gaya yang berbeda, Anda harus menyediakan beberapa parameter markers dengan informasi gaya terpisah.

Parameter markers mengambil kumpulan penetapan nilai (deskriptor penanda) dengan format berikut:

markers=markerStyles|markerLocation1| markerLocation2|..., dll.

Kumpulan MarkerStyles dideklarasikan di awal deklarasi markers dan terdiri dari nol atau beberapa gaya deskriptor yang dipisahkan oleh karakter pipa (|), diikuti oleh satu atau beberapa lokasi yang juga dipisahkan dengan karakter pipa (|).

Karena informasi gaya dan informasi lokasi dibatasi melalui karakter pipa, informasi gaya harus muncul terlebih dahulu dalam deskriptor penanda. Setelah server Maps Static API menemukan lokasi dalam deskriptor penanda, semua parameter penanda lainnya juga diasumsikan sebagai lokasi.

Gaya penanda

Kumpulan deskriptor gaya penanda adalah serangkaian penetapan nilai yang dipisahkan oleh karakter pipa (|). Deskripsi gaya ini menentukan atribut visual yang akan digunakan saat menampilkan penanda dalam deskriptor penanda ini. Deskripsi gaya ini berisi penetapan kunci/nilai berikut:

  • size: (opsional) menentukan ukuran penanda dari kumpulan {tiny, mid, small}. Jika tidak ada parameter size yang ditetapkan, penanda akan muncul dalam ukuran default (normal).
  • color: (opsional) menentukan warna 24-bit (contoh: color=0xFFFFCC) atau warna yang telah ditetapkan dari kumpulan {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

    Perhatikan bahwa transparansi (ditentukan menggunakan nilai warna heksadesimal 32-bit) tidak didukung dalam penanda, meskipun didukung untuk jalur.

  • label: (opsional) menentukan satu karakter alfanumerik huruf besar dari kumpulan {A-Z, 0-9}. (Persyaratan untuk karakter huruf besar adalah baru untuk versi API ini.) Perhatikan bahwa penanda berukuran default dan mid adalah satu-satunya penanda yang mampu menampilkan parameter alphanumeric-character. Penanda tiny dan small tidak dapat menampilkan karakter alfanumerik.

Penskalaan penanda

Nilai scale dikalikan dengan ukuran gambar penanda untuk menghasilkan ukuran output penanda yang sebenarnya dalam piksel. Nilai skala default adalah 1; nilai yang diterima adalah 1, 2, dan 4.

Batas ukuran piksel pada gambar berlaku setelah penskalaan diterapkan. Misalnya, jika penanda disetel ke scale:2, penanda dapat lebih besar dari ukuran maksimum 4.096 piksel, selama penanda dikurangi menjadi kurang dari 4.096 piksel setelah penskalaan. Gunakan penskalaan penanda bersama dengan penskalaan peta saat menampilkan peta dengan resolusi lebih tinggi.

Lokasi penanda

Setiap deskriptor penanda harus berisi satu atau beberapa lokasi yang menentukan tempat untuk menempatkan penanda pada peta. Lokasi ini dapat ditentukan sebagai nilai lintang/bujur atau sebagai alamat. Lokasi ini dipisahkan menggunakan karakter pipa (|).

Catatan: Jika Anda memilih untuk menentukan lokasi penanda menggunakan metode yang memerlukan geocoding, seperti string atau polyline alamat yang dapat dibaca manusia, permintaan dibatasi maksimal 15 penanda. Batas ini hanya berlaku untuk lokasi penanda yang memerlukan geocoding. Ini tidak berlaku untuk lokasi penanda yang ditentukan dengan koordinat lintang/bujur.

Parameter lokasi menentukan lokasi penanda di peta. Jika lokasi berada di luar peta, penanda tersebut tidak akan muncul dalam gambar yang dibuat, asalkan parameter center dan zoom disediakan. Namun, jika parameter ini tidak diberikan, server Maps Static API akan otomatis membuat gambar yang berisi penanda yang diberikan. (Lihat Posisi implisit.)

Contoh deklarasi penanda ditampilkan di sini. Perhatikan bahwa kita mendefinisikan satu set gaya dan tiga lokasi:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Tiga Kode ZIP Brooklyn

Untuk menentukan penanda dengan gaya yang berbeda, kita perlu menyediakan beberapa parameter markers. Kumpulan parameter markers ini menentukan tiga penanda: satu penanda biru berlabel "S" pada 62.107733, -145.5419, satu penanda hijau kecil di "Delta Junction, AK", dan satu penanda kuning berukuran sedang berlabel "C" di "Tok, AK". Penanda tersebut ditampilkan dalam contoh ini:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Tiga Kota di Alaska, Marker Berbeda

Ikon khusus

Anda dapat menggunakan ikon kustom Anda sendiri daripada menggunakan ikon penanda Google. Ikon kustom ditentukan menggunakan deskriptor icon dalam parameter markers. Contoh:

markers=icon:URLofIcon|markerLocation

Tentukan icon menggunakan URL (yang harus dienkode dengan URL). Anda dapat menggunakan URL yang dibuat oleh layanan penyingkatan URL seperti https://goo.gl. Sebagian besar layanan penyingkatan URL memanfaatkan encoding URL secara otomatis.

Anda dapat menentukan titik link untuk ikon kustom. Titik link menetapkan cara ikon ditempatkan dalam kaitannya dengan lokasi markers yang ditentukan. Secara default, titik link ikon kustom adalah bagian tengah bawah gambar ikon. Anda dapat menentukan titik link yang berbeda menggunakan deskriptor anchor bersama dengan icon. Tetapkan anchor sebagai titik x,y pada ikon (seperti 10,5), atau sebagai perataan yang telah ditetapkan menggunakan salah satu nilai berikut: top, bottom, left, right, center, topleft, topright, bottomleft, atau bottomright. Contoh:

markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2

Anda dapat menggunakan hingga lima ikon khusus unik per permintaan. Batasan ini tidak berarti bahwa Anda dibatasi hanya untuk 5 lokasi yang ditandai pada peta. Setiap ikon unik dapat digunakan dengan lebih dari satu lokasi markers pada peta Anda.

Format ikon:

  • Gambar ikon dapat dalam format PNG, JPEG, atau GIF, meskipun yang direkomendasikan adalah PNG.
  • Ukuran maksimal ikon maksimal 4096 piksel (64x64 untuk gambar persegi).
Contoh ikon khusus

Contoh 1 membuat ikon kustom dan memosisikan ikon menggunakan anchor.

http://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

Tiga kota di Australia, berbagai ikon khusus yang diposisikan dengan anchor.

Contoh 2 membuat ikon kustom yang sama seperti contoh 1, tetapi tidak menyetel posisi ikon menggunakan anchor, yang mengandalkan anchor default di bagian tengah bawah.

http://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Tiga kota di Australia, ikon khusus yang berbeda dengan posisi default.

Jalur Maps Static API

Parameter path menentukan sekumpulan satu atau beberapa lokasi yang terhubung oleh jalur untuk menempatkan overlay pada gambar peta. Parameter path mengambil kumpulan penetapan nilai (deskripsi jalur) dengan format berikut:

path=pathStyles|pathLocation1|pathLocation2|..., dll.

Perhatikan bahwa kedua titik jalur dipisahkan satu sama lain menggunakan karakter pipa (|). Karena informasi gaya dan informasi titik dibatasi melalui karakter pipa, informasi gaya harus muncul terlebih dahulu di deskriptor jalur apa pun. Setelah server Maps Static API menemukan lokasi dalam deskriptor jalur, semua parameter jalur lainnya diasumsikan sebagai lokasi juga.

Gaya jalur

Kumpulan deskriptor gaya jalur adalah rangkaian penetapan nilai yang dipisahkan karakter pipa (|). Deskripsi gaya ini menentukan atribut visual yang akan digunakan saat menampilkan jalur. Deskriptor gaya ini berisi penetapan kunci/nilai berikut:

  • weight: (opsional) menentukan ketebalan jalur dalam piksel. Jika parameter weight tidak ditetapkan, jalur akan muncul dengan ketebalan default (5 piksel).
  • color: (opsional) menentukan warna sebagai 24-bit (contoh: color=0xFFFFCC) atau nilai heksadesimal 32-bit (contoh: color=0xFFFFCCFF), atau dari kumpulan {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

    Jika nilai heksadesimal 32 bit ditentukan, dua karakter terakhir akan menentukan nilai transparansi alfa 8 bit. Nilai ini bervariasi antara 00 (sepenuhnya transparan) dan FF (sepenuhnya tidak buram). Perhatikan bahwa transparansi didukung di jalur, meskipun tidak didukung untuk penanda.

  • fillcolor: (opsional) menunjukkan bahwa jalur tersebut menandai area poligon dan menentukan warna pengisi yang akan digunakan sebagai overlay dalam area tersebut. Kumpulan lokasi berikut tidak perlu menjadi loop "tertutup"; server Maps Static API akan secara otomatis bergabung dengan titik pertama dan terakhir. Namun, perhatikan bahwa garis luar pada bagian luar area bidang tidak akan ditutup kecuali jika Anda secara khusus memberikan lokasi awal dan akhir yang sama.
  • geodesic: (opsional) menunjukkan bahwa jalur yang diminta harus ditafsirkan sebagai garis geodesi yang mengikuti kelengkungan bumi. Jika salah, jalur akan dirender sebagai garis lurus di dalam ruang layar. Nilai defaultnya adalah false (salah).

Beberapa contoh definisi jalur:

  • Garis biru tipis, opasitas 50%: path=color:0x0000ff80|weight:1
  • Garis merah solid: path=color:0xff0000ff|weight:5
  • Garis putih tebal solid: path=color:0xffffffff|weight:10

Gaya jalur ini opsional. Jika menginginkan atribut default, Anda dapat melewati proses mendefinisikan atribut jalur; dalam hal ini, "argumen" pertama deskriptor jalur akan terdiri dari titik pertama yang dideklarasikan (lokasi), bukan.

Titik jalur

Untuk menggambar jalur, parameter path juga harus diteruskan dua titik atau lebih. Maps Static API kemudian akan menghubungkan jalur di sepanjang titik tersebut, dalam urutan yang ditetapkan. Setiap pathPoint ditunjukkan dalam pathDescriptor yang dipisahkan oleh karakter | (pipa).

Contoh berikut menentukan jalur biru dengan opasitas default 50% dari Union Square NY ke Times Square, NY.

Jalur dari Union Sq ke Times Sq

Detail parameter path adalah:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Contoh berikut menentukan jalur yang sama, bukan menentukan garis merah solid dengan opasitas 100%:

Jalur dari Union Sq ke Times Sq

Detail khusus parameter path ini adalah:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Contoh berikutnya menentukan bidang poligon di Manhattan, yang meneruskan serangkaian persimpangan sebagai lokasi:

Jalur dari Union Sq ke Times Sq

Detail khusus parameter path ini adalah:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

Perhatikan bahwa kita menetapkan jalur itu sendiri agar tidak terlihat dan bidang poligonal untuk memiliki opasitas 15%.

Polyline yang dienkode

Sebagai ganti serangkaian lokasi, Anda dapat mendeklarasikan jalur sebagai Polyline yang dienkode dengan menggunakan awalan enc: dalam deklarasi lokasi path.

Contoh berikut menguraikan arah Alaska Highway dari Dawson Creek, BC ke Delta Junction, AK dengan polyline yang dienkode:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Alaska Highway

Seperti jalur standar, jalur polyline yang dienkode juga dapat memisahkan area poligonal jika argumen fillcolor diteruskan ke parameter path.

Contoh berikut menggambarkan bidang poligonal untuk Brooklyn, NY:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Polyline yang Dienkode dengan Brooklyn dengan tanda tangan

Tampilan yang Terlihat

Gambar dapat menentukan viewport dengan menentukan lokasi yang terlihat menggunakan parameter visible. Parameter visible memerintahkan layanan Maps Static API untuk membuat peta sehingga lokasi yang ada tetap terlihat. (Parameter ini dapat digabungkan dengan penanda atau jalur yang ada untuk menentukan region yang terlihat.) Menentukan area pandang dengan cara ini meniadakan kebutuhan untuk menetapkan tingkat zoom yang persis.

Contoh berikutnya meminta peta yang berpusat di Boston, MA yang berisi MIT dan Harvard Square di Cambridge, MA:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Peta Cambridge

Pemosisian implisit peta

Biasanya, Anda perlu menentukan parameter URL center dan zoom untuk menentukan lokasi dan tingkat zoom peta yang dihasilkan. Namun, jika Anda menyediakan parameter markers, path, atau visible, Anda dapat mengizinkan Maps Static API menentukan pusat dan tingkat zoom yang benar secara implisit, berdasarkan evaluasi posisi elemen ini.

Jika menyediakan dua elemen atau lebih, Maps Static API akan menentukan pusat dan tingkat zoom yang tepat, yang memberikan margin besar untuk elemen yang ada. Contoh ini menampilkan peta berisi San Francisco, Oakland, dan San Jose, CA:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Peta Jalan

Ukuran gambar lebih besar

Jika Anda memerlukan gambar dengan ukuran lebih besar dari 640 x 640 piksel (atau 1280 x 1280 piksel dengan nilai skala 2), hubungi tim dukungan dan berikan informasi berikut:

  1. Kasus penggunaan Anda dan alasan Anda memerlukan gambar berukuran besar.
  2. Apakah Anda mempertimbangkan untuk menggunakan Google Maps Platform API lainnya (Maps JavaScript API, Maps Embed API, Maps SDK for Android, atau Maps SDK for iOS) dan mengapa API tersebut tidak memenuhi kebutuhan Anda.
  3. Screenshot, tiruan, atau sampel cara menggunakan gambar berukuran besar.
  4. Perkiraan penggunaan bulanan Anda untuk gambar berukuran besar.

Kami akan meninjau permintaan Anda berdasarkan informasi yang Anda berikan dan menentukan apakah kasus penggunaan Anda mematuhi Persyaratan Layanan Google Maps Platform.

Ukuran maksimum yang dapat kami berikan adalah 2048 x 2048 piksel.

Pemecahan masalah dan dukungan

Untuk informasi selengkapnya tentang penggunaan Maps Static API, lihat halaman dukungan.

Maps Static API dapat menampilkan error atau peringatan saat terjadi masalah. Anda harus memeriksa peringatan, khususnya jika Anda melihat ada sesuatu yang hilang dari peta. Sebaiknya periksa juga peringatan sebelum meluncurkan aplikasi baru. Perhatikan bahwa peringatan mungkin tidak langsung terlihat karena muncul di header HTTP. Untuk informasi selengkapnya, lihat panduan untuk error dan peringatan.