การใช้ Maps SDK สำหรับ Android v3.1.0 BETA

Maps SDK สำหรับ Android เวอร์ชัน 3.1.0 รุ่นเบต้าเป็นเวอร์ชันใหม่ที่มี API แพลตฟอร์มเหมือนกับเวอร์ชันก่อนหน้า (คลาสและเมธอดทั้งหมดยังคงเหมือนเดิม) และมีฟีเจอร์ใหม่ๆ ให้คุณลองใช้ ดังนี้

  • การปรับแต่ง Maps
  • การจัดการการชนของเครื่องหมายชน
  • การปรับแต่งเส้นประกอบ

คู่มือนี้จะแสดงวิธีใช้ฟีเจอร์ใหม่

การปรับแต่ง Maps (เบต้า)

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

การจัดการการชนของเครื่องหมาย (เบต้า)

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

การปรับแต่งเส้นประกอบ (เบต้า)

คุณสามารถปรับแต่งลักษณะที่ปรากฏของเส้นประกอบได้หลายวิธีดังนี้

  • เส้นประกอบหลากสีกำหนดส่วนของเส้นประกอบเป็นสีต่างๆ
  • เส้นประกอบแบบไล่ระดับสีจะกำหนดสีเส้นประกอบโดยใช้การไล่ระดับสี 2 สี
  • เส้นประกอบที่ประทับตราจะจัดรูปแบบเส้นประกอบโดยใช้บิตแมปที่ซ้ำกัน

การสร้างเส้นประกอบหลากสี

คุณใช้ระยะเวลาเพื่อใส่สีส่วนต่างๆ ของเส้นตรงแต่ละส่วนได้โดยการสร้างวัตถุ StyleSpan แล้วเพิ่มลงใน PolylineOptions โดยใช้เมธอด addSpan() หรือ addSpans() โดยค่าเริ่มต้น แต่ละรายการในอาร์เรย์จะกำหนดสี ของกลุ่มรายการโฆษณาที่เกี่ยวข้อง ตัวอย่างต่อไปนี้แสดงการตั้งค่าสีของเซกเมนต์เพื่อสร้างเส้นประกอบที่มีเซกเมนต์สีแดงและเขียว

Kotlin



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

      

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

      

การสร้างเส้นประกอบแบบไล่ระดับสี

คุณสามารถกำหนดการไล่ระดับสีโดยการระบุจำนวนเต็มอัลฟา-แดง-เขียว (ARGB) แบบ 32 บิต 2 ตัวเพื่อระบุสีเริ่มต้นและสิ้นสุดของเส้นโครงร่าง ตั้งค่าพร็อพเพอร์ตี้นี้ในออบเจ็กต์ตัวเลือกของรูปร่างโดยการเรียกใช้ PolylineOptions.addSpan() ตัวอย่างต่อไปนี้แสดงการสร้างเส้นประกอบไล่ระดับสีแดงไปเหลืองจากสวนสัตว์ Woodland Park Zoo ถึง Kirkland, WA

Kotlin



val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

      

Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

      

การสร้างเส้นประกอบที่ประทับตรา

คุณสามารถตั้งรูปลักษณ์ของเส้นประกอบเป็นพื้นผิวบิตแมปที่ซ้ำกันได้ โดยสร้าง StampStyle เป็น TextureStyle จากนั้นตั้งค่าพร็อพเพอร์ตี้นี้ในออบเจ็กต์ตัวเลือกของรูปร่างโดยเรียกใช้ PolylineOptions.addSpan() ตามที่แสดงไว้ที่นี่

Kotlin



val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

      

Java


StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

      

นำเข้าไลบรารียูทิลิตีที่ใช้ร่วมกับรุ่นเบต้าได้

หากคุณใช้ไลบรารียูทิลิตีของ Google Maps API สำหรับ Android คุณจะต้องอัปเดตทรัพยากร Dependency ของโปรเจ็กต์ด้วยเพื่อแทนที่เวอร์ชันที่มีอยู่ด้วยเวอร์ชันที่เข้ากันได้กับรุ่นเบต้า โดยทำดังนี้

  1. นำเข้าไลบรารี util ที่ใช้ร่วมกับรุ่นเบต้าได้ในไฟล์ build.gradle ของคุณ:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
    
  2. นำรายการต่อไปนี้ออกจาก build.gradle เพื่อนำไลบรารียูทิลิตีที่ใช้ร่วมกับรุ่นเบต้าไม่ได้ออก
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'
    

เรียกใช้ตัวอย่าง

ที่เก็บ Google Samples บน GitHub มีแอปตัวอย่างที่สาธิตการใช้ SDK สำหรับ Maps รุ่นเบต้าเวอร์ชัน 3.1.0 สำหรับ Android