ก่อนเริ่มต้น

เอกสารนี้อธิบายข้อกําหนดเบื้องต้น แนวทางปฏิบัติแนะนํา และข้อผิดพลาดที่พบบ่อยเมื่อทํางานกับชุดข้อมูล

ข้อกำหนดเบื้องต้น

เมื่อสร้างชุดข้อมูลให้ทำดังนี้

  • ชื่อที่แสดงต้องไม่ซ้ำกันภายในโปรเจ็กต์ Google Cloud
  • ชื่อที่แสดงต้องมีขนาดไม่เกิน 64 ไบต์ (เนื่องจากอักขระเหล่านี้แสดงด้วย UTF-8 ดังนั้นในบางภาษาจึงแสดงอักขระแต่ละตัวเป็นไบต์ได้หลายไบต์)
  • คำอธิบายต้องมีความยาวน้อยกว่า 1,000 ไบต์

เมื่ออัปโหลดข้อมูล ให้ทำดังนี้

  • ประเภทไฟล์ที่รองรับ ได้แก่ CSV, GeoJSON และ KML
  • ขนาดไฟล์สูงสุดที่รองรับคือ 500 MB
  • ชื่อคอลัมน์แอตทริบิวต์ต้องไม่ขึ้นต้นด้วยสตริง "?_"
  • ไม่สนับสนุนรูปทรงเรขาคณิตสามมิติ ซึ่งรวมถึงส่วนต่อท้าย "Z" ในรูปแบบ WKT และพิกัดระดับความสูงในรูปแบบ GeoJSON

แนวทางปฏิบัติแนะนำสำหรับการจัดเตรียมข้อมูล

หากข้อมูลต้นทางมีความซับซ้อนหรือมีขนาดใหญ่ เช่น จุดที่หนาแน่น เส้นสตริงที่ยาว หรือรูปหลายเหลี่ยม (โดยปกติแล้วไฟล์ต้นทางที่มีขนาดใหญ่กว่า 50 MB จะจัดอยู่ในหมวดหมู่นี้) ให้พิจารณาลดความซับซ้อนของข้อมูลก่อนอัปโหลดเพื่อให้ได้ประสิทธิภาพที่ดีที่สุดในแผนที่ภาพ

แนวทางปฏิบัติแนะนำบางส่วนสำหรับการเตรียมข้อมูลมีดังนี้

  1. ลดพร็อพเพอร์ตี้ฟีเจอร์ เก็บเฉพาะพร็อพเพอร์ตี้องค์ประกอบที่จําเป็นสําหรับการจัดรูปแบบแผนที่ เช่น "รหัส" และ "หมวดหมู่" คุณสามารถรวมพร็อพเพอร์ตี้เพิ่มเติมเข้ากับฟีเจอร์ในแอปพลิเคชันไคลเอ็นต์ได้โดยใช้สไตล์ที่ขับเคลื่อนโดยข้อมูลในคีย์ตัวระบุที่ไม่ซ้ำกัน ตัวอย่างเช่น ดูข้อมูลแบบเรียลไทม์ด้วยการจัดรูปแบบตามข้อมูล
  2. ใช้ประเภทข้อมูลแบบง่ายสำหรับออบเจ็กต์พร็อพเพอร์ตี้เมื่อเป็นไปได้ เช่น จำนวนเต็ม เพื่อลดขนาดไทล์และปรับปรุงประสิทธิภาพแผนที่
  3. ลดความซับซ้อนของรูปทรงเรขาคณิตที่ซับซ้อนก่อนอัปโหลดไฟล์ โดยใช้เครื่องมือภูมิสารสนเทศที่ต้องการ เช่น ยูทิลิตี Mapshaper.org แบบโอเพนซอร์ส หรือใน BigQuery ที่ใช้ ST_Simplify ในเรขาคณิตของรูปหลายเหลี่ยมที่ซับซ้อน
  4. คลัสเตอร์จุดที่หนาแน่นมากก่อนอัปโหลดไฟล์ ซึ่งทำได้ในเครื่องมือเชิงพื้นที่ที่คุณเลือก เช่น ฟังก์ชันคลัสเตอร์ turf.js แบบโอเพนซอร์ส หรือใน BigQuery โดยใช้ ST_CLUSTERDBSCAN กับเรขาคณิตจุดที่หนาแน่น

ดูคําแนะนําเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติแนะนําของชุดข้อมูลในหัวข้อแสดงข้อมูลเป็นภาพด้วยชุดข้อมูลและ BigQuery

ข้อกำหนดของ GeoJSON

Maps Datasets API รองรับข้อกำหนด GeoJSON ปัจจุบัน Maps Datasets API ยังรองรับไฟล์ GeoJSON ที่มีออบเจ็กต์ประเภทต่อไปนี้ด้วย

  • ออบเจ็กต์เรขาคณิต ออบเจ็กต์เรขาคณิตคือรูปทรงเชิงพื้นที่ที่อธิบายว่าเป็นยูเนียนของจุด เส้น และรูปหลายเหลี่ยมที่มีรูหรือไม่มีก็ได้
  • แสดงออบเจ็กต์ ออบเจ็กต์ฟีเจอร์มีเรขาคณิตบวกกับคู่ชื่อ/ค่าเพิ่มเติม ซึ่งมีความหมายเฉพาะแอปพลิเคชัน
  • คอลเล็กชันฟีเจอร์ คอลเล็กชันฟีเจอร์คือชุดของออบเจ็กต์ฟีเจอร์

