本例在地圖上新增及設定折線，例如用以表示地圖上的路線。
詳情請參閱說明文件。
開始使用
請務必先設定開發環境，再試用程式碼範例。詳情請參閱「Maps SDK for Android 程式碼範例」一文。
查看程式碼
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.polyline_demo) hueBar = findViewById<SeekBar>(R.id.hueSeekBar).apply { max = MAX_HUE_DEGREES progress = 0 } alphaBar = findViewById<SeekBar>(R.id.alphaSeekBar).apply { max = MAX_ALPHA progress = MAX_ALPHA } widthBar = findViewById<SeekBar>(R.id.widthSeekBar).apply { max = MAX_WIDTH_PX progress = MAX_WIDTH_PX / 2 } startCapSpinner = findViewById<Spinner>(R.id.startCapSpinner).apply { adapter = ArrayAdapter(this@PolylineDemoActivity, android.R.layout.simple_spinner_item, getResourceStrings(capTypeNameResourceIds)) } endCapSpinner = findViewById<Spinner>(R.id.endCapSpinner).apply { adapter = ArrayAdapter(this@PolylineDemoActivity, android.R.layout.simple_spinner_item, getResourceStrings(capTypeNameResourceIds)) } jointTypeSpinner = findViewById<Spinner>(R.id.jointTypeSpinner).apply { adapter = ArrayAdapter(this@PolylineDemoActivity, android.R.layout.simple_spinner_item, getResourceStrings(jointTypeNameResourceIds)) } patternSpinner = findViewById<Spinner>(R.id.patternSpinner).apply { adapter = ArrayAdapter( this@PolylineDemoActivity, android.R.layout.simple_spinner_item, getResourceStrings(patternTypeNameResourceIds)) } clickabilityCheckbox = findViewById<CheckBox>(R.id.toggleClickability) val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment mapFragment.getMapAsync(this) } override fun onMapReady(googleMap: GoogleMap) { googleMap with(googleMap) { // Override the default content description on the view, for accessibility mode. setContentDescription(getString(R.string.polyline_demo_description)) // A geodesic polyline that goes around the world. addPolyline(PolylineOptions().apply { add(lhrLatLng, aklLatLng, laxLatLng, jfkLatLng, lhrLatLng) width(INITIAL_STROKE_WIDTH_PX.toFloat()) color(Color.BLUE) geodesic(true) clickable(clickabilityCheckbox.isChecked) }) // Move the googleMap so that it is centered on the mutable polyline. moveCamera(CameraUpdateFactory.newLatLngZoom(melbourneLatLng, 3f)) // Add a listener for polyline clicks that changes the clicked polyline's color. setOnPolylineClickListener { polyline -> // Flip the values of the red, green and blue components of the polyline's color. polyline.color = polyline.color xor 0x00ffffff } } // A simple polyline across Australia. This polyline will be mutable. mutablePolyline = googleMap.addPolyline(PolylineOptions().apply{ color(Color.HSVToColor( alphaBar.progress, floatArrayOf(hueBar.progress.toFloat(), 1f, 1f))) width(widthBar.progress.toFloat()) clickable(clickabilityCheckbox.isChecked) add(melbourneLatLng, adelaideLatLng, perthLatLng, darwinLatLng) }) arrayOf(hueBar, alphaBar, widthBar).map { it.setOnSeekBarChangeListener(this) } arrayOf(startCapSpinner, endCapSpinner, jointTypeSpinner, patternSpinner).map { it.onItemSelectedListener = this } with(mutablePolyline) { startCap = getSelectedCap(startCapSpinner.selectedItemPosition) ?: ButtCap() endCap = getSelectedCap(endCapSpinner.selectedItemPosition) ?: ButtCap() jointType = getSelectedJointType(jointTypeSpinner.selectedItemPosition) pattern = getSelectedPattern(patternSpinner.selectedItemPosition) } clickabilityCheckbox.setOnClickListener { view -> mutablePolyline.isClickable = (view as CheckBox).isChecked } } Java
public class PolylineDemoActivity extends AppCompatActivity implements OnSeekBarChangeListener, OnItemSelectedListener, OnMapReadyCallback { // City locations for mutable polyline. private static final LatLng ADELAIDE = new LatLng(-34.92873, 138.59995); private static final LatLng DARWIN = new LatLng(-12.4258647, 130.7932231); private static final LatLng MELBOURNE = new LatLng(-37.81319, 144.96298); private static final LatLng PERTH = new LatLng(-31.95285, 115.85734); // Airport locations for geodesic polyline. private static final LatLng AKL = new LatLng(-37.006254, 174.783018); private static final LatLng JFK = new LatLng(40.641051, -73.777485); private static final LatLng LAX = new LatLng(33.936524, -118.377686); private static final LatLng LHR = new LatLng(51.471547, -0.460052); private static final int MAX_WIDTH_PX = 100; private static final int MAX_HUE_DEGREES = 360; private static final int MAX_ALPHA = 255; private static final int CUSTOM_CAP_IMAGE_REF_WIDTH_PX = 50; private static final int INITIAL_STROKE_WIDTH_PX = 5; private static final int PATTERN_DASH_LENGTH_PX = 50; private static final int PATTERN_GAP_LENGTH_PX = 20; private static final Dot DOT = new Dot(); private static final Dash DASH = new Dash(PATTERN_DASH_LENGTH_PX); private static final Gap GAP = new Gap(PATTERN_GAP_LENGTH_PX); private static final List<PatternItem> PATTERN_DOTTED = Arrays.asList(DOT, GAP); private static final List<PatternItem> PATTERN_DASHED = Arrays.asList(DASH, GAP); private static final List<PatternItem> PATTERN_MIXED = Arrays.asList(DOT, GAP, DOT, DASH, GAP); private Polyline mutablePolyline; private SeekBar hueBar; private SeekBar alphaBar; private SeekBar widthBar; private Spinner startCapSpinner; private Spinner endCapSpinner; private Spinner jointTypeSpinner; private Spinner patternSpinner; private CheckBox clickabilityCheckbox; // These are the options for polyline caps, joints and patterns. We use their // string resource IDs as identifiers. private static final int[] CAP_TYPE_NAME_RESOURCE_IDS = { R.string.cap_butt, // Default R.string.cap_round, R.string.cap_square, R.string.cap_image, }; private static final int[] JOINT_TYPE_NAME_RESOURCE_IDS = { R.string.joint_type_default, // Default R.string.joint_type_bevel, R.string.joint_type_round, }; private static final int[] PATTERN_TYPE_NAME_RESOURCE_IDS = { R.string.pattern_solid, // Default R.string.pattern_dashed, R.string.pattern_dotted, R.string.pattern_mixed, }; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.polyline_demo); hueBar = findViewById(R.id.hueSeekBar); hueBar.setMax(MAX_HUE_DEGREES); hueBar.setProgress(0); alphaBar = findViewById(R.id.alphaSeekBar); alphaBar.setMax(MAX_ALPHA); alphaBar.setProgress(MAX_ALPHA); widthBar = findViewById(R.id.widthSeekBar); widthBar.setMax(MAX_WIDTH_PX); widthBar.setProgress(MAX_WIDTH_PX / 2); startCapSpinner = findViewById(R.id.startCapSpinner); startCapSpinner.setAdapter(new ArrayAdapter<>( this, android.R.layout.simple_spinner_item, getResourceStrings(CAP_TYPE_NAME_RESOURCE_IDS))); endCapSpinner = findViewById(R.id.endCapSpinner); endCapSpinner.setAdapter(new ArrayAdapter<>( this, android.R.layout.simple_spinner_item, getResourceStrings(CAP_TYPE_NAME_RESOURCE_IDS))); jointTypeSpinner = findViewById(R.id.jointTypeSpinner); jointTypeSpinner.setAdapter(new ArrayAdapter<>( this, android.R.layout.simple_spinner_item, getResourceStrings(JOINT_TYPE_NAME_RESOURCE_IDS))); patternSpinner = findViewById(R.id.patternSpinner); patternSpinner.setAdapter(new ArrayAdapter<>( this, android.R.layout.simple_spinner_item, getResourceStrings(PATTERN_TYPE_NAME_RESOURCE_IDS))); clickabilityCheckbox = findViewById(R.id.toggleClickability); SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map); mapFragment.getMapAsync(this); } @Override public void onMapReady(GoogleMap map) { // Override the default content description on the view, for accessibility mode. map.setContentDescription(getString(R.string.polyline_demo_description)); // A geodesic polyline that goes around the world. map.addPolyline(new PolylineOptions() .add(LHR, AKL, LAX, JFK, LHR) .width(INITIAL_STROKE_WIDTH_PX) .color(Color.BLUE) .geodesic(true) .clickable(clickabilityCheckbox.isChecked())); // A simple polyline across Australia. This polyline will be mutable. int color = Color.HSVToColor( alphaBar.getProgress(), new float[]{hueBar.getProgress(), 1, 1}); mutablePolyline = map.addPolyline(new PolylineOptions() .color(color) .width(widthBar.getProgress()) .clickable(clickabilityCheckbox.isChecked()) .add(MELBOURNE, ADELAIDE, PERTH, DARWIN)); hueBar.setOnSeekBarChangeListener(this); alphaBar.setOnSeekBarChangeListener(this); widthBar.setOnSeekBarChangeListener(this); startCapSpinner.setOnItemSelectedListener(this); endCapSpinner.setOnItemSelectedListener(this); jointTypeSpinner.setOnItemSelectedListener(this); patternSpinner.setOnItemSelectedListener(this); mutablePolyline.setStartCap(getSelectedCap(startCapSpinner.getSelectedItemPosition())); mutablePolyline.setEndCap(getSelectedCap(endCapSpinner.getSelectedItemPosition())); mutablePolyline.setJointType(getSelectedJointType(jointTypeSpinner.getSelectedItemPosition())); mutablePolyline.setPattern(getSelectedPattern(patternSpinner.getSelectedItemPosition())); // Move the map so that it is centered on the mutable polyline. map.moveCamera(CameraUpdateFactory.newLatLngZoom(MELBOURNE, 3)); // Add a listener for polyline clicks that changes the clicked polyline's color. map.setOnPolylineClickListener(new GoogleMap.OnPolylineClickListener() { @Override public void onPolylineClick(Polyline polyline) { // Flip the values of the red, green and blue components of the polyline's color. polyline.setColor(polyline.getColor() ^ 0x00ffffff); } }); } } 複製並執行範例
需要使用 Git 才能在本機執行這個範例。下列指令會複製範例應用程式存放區。
git clone [email protected]:googlemaps-samples/android-samples.git
將範例專案匯入 Android Studio：
- 在 Android Studio 中，選取「檔案」>「新增」>「匯入專案」。
前往您儲存存放區的位置，然後選取 Kotlin 或 Java 的專案目錄：
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin - Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- 選取「開啟」。Android Studio 會使用 Gradle 建構工具來建立您的專案。
- 在與專案的
local.properties檔案相同的目錄中，建立空白的secrets.properties檔案。詳情請參閱「將 API 金鑰加到專案」一文。 將下列字串加到
secrets.properties，並將 YOUR_API_KEY 換成您 API 金鑰的值：MAPS_API_KEY=YOUR_API_KEY- 執行應用程式。