เพิ่มชุดข้อมูลลงในแผนที่และชุดข้อมูลรูปแบบ

เลือกแพลตฟอร์ม: Android iOS JavaScript

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

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

คุณควรมีรหัสแผนที่และรูปแบบแผนที่ รวมถึงรหัสชุดข้อมูลก่อนดำเนินการต่อ

• สร้างรหัสแผนที่และรูปแบบแผนที่

• สร้างและอัปโหลดชุดข้อมูล

  หมายเหตุ: คุณต้องมีรหัสชุดข้อมูลเพื่อเริ่มต้นแอป

เชื่อมโยงรหัสชุดข้อมูลกับรูปแบบแผนที่

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

หากต้องการเชื่อมโยงชุดข้อมูลกับรูปแบบแผนที่ ให้ทำดังนี้

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

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

ใช้รูปแบบกับชุดข้อมูล

วิธีใช้รูปแบบกับชุดข้อมูล

1. สร้างฟังก์ชันสไตล์แฟกทอรีที่ใช้อินเทอร์เฟซ FeatureLayer.StyleFactory ฟังก์ชันนี้จะกำหนดตรรกะการจัดสไตล์สำหรับชุดข้อมูล

2. เรียกใช้ FeatureLayer.setFeatureStyle() เพื่อใช้ฟังก์ชันโรงงานรูปแบบกับแต่ละฟีเจอร์ในชุดข้อมูล

สร้างฟังก์ชันโรงงานสไตล์

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

หากรูปแบบแสดงผล null เป็นค่าเริ่มต้น ฟีเจอร์ที่ระบุจะไม่แสดงผล ดูข้อมูลเพิ่มเติมได้ที่นำการจัดสไตล์ออกจากเลเยอร์

หมายเหตุ: หากอัปเดตหรือแก้ไขฟังก์ชันสไตล์แฟกทอรีสำหรับเลเยอร์ฟีเจอร์ คุณต้องเรียกใช้ FeatureLayer.setFeatureStyle() อีกครั้งเพื่อรีเซ็ตฟังก์ชันในเลเยอร์ฟีเจอร์

Maps SDK สำหรับ Android จะส่งอินสแตนซ์ Feature ให้กับฟังก์ชันการสร้างสไตล์ อินสแตนซ์ Feature จะแสดงข้อมูลเมตาของฟีเจอร์ ซึ่งช่วยให้คุณเข้าถึงข้อมูลเมตาในฟังก์ชันเริ่มต้นจากรูปแบบได้

หมายเหตุ: สำหรับชุดข้อมูล อินสแตนซ์จะเป็นประเภท DatasetFeature ซึ่งเป็นคลาสย่อยของ Feature

ฟังก์ชันสไตล์แฟกทอรีควรแสดงผลลัพธ์ที่สอดคล้องกันเสมอเมื่อนำมาใช้ เช่น หากต้องการสุ่มสีชุดฟีเจอร์ ส่วนที่สุ่มไม่ควรอยู่ในฟังก์ชันสไตล์ฟีเจอร์ เนื่องจากจะทําให้ได้ผลลัพธ์ที่ไม่ต้องการ

เนื่องจากฟังก์ชันนี้จะทำงานกับองค์ประกอบทุกรายการในเลเยอร์ การเพิ่มประสิทธิภาพจึงมีความสำคัญ เพื่อหลีกเลี่ยงการส่งผลต่อเวลาการแสดงผล ให้เรียกใช้ FeatureLayer.setFeatureStyle(null) เมื่อไม่มีการใช้เลเยอร์ฟีเจอร์แล้ว

นอกจากนี้ คุณยังเรียกใช้ FeatureLayer.getDatasetId() เพื่อรับรหัสของชุดข้อมูลได้ด้วย

กำหนดเส้นโครงร่าง สีเติม และรัศมีของจุด

เมื่อจัดสไตล์องค์ประกอบในฟังก์ชัน Style Factory คุณจะตั้งค่าสิ่งต่อไปนี้ได้

• สีเส้นโครงร่างและความทึบแสงของเส้นขอบตามที่คลาส Color กำหนด ค่าเริ่มต้นคือ โปร่งใส (Color.TRANSPARENT)

• ความกว้างเส้นโครงร่างของเส้นขอบในหน่วยพิกเซลของหน้าจอ ค่าเริ่มต้นคือ 2

• สีเติมและความโปร่งแสงตามที่ระบุโดยคลาส Color ค่าเริ่มต้นคือ โปร่งใส (Color.TRANSPARENT)

• รัศมีจุดขององค์ประกอบจุดระหว่าง 0 ถึง 128 พิกเซล

ใช้กฎสไตล์แบบง่าย

วิธีที่ง่ายที่สุดในการจัดรูปแบบฟีเจอร์คือการกำหนด FeatureLayer.StyleFactory ซึ่งจะสร้างออบเจ็กต์ FeatureStyle ที่เหมือนกันเสมอไม่ว่าฟีเจอร์จะเป็นอย่างไรก็ตาม ใช้ตัวเลือกรูปแบบฟีเจอร์กับเลเยอร์ฟีเจอร์ของชุดข้อมูลโดยตรงหรือใช้ร่วมกับ FeatureStyleFunction ก็ได้

