ชิ้นส่วนแผนที่เป็นเพียงการแบ่งโลกออกเป็นตารางกริดที่มีการจัดทำดัชนี เครื่องมือนี้ช่วยให้คุณเข้าถึงและใช้ข้อมูลแผนที่ได้อย่างมีประสิทธิภาพและแบบไดนามิกในหลายระดับแผนที่ Map Tiles API ให้คุณเข้าถึงชุดข้อมูลทางภูมิศาสตร์ตามธีมหลายรายการ ซึ่งรวมถึงชุดข้อมูลที่ Google ดูแลจัดการ
ชิ้นส่วนภาพแผนกลยุทธ์ที่อิงจากข้อมูลภูมิประเทศของเวกเตอร์ที่มีการจัดรูปแบบแผนที่ของ Google
โหมดถ่ายภาพ Ortho ที่ถ่ายโดยกล้องดาวเทียมและกล้องทางอากาศ ซึ่งจะแสดงภาพจากด้านบนลงล่าง (จุดที่ต่ำ) ของโลก
แผนที่เส้นโครงร่างบนเนินเขา
ชิ้นส่วนแผนที่ 2 มิติทั้งหมดจะมีการอ้างอิงทางภูมิศาสตร์และอยู่ในแนวเดียวกัน ระบบจะเลือกวิดีโอตามขอบเขตทางภูมิศาสตร์ของวิวพอร์ตและระดับการซูม ระดับการซูมมีตั้งแต่ 0 (เพื่อดูโลกทั้งใบ) ถึง 22 (เพื่อดูถนนและช่วงตึก)
ธีมแผนที่
คุณสามารถรับชิ้นส่วนแผนที่สำหรับธีมแผนที่ต่อไปนี้
ธีมแผนที่ | คำอธิบาย |
---|---|
แผนกลยุทธ์ | ถนน อาคาร จุดที่น่าสนใจ และขอบเขตทางการเมือง |
ดาวเทียม | ภาพภาพถ่ายจากอวกาศ |
ภูมิประเทศ | แผนที่รูปทรงแสดงลักษณะทางธรรมชาติ เช่น พืชพรรณ |
หากต้องการขอชิ้นส่วนแผนที่จาก Map Tiles API คุณต้องขอโทเค็นเซสชันก่อน โทเค็นเซสชันจะติดตามสถานะปัจจุบันของแผนที่และวิวพอร์ต เมื่อตั้งค่าโทเค็นของเซสชัน คุณต้องกำหนดค่า mapType
ให้ตรงกับธีมแผนที่ที่ต้องการ
จากนั้น คุณต้องรวมโทเค็นของเซสชันในคำขอแต่ละรายการที่ส่งไปยัง Map Tiles API
คำขอข้อมูลวิวพอร์ต
วิวพอร์ตจะกำหนดขนาดของกล่องที่เฟรมฉากโลก คำขอข้อมูลวิวพอร์ตจะแสดงรายละเอียดเกี่ยวกับชิ้นส่วนแผนที่ที่ประกอบกันเป็นวิวพอร์ตปัจจุบันของคุณ เหตุผลที่คุณขอข้อมูลวิวพอร์ตก็เพื่อให้แน่ใจว่าคุณหลีกเลี่ยงการขอภาพในระดับการซูมที่ไม่มีอยู่
ตัวอย่างเช่น เมืองส่วนใหญ่มีภาพที่ซูมระดับ 22 แต่ไม่ใช่มหาสมุทร เนื่องจากภาพที่แสดงเป็นสี่เหลี่ยมจตุรัสสีน้ำเงินไร้ลักษณะเด่น
คำขอวิวพอร์ตคือคำขอ HTTPS GET ในรูปแบบต่อไปนี้
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"
คำขอจะมีฟิลด์ต่อไปนี้
zoom
- ระดับการซูมของวิวพอร์ต
north
,south
,east
,west
- จุดเหนือ ใต้ ตะวันออก และตะวันตกที่ไกลที่สุดในวิวพอร์ต แสดงเป็นองศา ทิศเหนือและทิศใต้ต้องอยู่ในช่วง (-90,90) ส่วนทิศตะวันออกและทิศตะวันตกต้องอยู่ในช่วง (-180, 180) เพื่อแสดงขอบเขตที่ข้ามแอนติเมริเดียน ทิศตะวันตกอาจมีค่าเป็นบวก (เช่น 170) และทิศตะวันออกอาจเป็นค่าลบ (เช่น -170) ต้องระบุพารามิเตอร์ทั้งหมด
การตอบกลับข้อมูลวิวพอร์ต
การตอบสนองของวิวพอร์ตจะบอกคุณว่าพื้นที่ใดมีภาพ และระดับการซูมใด การตอบกลับของข้อมูลวิวพอร์ตจะมีรูปแบบต่อไปนี้
{
"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
}, ...
]
}
เนื้อหาการตอบกลับจะมีช่องต่อไปนี้
copyright
- มีสตริงการระบุแหล่งที่มาที่คุณต้องแสดงบนแผนที่เมื่อแสดงแผนกลยุทธ์และชิ้นส่วนแผนที่ดาวเทียม ดูข้อมูลเพิ่มเติมได้ที่นโยบาย Map Tiles API
maxZoomRect
- มีอาร์เรย์ของสี่เหลี่ยมขอบเขตที่ซ้อนทับกับวิวพอร์ตปัจจุบัน และมีระดับการซูมสูงสุดที่ใช้ได้ในสี่เหลี่ยมแต่ละอัน
ฟังก์ชันพิกัดของไทล์
เครื่องมือ (ฟังก์ชันง่ายๆ) พร้อมใช้งานในภาษาโปรแกรมส่วนใหญ่เพื่อแปลงจากคู่ละติจูด/ลองจิจูดเป็นพิกัดแผนที่ย่อยในระดับการซูมที่เฉพาะเจาะจง
ลองดูตัวอย่างโค้ด JavaScript ต่อไปนี้ที่แปลงจาก latLng
เป็นจุดหนึ่งก่อน แล้วค่อยจากพิกัดของจุดหนึ่งไปไทล์
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
};
}