Developer Console
Merci de votre visite. Cette page est disponible en anglais uniquement.

Amazon Maps API Overview (v2.5)

With the Amazon Maps API, you can create tablet apps with high-quality 3D maps that allow fluid zooming and panning, among other actions.

Mapping Features

Here is a list of the most important Amazon Maps API features:

  • Display high-quality 3D vector maps with fluid zooming and panning
  • Display standard and satellite map tiles
  • Use Fragments
  • Display location data
  • Handle user interaction with the map
  • Add markers to show a specific locations on the map
  • Draw polylines to connect two or more locations
  • Draw polygons to highlight a neighborhood or circle an area 

Introduction to Maps

The following is a sample map embedded in a tablet app:

Maps API v2.5 on a Fire tablet

To display an Amazon map in an Activity, you use the MapFragment class or the SupportMapFragment class (for devices earlier than API 12). Once a map displays, users can pan, zoom, rotate, and tilt it using touch gestures.

You can set several options for the map, such as map type, enable/disable gestures for manipulating the map (rotating, scrolling, and tilting), and control the display of UI elements (zoom buttons and compass button).

To manipulate the map, you retrieve an AmazonMap object from the MapFragment or SupportMapFragment. The AmazonMap class is the primary class for working with the map.

Use AmazonMapOptions to set the initial map settings, either in the XML layout or in code.

All Fire Tablets (7th Generation and later) running FireOS 5+ support the Maps API v2.5.

Download the Amazon Maps SDK (v2.5)

You can download the Amazon Maps SDK (v2.5) here:

The SDK file contains an Android Archive file (AAR), Maven POM file, reference documentation, and examples. You can also download this same file on the SDK Downloads page.

Moving the Map Camera

The map camera determines the area of the world shown by the map.

  • The camera target is the latitude and longitude position at the center of the map.
  • The camera zoom level sets the scale of the displayed area. As the number becomes larger, the camera moves closer to the earth to show smaller areas in greater detail.
  • The camera bearing sets the orientation of the map. Bearing is measured in degrees and works similar to compass bearings. For example, setting bearing to 0 orients the map with North at the top, while setting the bearing to 270 rotates the map to position due West at the top.
  • The camera tilt is the angle of the camera in relation to the earth.

CameraPosition attributes of the AmazonMap contain information about the current camera position.

To move the camera to a new position, you must create a CameraUpdate object that specifies the new location, zoom, bearing, and/or tilt and pass it to the AmazonMap.moveCamera() method.

Displaying the User's Location

You can automatically add the user's current location and a "locate" button by turning on the my location layer with AmazonMap.setMyLocationEnabled().

Drawing Objects on the Map

Mapping apps commonly draw objects on the map, such as markers indicating points of interest or destinations, lines representing routes, and other shapes.

Markers

You can add markers to the map by defining the marker location and other properties in a MarkerOptions object and then calling AmazonMap.addMarker(). Markers can use custom icons and colors.

Lines and Shapes

You can add lines and shapes to the map. Similar to markers, you set the initial settings for the shape with an Options object, then call an add method to draw the shape. You can add:

  • Lines, defined by a series of points (Polyline).
  • Circles, defined with a center and a radius (Circle).
  • Polygons, defined by a series of at least three points connected by lines (Polygon).

Next Steps

See Get Started with the Amazon Maps API (v2.5).