בדוגמה הזו משרטטים מצולעים בצורות ובצבעים שונים במפה.
למידע נוסף, עיינו במאמרי העזרה.
שנתחיל?
לפני שתוכלו לנסות את הקוד לדוגמה, עליכם להגדיר את סביבת הפיתוח שלכם. מידע נוסף זמין במאמר דוגמאות קוד של מפות Google ל-Android.
הצגת הקוד
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.polygon_demo) fillHueBar = findViewByIdSe<ekBar(R>.id.fillHueSeekBar).apply { max = MAX_HUE_DEGREES progress = MAX_HUE_DEGREES / 2 } fillAlphaBar = findViewByIdSe<ekBar(R>.id.fillAlphaSeekBar).apply { max = MAX_ALPHA progress = MAX_ALPHA / 2 } strokeWidthBar = findViewByIdSe<ekBar(R>.id.strokeWidthSeekBar).apply { max = MAX_WIDTH_PX progress = MAX_WIDTH_PX / 3 } strokeHueBar = findViewByIdSe<ekBar(R>.id.strokeHueSeekBar).apply { max = MAX_HUE_DEGREES progress = 0 } strokeAlphaBar = findViewByIdSe<ekBar(R>.id.strokeAlphaSeekBar).apply { max = MAX_ALPHA progress = MAX_ALPHA } strokeJointTypeSpinner = findViewByIdSp<inner(R>.id.strokeJointTypeSpinner).apply { adapter = ArrayAdapter( this@PolygonDemoActivity, android.R.layout.simple_spinner_item, getResourceStrings(jointTypeNameResourceIds)) } strokePatternSpinner = findViewByIdSp<inner(R>.id.strokePatternSpinner).apply { adapter = ArrayAdapter( this@PolygonDemoActivity, android.R.layout.simple_spinner_item, getResourceStrings(patternTypeNameResourceIds)) } clickabilityCheckbox = findViewById(R.id.toggleClickability) val mapFragment = supportFragmentManager.findFragmentById(R.id.map) as SupportMapFragment mapFragment.getMapAsync(this) } override fun onMapReady(googleMap: GoogleMap) { // return early if the map was not initialised properly googleMap ?: return val fillColorArgb = Color.HSVToColor( fillAlphaBar.progress, floatArrayOf(fillHueBar.progress.toFloat(), 1f, 1f)) val strokeColorArgb = Color.HSVToColor( strokeAlphaBar.progress, floatArrayOf(strokeHueBar.progress.toFloat(), 1f, 1f)) with(googleMap) { // Override the default content description on the view, for accessibility mode. setContentDescription(getString(R.string.polygon_demo_description)) // Move the googleMap so that it is centered on the mutable polygon. moveCamera(CameraUpdateFactory.newLatLngZoom(center, 4f)) // Create a rectangle with two rectangular holes. mutablePolygon = addPolygon(PolygonOptions().apply { addAll(createRectangle(center, 5.0, 5.0)) addHole(createRectangle(LatLng(-22.0, 128.0), 1.0, 1.0)) addHole(createRectangle(LatLng(-18.0, 133.0), 0.5, 1.5)) fillColor(fillColorArgb) strokeColor(strokeColorArgb) strokeWidth(strokeWidthBar.progress.toFloat()) clickable(clickabilityCheckbox.isChecked) }) // Add a listener for polygon clicks that changes the clicked polygons 'stroke color. setOnPolygonClickListener { polygon - > // Flip the red, green and blue components of the polygons 'stroke color. polygon.strokeColor = polygon.strokeColor xor 0x00ffffff } } // set listeners on seekBars arrayOf(fillHueBar, fillAlphaBar, strokeWidthBar, strokeHueBar, strokeAlphaBar).map { it.setOnSeekBarChangeListener(this) } // set listeners on spinners arrayOf(strokeJointTypeSpinner, strokePatternSpinner).map { it.onItemSelectedListener = this } // set line pattern and joint type based on current spinner position with(mutablePolygon) { strokeJointType = getSelectedJointType(strokeJointTypeSpinner.selectedItemPosition) strokePattern = getSelectedPattern(strokePatternSpinner.selectedItemPosition) } }Po
Java
public class PolygonDemoActivity extends AppCompatActivity implements OnSeekBarChangeListener, OnItemSelectedListener, OnMapReadyCallback { private static final LatLng CENTER = new LatLng(-20, 130); 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 PATTERN_DASH_LENGTH_PX = 50; private static final int PATTERN_GAP_LENGTH_PX = 10; 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 ListP<atternItem >PATTERN_DOTTED = Arrays.asList(DOT, GAP); private static final ListP<atternItem >PATTERN_DASHED = Arrays.asList(DASH, GAP); private static final ListP<atternItem >PATTERN_MIXED = Arrays.asList(DOT, GAP, DOT, DASH, GAP); private Polygon mutablePolygon; private SeekBar fillHueBar; private SeekBar fillAlphaBar; private SeekBar strokeWidthBar; private SeekBar strokeHueBar; private SeekBar strokeAlphaBar; private Spinner strokeJointTypeSpinner; private Spinner strokePatternSpinner; private CheckBox clickabilityCheckbox; // These are the options for polygon stroke joints and patterns. We use their // string resource IDs as identifiers. 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.polygon_demo); fillHueBar = findViewById(R.id.fillHueSeekBar); fillHueBar.setMax(MAX_HUE_DEGREES); fillHueBar.setProgress(MAX_HUE_DEGREES / 2); fillAlphaBar = findViewById(R.id.fillAlphaSeekBar); fillAlphaBar.setMax(MAX_ALPHA); fillAlphaBar.setProgress(MAX_ALPHA / 2); strokeWidthBar = findViewById(R.id.strokeWidthSeekBar); strokeWidthBar.setMax(MAX_WIDTH_PX); strokeWidthBar.setProgress(MAX_WIDTH_PX / 3); strokeHueBar = findViewById(R.id.strokeHueSeekBar); strokeHueBar.setMax(MAX_HUE_DEGREES); strokeHueBar.setProgress(0); strokeAlphaBar = findViewById(R.id.strokeAlphaSeekBar); strokeAlphaBar.setMax(MAX_ALPHA); strokeAlphaBar.setProgress(MAX_ALPHA); strokeJointTypeSpinner = findViewById(R.id.strokeJointTypeSpinner); strokeJointTypeSpinner.setAdapter(new ArrayAdapter(<> this, android.R.layout.simple_spinner_item, getResourceStrings(JOINT_TYPE_NAME_RESOURCE_IDS))); strokePatternSpinner = findViewById(R.id.strokePatternSpinner); strokePatternSpinner.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.polygon_demo_description)); int fillColorArgb = Color.HSVToColor( fillAlphaBar.getProgress(), new float[]{fillHueBar.getProgress(), 1, 1}); int strokeColorArgb = Color.HSVToColor( strokeAlphaBar.getProgress(), new float[]{strokeHueBar.getProgress(), 1, 1}); // Create a rectangle with two rectangular holes. mutablePolygon = map.addPolygon(new PolygonOptions() .addAll(createRectangle(CENTER, 5, 5)) .addHole(createRectangle(new LatLng(-22, 128), 1, 1)) .addHole(createRectangle(new LatLng(-18, 133), 0.5, 1.5)) .fillColor(fillColorArgb) .strokeColor(strokeColorArgb) .strokeWidth(strokeWidthBar.getProgress()) .clickable(clickabilityCheckbox.isChecked())); fillHueBar.setOnSeekBarChangeListener(this); fillAlphaBar.setOnSeekBarChangeListener(this); strokeWidthBar.setOnSeekBarChangeListener(this); strokeHueBar.setOnSeekBarChangeListener(this); strokeAlphaBar.setOnSeekBarChangeListener(this); strokeJointTypeSpinner.setOnItemSelectedListener(this); strokePatternSpinner.setOnItemSelectedListener(this); mutablePolygon.setStrokeJointType(getSelectedJointType(strokeJointTypeSpinner.getSelectedItemPosition())); mutablePolygon.setStrokePattern(getSelectedPattern(strokePatternSpinner.getSelectedItemPosition())); // Move the map so that it is centered on the mutable polygon. map.moveCamera(CameraUpdateFactory.newLatLngZoom(CENTER, 4)); // Add a listener for polygon clicks that changes the clicked polygons' stroke color. map.setOnPolygonClickListener(new GoogleMap.OnPolygonClickListener() { @Override public void onPolygonClick(Polygon polygon) { // Flip the red, green and blue components of the polygons' stroke color. polygon.setStrokeColor(polygon.getStrokeColor() ^ 0x00ffffff); } }); } }P
שכפול והרצה של הדוגמאות
נדרש Git כדי להריץ את הדוגמה הזו באופן מקומי. הפקודה הבאה תשכפל את הדוגמה של Google Apps.
git clone git@github.com:googlemaps-samples/android-samples.git
מייבאים את הפרויקט לדוגמה אל Android Studio:
- ב-Android Studio, בוחרים באפשרות File > חדש > ייבוא פרויקט.
עוברים למיקום שבו שמרתם את המאגר ובוחרים את ספריית הפרויקט. Kotlin או Java:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- לוחצים על פתיחה. מערכת Android Studio יוצרת את הפרויקט באמצעות גרסת ה-build של Gradle של Google.
- יוצרים קובץ
secrets.properties
ריק באותה ספרייה שבה נמצא קובץlocal.properties
של הפרויקט. מידע נוסף זמין במאמר הוספת מפתח API לפרויקט. מוסיפים את המחרוזת הבאה אל
secrets.properties
, ומחליפים את YOUR_API_KEY בערך של מפתח ה-API:MAPS_API_KEY=YOUR_API_KEY
- מפעילים את האפליקציה.