สร้างและจัดการชุดข้อมูล

ผลิตภัณฑ์หรือฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงของผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจใช้งานไม่ได้กับเวอร์ชันก่อนเวอร์ชัน GA อื่นๆ ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปจะอยู่ภายใต้ข้อกำหนดเฉพาะของบริการ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายขั้นตอนการเปิดตัว

ชุดข้อมูลช่วยให้คุณอัปโหลดข้อมูลเชิงพื้นที่จากไฟล์ในเครื่องหรือจาก Google Cloud Storage ไปยัง Google Maps Platform ได้ จากนั้นคุณจะเชื่อมโยงชุดข้อมูลกับรูปแบบแผนที่อย่างน้อย 1 รายการใน Cloud Console ได้ หลังจากเชื่อมโยงชุดข้อมูลกับรูปแบบแผนที่แล้ว ให้ใช้ API การจัดรูปแบบที่มาจากข้อมูลเพื่อจัดรูปแบบแอปพลิเคชันแผนที่แบบไดนามิก

นอกจากนี้คุณยังใช้ API ของ REST เพื่ออัปโหลดข้อมูลเชิงพื้นที่ไปยังชุดข้อมูลได้อีกด้วย ดูข้อมูลเพิ่มเติมได้ที่ Maps Datasets API

กำหนดค่าบทบาท

หากต้องการสร้างและจัดการชุดข้อมูลในโปรเจ็กต์ Google Cloud คุณต้องมีบทบาท IAM ของเจ้าของหรือผู้แก้ไขในโปรเจ็กต์

หมายเหตุ: หากสร้างโปรเจ็กต์ คุณจะมีบทบาทเจ้าของในโปรเจ็กต์ หน้า IAM ของ Google Cloud Console จะแสดงเจ้าของและผู้แก้ไขโปรเจ็กต์

หรือจะมอบหมายบทบาท IAM ต่อไปนี้ให้กับบัญชีผู้ใช้หรือบัญชีบริการที่คุณใช้จัดการชุดข้อมูลก็ได้

• บทบาท Maps Platform Datasets Admin จะมอบสิทธิ์การอ่าน/เขียนชุดข้อมูลในโปรเจ็กต์แก่ผู้ใช้หรือบัญชีบริการ บทบาทนี้ให้ผู้ใช้ดำเนินการทั้งหมดในชุดข้อมูลได้
• บทบาท Maps Platform Datasets Viewer จะให้สิทธิ์การอ่านอย่างเดียวแก่ชุดข้อมูลในโปรเจ็กต์ บทบาทนี้ให้คุณดำเนินการแสดงรายการ รับ หรือดาวน์โหลดบนชุดข้อมูลได้

ดูข้อมูลเพิ่มเติมได้ที่มอบบทบาท IAM โดยใช้คอนโซล Google Cloud

แหล่งข้อมูลของชุดข้อมูล

หลังจากที่คุณสร้างชุดข้อมูล ให้อัปโหลดข้อมูลไปยังชุดข้อมูลจาก Google Cloud Storage หรือจากไฟล์ในเครื่อง

หมายเหตุ: คุณอัปโหลดข้อมูลไปยังชุดข้อมูลได้เพียงครั้งเดียวเท่านั้น กล่าวคือ หลังจากที่เรียกใช้คำขออัปโหลดข้อมูลจาก Cloud Storage หรือจากไฟล์ในเครื่องแล้ว คุณจะอัปโหลดข้อมูลไปยังชุดข้อมูลเดียวกันนี้อีกครั้งไม่ได้ หากเกิดข้อผิดพลาดระหว่างการอัปโหลด คุณต้องสร้างชุดข้อมูลใหม่และลองอัปโหลดอีกครั้ง

