ทํางานกับตัวแสดงผลการ์ด 3 มิติของคุณเอง

หากคุณไม่สามารถรวมผลิตภัณฑ์การแสดงภาพของบุคคลที่สามในโซลูชันของคุณ คุณอาจต้องสร้างตัวแสดงผลการ์ด 3 มิติของคุณเอง วิธีนี้ทำให้คุณต้องพิจารณาปัจจัยสำคัญต่อไปนี้

• URL เนื้อหา
• คําขอและการตอบกลับ
• การระบุแหล่งที่มาของข้อมูล Display

URL เนื้อหา

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

คำขอและการตอบกลับ

ต่อไปนี้เป็นตัวอย่างคำขอและคำตอบของการ์ด 3 มิติแบบภาพเสมือนจริง คุณจะตรวจสอบโดยใช้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Chrome

ตัวอย่างคำขอชุดไทล์รูท

https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY

ตัวอย่าง URI การตอบกลับของชุดไทล์:

 /v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg

ตัวอย่าง URL คำขอไทล์ที่ตัวแสดงผลใช้

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYuYnVs.json?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

https://tile.googleapis.com/v1/3dtiles/datasets/CgA/files/UlRPVEYubm9k.glb?session=CIqhrPOFvdHSYg&key=YOUR_API_KEY

คุณควรแนบพารามิเตอร์ที่ปรากฏใน URI ของชุดชิ้นส่วนพร้อมกับคีย์ API ของคุณเมื่อสร้างคำขอไทล์รายการต่อๆ ไป 3D Tiles API มีพารามิเตอร์ 2 ตัวดังต่อไปนี้

session

ตัวระบุในตัวสำหรับเซสชันการโหลดแบบ 3 มิติ ซึ่ง API นี้สร้างขึ้นโดยอัตโนมัติ ซึ่งต้องแนบโดยตัวแสดงผลเมื่อสร้างคำขอไทล์ต่อมา

key

คีย์ API ที่คุณใช้เข้าถึงบริการการ์ด 3 มิติ คุณต้องแนบมากับ คำขอการ์ดที่ตามมาทั้งหมด

การระบุแหล่งที่มาในเครือข่ายดิสเพลย์

การระบุแหล่งที่มาหมายถึงการรับทราบแหล่งที่มาของชิ้นส่วนแผนที่ และเป็นข้อกำหนดสำหรับการใช้ API นี้ ซึ่งรวมถึงการระบุแหล่งที่มาของแบรนด์ Google (โลโก้) ตลอดจนการระบุแหล่งที่มาของข้อมูล คุณจะดูโลโก้ Google ได้ในหน้านโยบาย Map Tiles API ระบบจะแสดงข้อมูลการระบุ แหล่งที่มาของข้อมูลในทุกๆ คำตอบของไทล์ ค้นหาได้ในเนื้อหาการตอบกลับใน JSON ใต้ asset.copyright

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

คุณต้องรวบรวม จัดเรียง และแสดงข้อมูลนี้ในบรรทัดข้อความ ซึ่งมักจะอยู่ที่ด้านล่างของการแสดงผล ซึ่งมีขั้นตอนดังต่อไปนี้

1. ดึงข้อมูลลิขสิทธิ์ทั้งหมดจากชิ้นส่วนทั้งหมดในการแสดงผล

2. คั่นแหล่งที่มาของลิขสิทธิ์หลายแหล่งด้วยเครื่องหมายเซมิโคลอน

3. จัดเรียงข้อมูลตามจำนวนการเกิดเหตุการณ์

4. แสดงแหล่งที่มาของลิขสิทธิ์บนหน้าจอ โดยเรียงลำดับจากเหตุการณ์ส่วนใหญ่ไปจนถึงน้อยที่สุด คล้ายกับที่ Google Earth ทำ