ใช้กฎรูปแบบการประกาศ

คุณตั้งค่ากฎสไตล์แบบประกาศตามแอตทริบิวต์องค์ประกอบได้ และนำไปใช้กับชุดข้อมูลทั้งหมด คุณสามารถแสดงผล null จากฟังก์ชันสไตล์องค์ประกอบได้ เช่น หากต้องการให้องค์ประกอบชุดย่อยยังคงมองไม่เห็น

ตัวอย่างเช่น ใช้เมธอด DatasetFeature.getDatasetAttributes() เพื่อแสดงผล Map<String,String> ของแอตทริบิวต์ชุดข้อมูลสำหรับฟีเจอร์ คุณสามารถปรับแต่งการจัดรูปแบบของคุณลักษณะตามแอตทริบิวต์ได้

ตัวอย่างนี้จะกำหนดค่าแอตทริบิวต์ "highlightColor" ของฟีเจอร์แต่ละรายการของชุดข้อมูลเพื่อควบคุมการจัดรูปแบบ

Kotlin

// Get the dataset feature, so we can work with all of its attributes.
val datasetFeature: DatasetFeature = feature as DatasetFeature

// Create a switch statement based on the value of the
// "highlightColor" attribute of the dataset.
val attributeColor: MutableMap<String, String> = datasetFeature.getDatasetAttributes()
when (attributeColor["highlightColor"]) {
  "Black" -> {
    ...
  }
  "Red" -> {
    ...
  }
  else -> {
    ...
  }
}

Java

// Get the dataset feature, so we can work with all of its attributes.
DatasetFeature datasetFeature = (DatasetFeature) feature;

// Create a switch statement based on the value of the
// "highlightColor" attribute of the dataset.
Map<String, String> attributeColor = datasetFeature.getDatasetAttributes();
switch(attributeColor.get("highlightColor"))
{
  case "Black":
    ...
    break;
  case "Red":
    ...
    break;
  default: // Color not defined.
    ...
    break;
}

ใช้รูปแบบกับเลเยอร์ฟีเจอร์ของชุดข้อมูล

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

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

2. รับการอ้างอิงไปยังเลเยอร์ฟีเจอร์ชุดข้อมูลเมื่อแผนที่เริ่มต้น

   Kotlin

   private var datasetLayer: FeatureLayer? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the DATASET feature layer.
     datasetLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build())
   
     // Apply style factory function to DATASET layer.
     styleDatasetsLayer()
   }

   Java

   private FeatureLayer datasetLayer;
   
   @Override
   public void onMapReady(GoogleMap map) {
     // Get the DATASET feature layer.
     datasetLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build());
   
     // Apply style factory function to DATASET layer.
     styleDatasetsLayer();
   }

3. สร้างฟังก์ชันเริ่มต้นรูปแบบและนำไปใช้กับเลเยอร์ฟีเจอร์ชุดข้อมูล

   ตัวอย่างต่อไปนี้ใช้การเติมและการขีดเส้นเดียวกันกับองค์ประกอบทั้งหมดในชุดข้อมูล

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

   Kotlin

   private fun styleDatasetsLayer() {
   
     // Create the style factory function.
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
   
         // Check if the feature is an instance of DatasetFeature.
         if (feature is DatasetFeature) {
   
               return@StyleFactory FeatureStyle.Builder()
                   // Define a style with green fill at 50% opacity and
                   // solid green border.
                   .fillColor(0x8000ff00.toInt())
                   .strokeColor(0xff00ff00.toInt())
                   .strokeWidth(2F)
                   .build()
         }
         return@StyleFactory null
     }
   
     // Apply the style factory function to the feature layer.
     datasetLayer?.setFeatureStyle(styleFactory)
   }

   Java

   private void styleDatasetsLayer() {
   
     // Create the style factory function.
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
   
       // Check if the feature is an instance of DatasetFeature.
       if (feature instanceof DatasetFeature) {
   
           return new FeatureStyle.Builder()
             // Define a style with green fill at 50% opacity and solid green border.
             .fillColor(0x8000ff00)
             .strokeColor(0xff00ff00)
             .strokeWidth(2)
             .build();
         }
         return null;
       };
   
       // Apply the style factory function to the feature layer.
       datasetLayer.setFeatureStyle(styleFactory);
   }

นำการจัดสไตล์ออกจากเลเยอร์

หากต้องการนำการจัดรูปแบบออกจากเลเยอร์ ให้เรียก FeatureLayer.setFeatureStyle(null)

นอกจากนี้ คุณยังส่งคืน null จากโรงงานสไตล์ของคุณได้ เช่น หากต้องการให้บางส่วนของฟีเจอร์ไม่ปรากฏให้เห็น