We use essential cookies for the website to function, as well as analytics cookies for analyzing and creating statistics of the website performance. To agree to the use of analytics cookies, click "Accept All". You can manage your preferences at any time by clicking "Cookie Settings" on the footer. More Information.

Cookie Settings
Only Essential Cookies
Accept All
MaterialsConsole

HMS Core

App Services
输入关键字搜索
HMS Core
AppGallery Connect
HUAWEI HiAI
CTRL+K
GuidesMap KitAndroidMap InteractionMap Camera

Map Camera

Last updated: 2026-03-04 08:44
Content overview
Expand

Camera Attributes

The following table describes the camera attributes.

Expand

Attribute

Description

target

Longitude and latitude of the map center.

bearing

Angle of a map rotated from the north in the clockwise direction.

tilt

Angle of the camera from the nadir (directly facing the Earth), in degrees.

zoom

Zoom level near the center of the screen.

Camera Movement

Huawei maps are moved by simulating camera movement. You can control the visible region of a map by changing the camera's position. To change the camera's position, create different types of CameraUpdate objects using the CameraUpdateFactory class, and use these objects to move the camera.

Methods of Creating a CameraUpdate Object

The sample code is as follows:
Java
Kotlin
Collapse
Word wrap
Dark theme
Copy code
  1. // Method 1: Increase the camera zoom level by 1 and retain other attribute settings.
  2. CameraUpdate cameraUpdate = CameraUpdateFactory.zoomIn();
  3. 

  4. // Method 2: Decrease the camera zoom level by 1 and retain other attribute settings.
  5. CameraUpdate cameraUpdate1 = CameraUpdateFactory.zoomOut();
  6. 

  7. // Method 3: Set the camera zoom level to a specified value and retain other attribute settings.
  8. float zoom = 
    8.0f
    ;
  9. CameraUpdate cameraUpdate2 = CameraUpdateFactory.zoomTo(zoom);
  10. 

  11. // Method 4: Increase or decrease the camera zoom level by a specified value.
  12. float amount = 
    2.0f
    ;
  13. CameraUpdate cameraUpdate3 = CameraUpdateFactory.zoomBy(amount);
  14. 

  15. // Method 5: Move the camera to the specified center point and increase or decrease the camera zoom level
  16. // by a specified value. 
  17. Point point = new Point(
    31
    , 
    118
    );
  18. float amount = 
    2.0f
    ;
  19. CameraUpdate cameraUpdate4 = CameraUpdateFactory.zoomBy(amount, point);
  20. 

  21. // Method 6: Set the latitude and longitude of the camera and retain other attribute settings.
  22. LatLng latLng1 = new LatLng(
    31.5
    , 
    118.9
    );
  23. CameraUpdate cameraUpdate5 = CameraUpdateFactory.newLatLng(latLng1);
  24. 

  25. // Method 7: Set the visible region and padding.
  26. int padding = 
    100
    ;
  27. LatLng latLng1 = new LatLng(
    31.5
    , 
    118.9
    );
  28. LatLng latLng2 = new LatLng(
    32.5
    , 
    119.9
    );
  29. LatLngBounds latLngBounds = new LatLngBounds(latLng1, latLng2);
  30. CameraUpdate cameraUpdate6 = CameraUpdateFactory.newLatLngBounds(latLngBounds, padding);
  31. 

  32. // Method 8: Set the center point and zoom level of the camera.
  33. float zoom = 
    0.0f
    ;
  34. LatLng latLng2 = new LatLng(
    32.5
    , 
    119.9
    );
  35. CameraUpdate cameraUpdate7 = CameraUpdateFactory.newLatLngZoom(latLng2, zoom);
  36. 

  37. // Method 9: Scroll the camera by specified number of pixels.
  38. float x = 
    100.0f
    ;
  39. float y = 
    100.0f
    ;
  40. CameraUpdate cameraUpdate8 = CameraUpdateFactory.scrollBy(x, y);
  41. 

  42. // Method 10: Specify the camera position.
  43. // Set the tilt.
  44. float tilt = 
    2.2f
    ;
  45. // Set the bearing.
  46. float bearing = 
    31.5f
    ;
  47. CameraPosition cameraPosition = new CameraPosition(latLng1,zoom,tilt,bearing);
  48. CameraUpdate cameraUpdate9 = CameraUpdateFactory.newCameraPosition(cameraPosition);
