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 ของโปรเจ็กต์ด้วยเพื่อแทนที่เวอร์ชันที่มีอยู่ด้วยเวอร์ชันที่เข้ากันได้กับรุ่นเบต้า โดยทำดังนี้
- นำเข้าไลบรารี util ที่ใช้ร่วมกับรุ่นเบต้าได้ในไฟล์
build.gradle
ของคุณ:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- นำรายการต่อไปนี้ออกจาก
build.gradle
เพื่อนำไลบรารียูทิลิตีที่ใช้ร่วมกับรุ่นเบต้าไม่ได้ออกimplementation 'com.google.maps.android:android-maps-utils:1.3.1'
เรียกใช้ตัวอย่าง
ที่เก็บ Google Samples บน GitHub มีแอปตัวอย่างที่สาธิตการใช้ SDK สำหรับ Maps รุ่นเบต้าเวอร์ชัน 3.1.0 สำหรับ Android
- ตัวอย่าง Maps SDK สำหรับ Android
- Places SDK สำหรับตัวอย่าง Android (สำหรับใช้กับ Maps v3.1.0 รุ่นเบต้าเท่านั้น)