Ubin peta jalan adalah ubin gambar berdasarkan data topografi vektor
dengan gaya visual kartografi Google. Hal ini mencakup jalan, bangunan, lokasi menarik, dan batas politik.
Mendapatkan kartu roadmap
Anda dapat mulai membuat permintaan kartu peta jalan 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 standar 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 kartu peta jalan dengan membuat permintaan HTTPS GET, 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 HTTPS GET ini, z adalah tingkat zoom (berkisar dari 0 hingga 22), dan x serta y adalah koordinat ubin dari ubin yang ingin Anda ambil.
Parameter orientation bersifat opsional. Nilainya menentukan jumlah
derajat rotasi berlawanan arah jarum jam dari gambar kartu. orientation
didukung untuk ubin roadmap, dan juga didukung untuk permintaan satelit dan medan dengan citra dasar yang dihapus menggunakan "overlay": true, dan dengan
layerTypes ditetapkan. Nilai orientation yang valid adalah 0 (default), 90, 180, dan
270.
Petak koordinat kartu tidak diputar jika Anda menyertakan nilai orientation. Misalnya, jika Anda menetapkan orientation ke 90, koordinat x masih menentukan posisi ubin dari kiri ke kanan, yang dalam hal ini adalah dari Utara ke Selatan pada peta.
| Orientasi nol derajat | Orientasi 90 derajat |
|---|---|
 |
 |
Contoh permintaan kartu
Pertimbangkan contoh berikut, yang meminta satu ubin yang berisi seluruh dunia. Dalam contoh ini, tingkat zoom adalah 0, dan 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, Penyimpanan dalam Cache, atau Penyimpanan Konten.