Collapse
Word wrap
Dark theme
Copy code
  1. // Method 1: Increase the camera zoom level by 1 and retain other attribute settings.
  2. val cameraUpdate = CameraUpdateFactory.zoomIn()
  3. 

  4. // Method 2: Decrease the camera zoom level by 1 and retain other attribute settings.
  5. val cameraUpdate1 = CameraUpdateFactory.zoomOut()
  6. 

  7. // Method 3: Set the camera zoom level to a specified value and retain other attribute settings.
  8. val zoom = 
    8.0f
  9. val cameraUpdate2 = CameraUpdateFactory.zoomTo(zoom)
  10. 

  11. // Method 4: Increase or decrease the camera zoom level by a specified value.
  12. val amount = 
    2.0f
  13. val cameraUpdate3 = CameraUpdateFactory.zoomBy(amount)
  14. 

  15. // Method 5: Move the camera to the specified center point and increase or decrease the camera zoom level
  16. // by a specified value. 
  17. val point = Point(
    31
    , 
    118
    )
  18. val amount = 
    2.0f
  19. val cameraUpdate4 = CameraUpdateFactory.zoomBy(amount, point)
  20. 

  21. // Method 6: Set the latitude and longitude of the camera and retain other attribute settings.
  22. val latLng1 = LatLng(
    31.5
    , 
    118.9
    )
  23. val cameraUpdate5 = CameraUpdateFactory.newLatLng(latLng1)
  24. 

  25. // Method 7: Set the visible region and padding.
  26. val padding = 
    100
  27. val latLng1 = LatLng(
    31.5
    , 
    118.9
    )
  28. val latLng2 = LatLng(
    32.5
    , 
    119.9
    )
  29. val latLngBounds = LatLngBounds(latLng1, latLng2)
  30. val cameraUpdate6 = CameraUpdateFactory.newLatLngBounds(latLngBounds, padding)
  31. 

  32. // Method 8: Set the center point and zoom level of the camera.
  33. val zoom = 
    0.0f
  34. val latLng2 = LatLng(
    32.5
    , 
    119.9
    )
  35. val cameraUpdate7 = CameraUpdateFactory.newLatLngZoom(latLng2, zoom)
  36. 

  37. // Method 9: Scroll the camera by specified number of pixels.
  38. val x = 
    100.0f
  39. val y = 
    100.0f
  40. val cameraUpdate8 = CameraUpdateFactory.scrollBy(x, y)
  41. 

  42. // Method 10: Specify the camera position.
  43. // Set the tilt.
  44. val tilt = 
    2.2f
  45. // Set the bearing.
  46. val bearing = 
    31.5f
  47. val cameraPosition = CameraPosition(latLng1, zoom, tilt, bearing)
  48. val cameraUpdate9 = CameraUpdateFactory.newCameraPosition(cameraPosition)

Methods of Changing the Camera Position

You can move the map camera in animation or non-animation mode.

When moving the map camera in animation mode, you can set the animation duration and API to be called back when the animation stops. By default, the animation duration is 250 ms.

Camera movement in non-animation mode is transient.

The sample code is as follows:
Java
Kotlin
Collapse
Word wrap
Dark theme
Copy code
  1. // Move the map camera in animation mode.
  2. hMap.animateCamera(cameraUpdate);
  3. // Move the map camera in animation mode, and set the API to be called back when the animation stops.
  4. hMap.animateCamera(cameraUpdate, cancelableCallback);
  5. // Move the map camera in animation mode, and set the animation duration and API to be called back when the animation stops. 
  6. hMap.animateCamera(cameraUpdate, durationMs, cancelableCallback);
  7. 

  8. // Move the map camera in non-animation mode.
  9. hMap.moveCamera(cameraUpdate);
Collapse
Word wrap
Dark theme
Copy code
  1. // Move the map camera in animation mode.
  2. hMap.animateCamera(cameraUpdate)
  3. // Move the map camera in animation mode, and set the API to be called back when the animation stops.
  4. hMap.animateCamera(cameraUpdate, cancelableCallback)
  5. // Move the map camera in animation mode, and set the animation duration and API to be called back when the animation stops. 
  6. hMap.animateCamera(cameraUpdate, durationMs, cancelableCallback)
  7. 

  8. // Move the map camera in non-animation mode.
  9. hMap.moveCamera(cameraUpdate)

Methods of Setting the Preferred Minimum and Maximum Camera Zoom Levels

The sample code is as follows:
Java
Kotlin
Collapse
Word wrap
Dark theme
Copy code
  1. // Set the preferred minimum zoom level. The value ranges from 3 to 20.
  2. hMap.setMinZoomPreference(
    3
    );
  3. // Set the preferred maximum zoom level. The value ranges from 3 to 20.
  4. hMap.setMaxZoomPreference(
    14
    );
  5. // Reset the preferred maximum and minimum zoom levels.
  6. hMap.resetMinMaxZoomPreference();
Collapse
Word wrap
Dark theme
Copy code
  1. // Set the preferred minimum zoom level.
  2. hMap.setMinZoomPreference(
    3f
    )
  3. // Set the preferred maximum zoom level.
  4. hMap.setMaxZoomPreference(
    14f
    )
  5. // Reset the preferred maximum and minimum zoom levels.
  6. hMap.resetMinMaxZoomPreference()

Figure 1 and Figure 2 show the effect before and after the camera position is specified.

Figure 1 Before specifying the camera position
Figure 2 After specifying the camera position

Area Constraints

The Map SDK allows you to set the map camera bounds. You can call the setLatLngBoundsForCameraTarget(LatLngBounds) API to specify a LatLngBounds object to constrain the camera target so it will not get out of the specified bounds when users scroll the map camera. If this parameter is set to null, the map camera bounds will be cleared.

Overview
UI Controls and Gestures
English
©2026 HUAWEI Developers. All rights reserved.
Terms of Use
Statement About HUAWEI Developers and Privacy
Cookies
Cookie Settings
Open-Source Software Notice
Search in Guides
Enter a keyword.