Ubin Peta hanyalah pembagian dunia ke dalam petak yang diindeks. API ini memungkinkan Anda mengakses dan memanfaatkan data peta secara efisien dan dinamis pada berbagai skala kartografi. Map Tiles API memberi Anda akses ke beberapa geoset data tematik, termasuk yang diseleksi Google:
Petak gambar roadmap berdasarkan data topografi vektor dengan gaya kartografi Google.
Ortofotografi yang diambil oleh kamera satelit dan udara yang menampilkan citra dari atas ke bawah (titik nadir) bumi.
Peta kontur Hillshade.
Ubin Peta 2D semuanya memiliki georeferensi dan sejajar satu sama lain. Petak tersebut dipilih berdasarkan cakupan geografis area pandang dan tingkat zoom. Tingkat zoom berkisar dari nol (untuk melihat dunia secara keseluruhan) hingga 22 (untuk melihat jalan dan blok).
Tema peta
Anda bisa mendapatkan petak peta untuk tema peta berikut.
| Tema peta | Deskripsi |
|---|---|
| Roadmap | Jalan, bangunan, lokasi menarik, dan perbatasan politik |
| Satelit | Gambar fotografi yang diambil dari luar angkasa |
| Medan | Peta kontur yang menunjukkan fitur alam seperti vegetasi |
Untuk meminta petak peta dari Map Tiles API, Anda harus meminta
token sesi terlebih dahulu. Token sesi melacak status saat ini dari peta dan area pandang Anda. Saat menyiapkan token sesi, Anda harus menetapkan nilai mapType agar cocok dengan tema peta yang diinginkan.
Kemudian, Anda harus menyertakan token sesi di setiap permintaan ke
Map Tiles API.
Permintaan informasi area pandang
Area pandang menentukan ukuran kotak yang membingkai pemandangan dunia. Permintaan informasi area pandang menampilkan detail tentang ubin peta yang membentuk area pandang Anda saat ini. Alasan Anda meminta informasi area pandang adalah untuk memastikan Anda menghindari meminta gambar pada tingkat zoom yang tidak ada.
Misalnya, sebagian besar kota memiliki citra pada tingkat zoom 22, tetapi tidak dengan lautan karena pada akhirnya akan menampilkan kotak biru tanpa fitur.
Permintaan area pandang adalah permintaan GET HTTPS dalam bentuk berikut.
curl "https://tile.googleapis.com/tile/v1/viewport?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &zoom=zoom &north=north &south=south &east=east &west=west"
Permintaan berisi kolom berikut:
zoom- Tingkat zoom area tampilan.
north,south,east,west- Titik utara, selatan, timur, dan barat terjauh di area pandang, yang dinyatakan dalam derajat. Utara dan selatan harus dalam rentang (-90,90), timur dan barat harus dalam rentang (-180, 180). Untuk mengekspresikan batas yang melintasi antimeridian, barat bisa bernilai positif (misalnya, 170) dan timur bisa bernilai negatif (misalnya, -170). Semua parameter diperlukan.
Respons informasi area pandang
Respons area pandang memberi tahu Anda area mana yang memiliki gambar, dan di tingkat zoom-nya. Respons informasi area pandang memiliki bentuk berikut.
{
"copyright": "Map data ©2023",
"maxZoomRects": [
{
"maxZoom": 19,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 9,
"north": 90,
"south": -90,
"east": 180,
"west": -180
},
{
"maxZoom": 14,
"north": 84.375,
"south": -84.375,
"east": 180,
"west": -180
}, ...
]
}
Isi respons berisi kolom berikut.
copyright- Berisi string atribusi yang harus Anda tampilkan di peta saat menampilkan peta jalan dan ubin satelit. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Map Tiles API.
maxZoomRect- Berisi array persegi panjang pembatas yang tumpang tindih dengan area pandang saat ini. Juga berisi tingkat zoom maksimum yang tersedia dalam setiap persegi panjang.
Fungsi koordinat petak peta
Alat (fungsi sederhana) tersedia di sebagian besar bahasa pemrograman untuk melakukan konversi dari pasangan garis lintang/bujur menjadi koordinat ubin pada tingkat zoom tertentu.
Perhatikan contoh kode JavaScript berikut yang pertama-tama melakukan konversi dari
latLng menjadi titik, lalu dari satu titik menjadi koordinat ubin.
var TILE_SIZE = 256;
function fromLatLngToPoint(latLng) {
var mercator = -Math.log(Math.tan((0.25 + latLng.lat() / 360) * Math.PI));
return {
x: TILE_SIZE * (latLng.lng() / 360 + 0.5),
y: TILE_SIZE / 2 * (1 + mercator / Math.PI)
};
}
function fromLatLngToTileCoord(latLng, zoom) {
var point = fromLatLngToPoint(latLng);
var scale = Math.pow(2, zoom);
return {
x: Math.floor(point.x * scale / TILE_SIZE),
y: Math.floor(point.y * scale / TILE_SIZE),
z: zoom
};
}