Tile peta jalan adalah ubin gambar yang didasarkan pada data topografi vektor
dengan gaya kartografi Google. Ini mencakup jalan, bangunan, lokasi
menarik, dan perbatasan politik.
Mendapatkan ubin peta jalan
Anda dapat mulai membuat permintaan kartu roadmap setelah mendapatkan token sesi. Karena token sesi berlaku untuk seluruh sesi, Anda tidak perlu menentukan opsi peta dengan permintaan ubin.
Contoh kode berikut menunjukkan permintaan token sesi yang umum untuk kartu peta jalan.
curl -X POST -d '{
"mapType": "roadmap",
"language": "en-US",
"region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
Anda mendapatkan ubin peta jalan dengan membuat permintaan GET HTTPS, seperti yang ditunjukkan pada contoh berikut.
curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &orientation=0_or_90_or_180_or_270"
Dalam permintaan GET HTTPS ini, z adalah tingkat zoom (mulai dari 0 hingga 22), serta x dan y adalah koordinat ubin dari ubin yang ingin Anda ambil.
Parameter orientation bersifat opsional. Nilainya menentukan jumlah
derajat rotasi gambar kartu yang berlawanan arah jarum jam. orientation
didukung untuk ubin roadmap, dan juga didukung untuk permintaan satelit dan
medan dengan gambar dasar yang dihapus menggunakan "overlay": true, dan dengan
layerTypes yang ditetapkan. Nilai orientation yang valid adalah 0 (default), 90, 180, dan
270.
Petak koordinat kartu tidak akan diputar jika Anda menyertakan nilai
orientation. Misalnya, jika Anda menetapkan orientation ke 90, koordinat
x tetap menentukan posisi kiri-ke-kanan
kartu, yang dalam hal ini adalah dari Utara ke Selatan pada peta.
| Orientasi nol derajat | Orientasi 90 derajat |
|---|---|
 |
 |
Contoh permintaan kartu
Perhatikan contoh berikut, yang meminta satu kartu yang berisi seluruh dunia. Dalam contoh ini, tingkat zoom adalah 0, serta koordinat x dan y adalah 0, 0.
curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png
Tidak ada pesan respons dari server dalam contoh ini. Sebagai gantinya, kartu akan didownload ke file lokal, dengan statistik berikut.
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 8335 100 8335 0 0 51471 0 --:--:-- --:--:-- --:--:-- 54835
Untuk informasi tentang header pesan respons, lihat Pra-Pengambilan, Menyimpan ke Cache, atau Penyimpanan Konten.