Maps Datasets API ไม่รองรับไฟล์ GeoJSON ที่มีข้อมูลในระบบพิกัดอ้างอิง (CRS) อื่นที่ไม่ใช่ WGS84

ดูข้อมูลเพิ่มเติมเกี่ยวกับ GeoJSON ได้ที่การปฏิบัติตามข้อกำหนด RFC 7946

ข้อกำหนด KML

Maps Datasets API มีข้อกำหนดต่อไปนี้

  • URL ทั้งหมดต้องอยู่ในเครื่อง (หรือต้องสัมพัทธ์) กับไฟล์
  • สนับสนุนเรขาคณิตของจุด เส้น และรูปหลายเหลี่ยม
  • แอตทริบิวต์ข้อมูลทั้งหมดจะถือเป็นสตริง
ระบบไม่รองรับฟีเจอร์ KML ต่อไปนี้
  • ไอคอนหรือ <styleUrl> ที่กำหนดไว้นอกไฟล์
  • ลิงก์เครือข่าย เช่น <NetworkLink>
  • การวางซ้อนพื้น เช่น <GroundOverlay>
  • เรขาคณิต 3 มิติหรือแท็กที่เกี่ยวข้องกับระดับความสูง เช่น <altitudeMode>
  • ข้อมูลจำเพาะของกล้อง เช่น <LookAt>
  • รูปแบบที่กำหนดไว้ในไฟล์ KML

ข้อกำหนด CSV

สำหรับไฟล์ CSV ชื่อคอลัมน์ที่รองรับจะแสดงอยู่ด้านล่างตามลําดับความสําคัญ

  • latitude longitude
  • lat long
  • x y
  • wkt (ข้อความที่รู้จักดี)
  • address, city, state, zip
  • address
  • คอลัมน์เดียวที่มีข้อมูลที่อยู่ทั้งหมด เช่น 1600 Amphitheatre Parkway Mountain View, CA 94043

เช่น ไฟล์มีคอลัมน์ชื่อ x, y และ wkt เนื่องจาก x และ y มีลำดับความสำคัญสูงกว่า โดยพิจารณาจากลำดับชื่อคอลัมน์ที่รองรับในรายการด้านบน ระบบจึงใช้ค่าในคอลัมน์ x และ y และระบบจะไม่สนใจคอลัมน์ wkt

นอกจากนี้

  • ชื่อคอลัมน์แต่ละชื่อต้องอยู่ในคอลัมน์เดียว กล่าวคือ คุณไม่สามารถมีคอลัมน์ชื่อ xy ที่มีทั้งข้อมูลพิกัด x และ y พิกัด x และ y ต้องอยู่ในคอลัมน์แยกกัน
  • ชื่อคอลัมน์ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
  • ลําดับของชื่อคอลัมน์ไม่สําคัญ เช่น หากไฟล์ CSV มีคอลัมน์ lat และ long คอลัมน์เหล่านี้จะปรากฏในลำดับใดก็ได้

จัดการข้อผิดพลาดในการอัปโหลดข้อมูล

เมื่ออัปโหลดข้อมูลไปยังชุดข้อมูล คุณอาจพบข้อผิดพลาดที่พบบ่อยตามที่อธิบายไว้ในส่วนนี้

ข้อผิดพลาด GeoJSON

ข้อผิดพลาดที่พบบ่อยของ GeoJSON ได้แก่

  • ไม่มีฟิลด์ type หรือ type ไม่ใช่สตริง ไฟล์ข้อมูล GeoJSON ที่อัปโหลดต้องมีช่องสตริงชื่อ type เป็นส่วนหนึ่งของคำจำกัดความของออบเจ็กต์ฟีเจอร์และออบเจ็กต์เรขาคณิต

ข้อผิดพลาดเกี่ยวกับ KML

ข้อผิดพลาดที่พบบ่อยของ KML ได้แก่

  • ไฟล์ข้อมูลต้องไม่มีองค์ประกอบ KML ที่ระบบไม่รองรับซึ่งระบุไว้ข้างต้น ไม่เช่นนั้นการนําเข้าข้อมูลอาจไม่สําเร็จ

ข้อผิดพลาด CSV

ข้อผิดพลาด CSV ที่พบบ่อย ได้แก่

  • แถวบางแถวไม่มีค่าสำหรับคอลัมน์เรขาคณิต แถวทั้งหมดในไฟล์ CSV ต้องมีค่าที่ไม่ใช่ค่าว่างสำหรับคอลัมน์เรขาคณิต คอลัมน์เรขาคณิตประกอบด้วยข้อมูลต่อไปนี้
    • latitude longitude
    • lat long
    • x y
    • wkt
    • address, city, state, zip
    • address
    • คอลัมน์เดียวที่มีข้อมูลที่อยู่ทั้งหมด เช่น 1600 Amphitheatre Parkway Mountain View, CA 94043
  • หาก x และ y เป็นคอลัมน์เรขาคณิต ให้ตรวจสอบว่าหน่วยเป็นลองจิจูดและละติจูด ชุดข้อมูลสาธารณะบางชุดใช้ระบบพิกัดอื่นในส่วนหัว x และ y หากใช้หน่วยที่ไม่ถูกต้อง ชุดข้อมูลอาจนำเข้าสำเร็จ แต่ข้อมูลที่แสดงผลอาจแสดงจุดชุดข้อมูลในตำแหน่งที่ไม่คาดคิด