Token sesi adalah sepotong data (UUID) yang digunakan dalam panggilan REST untuk mengidentifikasi sesi—serangkaian pertukaran pesan terkait. Anda harus menyertakan token sesi dalam semua
permintaan untuk Ubin 2D dan gambar Street View.
Anda menyertakannya sebagai nilai parameter session
yang ditambahkan ke semua URL permintaan.
Dalam Map Tiles API, token sesi mewakili sekumpulan
opsi tampilan yang ditentukan. Ini berarti Anda tidak perlu meneruskan kumpulan opsi tampilan dengan
setiap permintaan kartu. Anda dapat menggunakan token sesi yang sama di beberapa klien.
Token sesi saat ini valid selama dua minggu sejak
waktunya dikeluarkan, tetapi hal ini dapat berubah. Anda dapat memeriksa waktu habis masa berlaku token sesi kapan saja dengan melihat kolom expiry
di pesan respons.
Permintaan token sesi
Untuk meminta token sesi, kirim permintaan POST HTTPS ke endpoint
createSession
, seperti ditunjukkan dalam contoh berikut. Anda harus mengirim permintaan dengan header Content-Type: application/json
.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Kolom wajib diisi
mapType
Tipe peta dasar. Nilai ini dapat berupa salah satu dari hal berikut:
roadmap
- Ubin peta yang dilukis dengan Google Maps standar.
satellite
- Citra satelit.
terrain
- Gambar medan. Saat memilih
terrain
sebagai jenis peta, Anda juga harus menyertakan jenis lapisanlayerRoadmap
(dijelaskan di bagian Kolom opsional). streetview
- Panorama Street View. Untuk informasi selengkapnya, lihat Kartu Street View.
language
Tag bahasa IETF yang menentukan bahasa yang digunakan untuk menampilkan informasi di kartu. Misalnya,
en-US
menentukan bahasa Inggris seperti yang digunakan di Amerika Serikat.region
ID wilayah Common Locale Data Repository (dua huruf besar) yang mewakili lokasi fisik pengguna. Misalnya,
US
.
Kolom opsional
imageFormat
- Menentukan format file yang akan ditampilkan. Nilai yang valid adalah
jpeg
ataupng
. File JPEG tidak mendukung transparansi, sehingga tidak direkomendasikan untuk peta overlay. Jika Anda tidak menentukanimageFormat
, format terbaik untuk kartu akan dipilih secara otomatis. scale
Meningkatkan ukuran elemen peta (seperti label jalan), dengan tetap mempertahankan ukuran ubin dan area cakupan ubin default. Meningkatkan skala juga akan mengurangi jumlah label di peta, sehingga mengurangi kekacauan. Nilai berikut adalah nilai
scale
yang valid:scaleFactor1x
: Default.scaleFactor2x
: Menggandakan ukuran label dan menghapus label fitur minor.scaleFactor4x
: Ukuran label empat kali lipat dan menghapus label fitur minor.
Contoh berikut menunjukkan efek penskalaan elemen peta.
Faktor Skala 1x | Faktor Skala 2x |
---|---|
highDpi
- Menentukan apakah akan menampilkan kartu resolusi tinggi. Jika faktor skala ditingkatkan,
highDpi
akan digunakan untuk meningkatkan ukuran kartu. Biasanya, meningkatkan faktor skala akan memperbesar kartu yang dihasilkan menjadi gambar dengan ukuran yang sama, sehingga akan menurunkan kualitas. DenganhighDpi
, ukuran yang dihasilkan juga akan ditingkatkan sehingga mempertahankan kualitas. DPI adalah singkatan dari Titik per Inci, dan DPI Tinggi berarti kartu merender menggunakan lebih banyak titik per inci dari biasanya. Jikatrue
, maka jumlah piksel di setiap dimensi x dan y dikalikan dengan faktor skala (yaitu , 2x atau 4x). Area cakupan kartu tetap tidak berubah. Parameter ini hanya berfungsi dengan nilaiscale
2x atau 4x. Ini tidak berpengaruh pada peta skala 1x.
Faktor Skala 1x | Faktor Skala 2x DPI Tinggi |
---|---|
layerTypes
Array nilai yang menentukan jenis lapisan yang ditambahkan ke peta. Nilai yang valid adalah:
layerRoadmap
- Wajib diisi jika Anda menentukan
terrain
sebagai jenis peta. Secara opsional, juga dapat ditimpa pada jenis petasatellite
. Tidak memengaruhi ubin peta jalan. layerStreetview
- Menampilkan jalan dan lokasi yang mendukung Street View menggunakan garis luar berwarna biru pada peta.
layerTraffic
- Menampilkan kondisi lalu lintas saat ini.
styles
Array objek gaya JSON yang menentukan tampilan dan tingkat detail fitur peta seperti jalan, taman, dan area padat bangunan. Gaya visual digunakan untuk menyesuaikan peta dasar Google standar. Parameter
styles
hanya valid jika jenis peta adalahroadmap
. Untuk mengetahui sintaksis gaya lengkap, lihat Referensi Gaya.overlay
Nilai boolean yang menentukan apakah
layerTypes
harus dirender sebagai overlay terpisah, atau dikombinasikan dengan gambar dasar. Jikatrue
, peta dasar tidak ditampilkan. Jika Anda belum menentukanlayerTypes
, nilai ini akan diabaikan.
Misalnya, meminta jenis peta satellite
dengan lapisan layerRoadmap
, dan
overlay
yang ditetapkan ke false
akan menghasilkan ubin yang setara dengan jenis peta hybrid
yang digunakan di Maps JavaScript API (gambar kiri). Jenis peta dan lapisan yang sama dengan overlay
yang ditetapkan ke true
akan menghasilkan ubin transparan dengan overlay peta, yang telah diberi gaya dengan sesuai untuk ditempatkan di atas citra satelit (gambar kanan).
overlay : salah |
overlay : benar |
---|---|
JSON berikut adalah contoh isi permintaan standar yang berisi kolom wajib diisi dan opsional.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
Contoh ini menyediakan overlay yang cocok untuk digabungkan dengan citra satelit. Contoh tersebut berisi sebuah peta jalan dan overlay tampilan jalan. Peta yang dihasilkan dirender dengan nama dan data dalam bahasa Inggris, seperti yang diucapkan di Amerika Serikat.
apiOptions
: Array nilai yang menentukan opsi tambahan untuk diterapkan.
Opsi yang didukung adalah:
MCYJ5E517XR2JC
- Ikut serta dalam gaya peta baru. Selama periode keikutsertaan, permintaan Anda akan mendapatkan gaya yang ada kecuali jika nilai ini ditentukan.
Respons token sesi
JSON berikut adalah contoh isi respons.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
Daftar berikut berisi definisi kolom dalam isi respons.
session
- Nilai token sesi yang harus Anda sertakan dalam semua permintaan Map Tiles API Anda.
expiry
- String yang berisi waktu (dalam detik sejak epoch) saat token berakhir. Token sesi berlaku selama dua minggu sejak waktu pembuatannya, tetapi kebijakan ini dapat berubah tanpa pemberitahuan.
tileWidth
- Lebar ubin yang diukur dalam piksel.
tileHeight
- Tinggi ubin yang diukur dalam piksel.
imageFormat
- Format gambar, bisa
png
ataujpeg
.