Petak roadmap adalah ubin gambar berdasarkan data topografi vektor dengan gaya kartografi Google. Ini mencakup jalan, bangunan, lokasi menarik, dan perbatasan politik.
Mendapatkan petak peta jalan
Anda bisa mulai membuat permintaan petak peta jalan setelah mendapatkan token sesi. Karena token sesi berlaku untuk seluruh sesi, Anda tidak perlu menentukan opsi peta untuk permintaan kartu.
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 GET HTTPS, seperti ditunjukkan dalam 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), dan x
serta y
adalah koordinat ubin ubin yang ingin Anda ambil.
Parameter orientation
bersifat opsional. Nilainya menentukan jumlah
derajat rotasi gambar kartu 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 disetel. Nilai orientation
yang valid adalah 0 (default), 90, 180, dan
270.
Petak koordinat kartu tidak dirotasi 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
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 mengetahui informasi tentang header pesan respons, lihat Pengambilan Awal, Penyimpanan dalam Cache, atau Penyimpanan Konten.