• เมื่ออัปโหลดข้อมูลจาก Cloud Storage ให้ระบุเส้นทางไฟล์ไปยังทรัพยากรที่มีข้อมูลใน Cloud Storage เส้นทางนี้อยู่ในรูปแบบ gs://GCS_BUCKET/FILE

  ผู้ใช้ที่ส่งคำขอต้องมีบทบาทผู้ดูออบเจ็กต์พื้นที่เก็บข้อมูล หรือบทบาทอื่นๆ ที่มีสิทธิ์ storage.objects.get ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการสิทธิ์เข้าถึง Cloud Storage ได้ที่ภาพรวมการควบคุมการเข้าถึง

• เมื่ออัปโหลดข้อมูลจากไฟล์ในเครื่อง ให้ระบุเส้นทางไปยังไฟล์ GeoJSON, KML หรือ CSV ที่มีข้อมูลที่ต้องการอัปโหลด

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

เมื่อสร้างชุดข้อมูล:

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

เมื่ออัปโหลดข้อมูล

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

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

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

ข้อกำหนด GeoJSON

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

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

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

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

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

Maps JavaScript 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 หากใช้หน่วยที่ไม่ถูกต้อง ชุดข้อมูลอาจนำเข้าได้สำเร็จ แต่ข้อมูลที่แสดงผลสามารถแสดงจุดของชุดข้อมูลในตำแหน่งที่ไม่คาดคิด

สร้างชุดข้อมูล

วิธีสร้างชุดข้อมูล

1. ใน Google Cloud Console ให้ไปที่หน้าชุดข้อมูล
2. คลิกสร้างชุดข้อมูล
3. ป้อนชื่อชุดข้อมูล ชื่อในชุดข้อมูลทั้งหมดต้องไม่ซ้ำกัน
4. ป้อนชุดข้อมูล Description (คำอธิบาย) หรือไม่ก็ได้
5. คลิกต่อไป หน้านำเข้าข้อมูลจะปรากฏขึ้น
6. เลือกแหล่งที่มาการอัปโหลดของข้อมูลที่ใช้เพื่อสร้างชุดข้อมูลเป็นเดสก์ท็อป ซึ่งหมายถึงไฟล์ในเครื่องในระบบของคุณ หรือที่เก็บข้อมูล Google Cloud Storage
   • สำหรับเดสก์ท็อป ให้คลิกเรียกดู แล้วเลือกไฟล์จากตัวเลือกไฟล์
   • สำหรับที่เก็บข้อมูล Google Cloud Storage ให้คลิกเรียกดู แล้วเลือกที่เก็บข้อมูลและไฟล์ที่มีข้อมูล
7. เลือกรูปแบบไฟล์
8. คลิกต่อไปเพื่อตรวจสอบการตั้งค่า
9. คลิกสร้าง หน้าชุดข้อมูลจะปรากฏโดยแสดงชุดข้อมูลใหม่ของคุณ สถานะควรเป็นกำลังดำเนินการ
10. รอจนกว่าชุดข้อมูลจะมีสถานะเสร็จสมบูรณ์

ดูหรือแก้ไขชุดข้อมูล

หลังจากสร้างชุดข้อมูลเรียบร้อยแล้ว สถานะชุดข้อมูลจะแสดงเป็นเสร็จสมบูรณ์ จากนั้นคุณจะตรวจสอบรายละเอียดของชุดข้อมูลได้

วิธีดูชุดข้อมูล

1. ใน Google Cloud Console ให้ไปที่หน้าชุดข้อมูล
2. คลิกชื่อชุดข้อมูล หน้ารายละเอียดชุดข้อมูลจะปรากฏขึ้น
   1. คลิกแท็บรายละเอียดเพื่อดูข้อมูลเกี่ยวกับชุดข้อมูล คุณยังแก้ไขชื่อและคำอธิบายชุดข้อมูลในแท็บนี้ได้
   2. คลิกแท็บแสดงตัวอย่างเพื่อดูชุดข้อมูลบนแผนที่
   3. คลิกแท็บข้อมูลตารางเพื่อดูข้อมูลชุดย่อยที่เชื่อมโยงกับชุดข้อมูล
   4. คลิกปุ่มดาวน์โหลดเพื่อดาวน์โหลดข้อมูลไปยังไฟล์ในเครื่อง
   5. คลิกปุ่มลบเพื่อลบชุดข้อมูล