Peta jalan

Developer Wilayah Ekonomi Eropa (EEA)

Ringkasan Kartu Peta JalanUbin peta jalan adalah ubin gambar berdasarkan data topografi vektor dengan gaya kartografi Google. Hal ini mencakup jalan, bangunan, lokasi menarik, dan batas politik.

Mendapatkan kartu peta jalan

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

Contoh kode berikut menunjukkan permintaan token sesi 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 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 GET HTTPS ini, z adalah tingkat zoom (berkisar dari 0 hingga 22), dan x serta y adalah koordinat petak dari petak yang ingin Anda ambil.

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

Petak koordinat ubin tidak diputar jika Anda menyertakan nilai orientation. Misalnya, jika Anda menyetel orientation ke 90, koordinat x masih menentukan posisi ubin dari kiri ke kanan, yang dalam hal ini adalah dari Utara ke Selatan di peta.

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

Contoh permintaan kartu

Pertimbangkan contoh berikut, yang meminta satu petak 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.

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 Melakukan Pra-Pengambilan, Menyimpan dalam Cache, atau Menyimpan Konten.