ภาพรวมการ์ด 2 มิติ

ตัวอย่างแผนกลยุทธ์ไทล์แผนที่เป็นเพียงการแบ่งโลกออกเป็นตารางกริดที่จัดทําดัชนี ซึ่งช่วยให้คุณเข้าถึงและใช้ข้อมูลแผนที่ได้อย่างมีประสิทธิภาพและแบบไดนามิกในหลายมาตราส่วนการเขียนแผนที่ Map Tiles API ช่วยให้คุณเข้าถึงชุดข้อมูลเชิงพื้นที่ตามหัวข้อหลายชุด ซึ่งรวมถึงชุดข้อมูลต่อไปนี้ที่ Google ดูแลจัดการ

  • ไทล์รูปภาพแผนที่แสดงเส้นทางที่อิงตามข้อมูลภาพโมเดลภูมิประเทศเวกเตอร์ที่มีการจัดสไตล์แผนที่ของ Google

  • ภาพถ่ายออร์โธโฟโตกราฟีที่ถ่ายโดยทั้งกล้องดาวเทียมและกล้องบนอากาศซึ่งให้ภาพมุมมองจากด้านบน (จุดที่ต่ำที่สุด) ของโลก

  • แผนที่เส้นระดับความสูงของเนินเขา

แผนที่ 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
  };
}