Peta jalan

Ringkasan Ubin Peta JalanPeta jalan adalah ubin gambar berdasarkan data topografi vektor dengan gaya kartografi Google. Ini mencakup jalan, bangunan, titik kepentingan, dan batas-batas 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 dengan permintaan kartu Anda.

Contoh kode berikut menunjukkan permintaan token sesi standar untuk 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 petak peta dengan membuat permintaan GET HTTPS, seperti yang ditampilkan di bawah ini contoh.

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 kartu yang ingin Anda ambil.

Parameter orientation bersifat opsional. Nilainya menentukan jumlah derajat rotasi gambar ubin berlawanan arah jarum jam. orientation sama dengan didukung untuk roadmap ubin, dan juga didukung untuk satelit dan permintaan medan dengan citra dasar yang dihapus menggunakan "overlay": true, dan dengan layerTypes disetel. Nilai orientation yang valid adalah 0 (default), 90, 180, dan 270.

Petak koordinat ubin tidak diputar jika Anda menyertakan orientation dengan sejumlah nilai. Misalnya, jika Anda menetapkan orientation ke 90, Koordinat x masih menentukan nilai kiri-ke-kanan posisi ubin, dalam hal ini dari Utara ke Selatan pada peta.

Orientasi nol derajat Orientasi 90 derajat
Orientasi nol derajat Orientasi 90 derajat

Contoh permintaan kartu

Perhatikan 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 mengunduh ke file lokal, dengan statistik berikut.

Seluruh dunia dalam satu ubin

  % 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.