Menggunakan token sesi dengan Map Tiles API

Token sesi adalah sepotong data ( UUID) yang digunakan dalam panggilan REST untuk mengidentifikasi sesi— serangkaian pertukaran pesan yang terkait. Anda harus menyertakan token sesi di semua permintaan untuk Ubin 2D dan gambar Street View. Anda menyertakannya sebagai nilai parameter session yang ditambahkan ke semua permintaan URL.

Di Map Tiles API, token sesi mewakili kumpulan opsi tampilan. Artinya, Anda tidak perlu meneruskan serangkaian 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 waktu masalah, tetapi hal ini mungkin berubah. Anda selalu dapat memeriksa waktu kedaluwarsa token sesi dengan melihat kolom expiry dalam pesan respons.

Permintaan token sesi

Untuk meminta token sesi, kirim permintaan POST HTTPS ke createSession endpoint, 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 berikut:

roadmap
Petak peta yang diwarnai oleh Google Maps standar.
satellite
Citra satelit.
terrain
Citra medan. Saat memilih terrain sebagai jenis peta, Anda juga harus menyertakan jenis lapisan layerRoadmap (dijelaskan di bagian Bidang opsional).
streetview
Panorama Street View. Untuk informasi selengkapnya, lihat Ubin Street View.
language

Channel Tag bahasa IETF yang menentukan bahasa yang digunakan untuk menampilkan informasi pada ubin. Sebagai contoh, en-US menentukan bahasa Inggris seperti yang digunakan di Amerika Serikat.

region

J Repositori Data Lokal Umum ID wilayah (dua huruf besar) yang mewakili lokasi fisik dari pengguna. Misalnya, US.

Kolom opsional

imageFormat
Menentukan format file yang akan ditampilkan. Nilai yang valid adalah jpeg atau png. File JPEG tidak mendukung transparansi, oleh karena itu tidak direkomendasikan untuk petak overlay. Jika Anda tidak menentukan imageFormat, format terbaik untuk kartu akan dipilih secara otomatis.
scale

Menaikkan skala ukuran elemen peta (seperti label jalan), sambil mempertahankan ukuran ubin dan area cakupan ubin default. Meningkatkan skala juga akan mengurangi jumlah label di peta, sehingga mengurangi kesemrawutan. Hal berikut nilainya adalah nilai scale yang valid:

  • scaleFactor1x: Default.
  • scaleFactor2x: Menggandakan ukuran label dan menghapus label fitur minor.
  • scaleFactor4x: Meningkatkan ukuran label empat kali lipat dan menghapus label fitur minor.

Contoh berikut menunjukkan efek penskalaan elemen peta.

Faktor Skala 1x Faktor Skala 2x
Peta yang menampilkan faktor skala 1x Peta yang menampilkan faktor skala 2x
highDpi
Menentukan apakah akan menampilkan kartu beresolusi tinggi. Jika faktor skalanya adalah meningkat, highDpi digunakan untuk memperbesar ukuran kartu. Biasanya, meningkatkan faktor skala akan memperbesar ubin yang dihasilkan menjadi gambar yang sama, yang akan menurunkan kualitas. Dengan highDpi, ukuran yang dihasilkan juga meningkat, menjaga kualitas. DPI adalah singkatan dari Dots per Inci, dan DPI Tinggi berarti kartu merender menggunakan lebih banyak titik per inci daripada biasanya. Jika true, maka jumlah piksel di setiap dimensi x dan y dikalikan dengan skala (yaitu , 2x atau 4x). Area cakupan kartu tetap tidak berubah. Parameter ini hanya berfungsi dengan nilai scale 2x atau 4x. Ini tidak berdampak pada 1x ubin skala.
Faktor Skala 1x Faktor Skala 2x DPI Tinggi
Peta ditampilkan dengan resolusi biasa Peta ditampilkan dengan resolusi 2x DPI Tinggi
layerTypes

Array nilai yang menetapkan jenis lapisan yang ditambahkan ke peta. Berlaku nilainya adalah:

layerRoadmap
Wajib diisi jika Anda menentukan terrain sebagai jenis peta. Bisa juga secara opsional ditempatkan pada jenis peta satellite. Tidak memengaruhi petak peta jalan.
layerStreetview
Menampilkan jalan dan lokasi yang mendukung Street View menggunakan garis luar biru di peta.
layerTraffic
Menampilkan kondisi lalu lintas saat ini.
styles

Kumpulan 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 petanya adalah roadmap. Untuk mengetahui sintaksis gaya lengkapnya, lihat Referensi Gaya.

overlay

Nilai boolean yang menentukan apakah layerTypes harus ditampilkan sebagai overlay terpisah, atau dikombinasikan dengan citra dasar. Kapan true, peta dasar tidak ditampilkan. Jika Anda belum menentukan layerTypes, nilai ini akan diabaikan.

Misalnya, meminta jenis peta satellite dengan lapisan layerRoadmap, dan overlay disetel ke false menghasilkan ubin yang setara dengan jenis peta hybrid digunakan dalam Maps JavaScript API (gambar kiri). Jenis peta dan lapisan yang sama dengan overlay yang disetel ke true akan menghasilkan ubin transparan dengan overlay peta, yang gayanya ditata dengan sesuai untuk di-overlay di atas citra satelit (gambar kanan).

overlay: salah overlay: benar
Overlay ditetapkan ke false Overlay disetel ke true

JSON berikut adalah contoh isi permintaan umum yang berisi kedua 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 memberikan overlay yang cocok untuk digabungkan dengan satelit gambar. Contoh tersebut berisi overlay roadmap dan Street View. Peta yang dihasilkan akan dirender dengan nama dan data dalam bahasa Inggris, seperti yang digunakan di Amerika Serikat.

apiOptions: Array nilai yang menentukan opsi tambahan untuk diterapkan. Opsi yang didukung adalah:

  • MCYJ5E517XR2JC - Ikut serta dalam peta baru gaya. 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.
expiry
String yang berisi waktu (dalam detik sejak epoch) saat token tidak berlaku lagi. Token sesi valid selama dua minggu sejak pembuatannya waktu, tetapi kebijakan ini dapat berubah tanpa pemberitahuan.
tileWidth
Lebar kartu yang diukur dalam piksel.
tileHeight
Tinggi kartu yang diukur dalam piksel.
imageFormat
Format gambar, yang dapat berupa png atau jpeg.