Docs
博客更新日志GitHub简中文档
首页指南EAS参考学习

Reference version

存档Expo SnackDiscord 和论坛新闻邮件

Expo 地图 iconExpo 地图

一个在 Android 上提供 Google Maps 访问、在 iOS 上提供 Apple Maps 访问的库。

Android
iOS

GitHub

npm

更新日志

Bundled version:
~55.0.0

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

重要 此库目前处于 alpha 阶段，并且会经常出现破坏性更改。 它无法在 Expo Go 应用中使用 – 请使用开发构建来试用。

安装

Terminal
- npx expo install expo-maps

If you are installing this in an existing React Native app, make sure to install expo in your project.


观看：Expo Maps 深度解析
观看：Expo Maps 深度解析

使用 expo-maps 库将 Google Maps 和 Apple Maps 添加到你的 Expo 应用中。

配置

Expo Maps 提供对 Android 和 iOS 平台原生地图 API 的访问。

  • Apple Maps（仅在
    iOS
    上可用）    。安装此包后，无需额外配置即可使用。
  • Google Maps（仅在
    Android
    上可用）    。虽然 Google 为 iOS 提供了 Google Maps SDK，但 Expo Maps 仅在 Android 上支持它。如果你想在 iOS 上使用 Google Maps，可以考虑使用替代库或自行编写。

Google Cloud API 设置

在你能够在 Android 上使用 Google Maps 之前，你需要注册一个 Google Cloud API 项目，启用 Android 版 Maps SDK，并将相关配置添加到你的 Expo 项目中。

在 Android 上设置 Google Maps

如果你已经为 Android 上的其他 Google 服务（例如 Google Sign In）注册过项目，那么只需在你的项目中启用 Maps SDK for Android，然后跳到第 4 步。

1

注册一个 Google Cloud API 项目并启用 Android 版 Maps SDK

  • 在浏览器中打开 Google API Manager 并创建一个项目。
  • 创建完成后，进入该项目并启用 Maps SDK for Android。

2

复制你应用的 SHA-1 证书指纹

  • 如果你已经创建了开发构建，你的项目将使用 debug keystore 进行签名。
  • 构建完成后，进入你的项目仪表板，然后在 Project settings 下点击 Credentials。
  • 在 Application Identifiers 下，点击你项目的 package name，然后在 Android Keystore 下复制 SHA-1 Certificate Fingerprint 的值。

3

创建一个 API key

  • 前往 Google Cloud Credential manager 并点击 Create Credentials，然后点击 API Key。
  • 在弹窗中点击 Edit API key。
  • 在 Key restrictions > Application restrictions 下，选择 Android apps。
  • 在 Restrict usage to your Android apps 下，点击 Add an item。
  • 将你在 app.json 中的 android.package（例如：com.company.myapp）添加到 package name 字段中。
  • 然后，添加第 2 步中的 SHA-1 certificate fingerprint 的值。
  • 点击 Done，然后点击 Save。

4

将 API key 添加到你的项目中

  • 将你的 API Key 复制到 app.json 中的 android.config.googleMaps.apiKey 字段下。
  • 创建一个新的开发构建，现在你就可以在 Android 上使用 expo-maps 的 Google Maps API 了。

权限

要在地图上显示用户的位置，你需要事先声明并请求位置权限。如果你在项目中使用 config plugins（Continuous Native Generation (CNG)），可以通过其内置的配置插件进行配置。该插件允许你配置运行时无法设置、且需要构建新的应用二进制文件才能生效的各种属性。如果你的应用不使用 CNG，那么你需要手动配置该库。

Example app.json with config plugin

app.json
{
  "expo": {
    "plugins": [
      [
        "expo-maps",
        {
          "requestLocationPermission": true,
          "locationPermission": "Allow $(PRODUCT_NAME) to use your location"
        }
      ]
    ]
  }
}

Configurable properties

NameDefaultDescription
requestLocationPermissionfalse

一个布尔值，用于向 AndroidManifest.xml 和 Info.plist 添加权限。

locationPermission"Allow $(PRODUCT_NAME) to use your location"
Only for: 
iOS

用于设置 NSLocationWhenInUseUsageDescription 权限消息的字符串。

用法

import { AppleMaps, GoogleMaps } from 'expo-maps';
import { Platform, Text } from 'react-native';

export default function App() {
  if (Platform.OS === 'ios') {
    return <AppleMaps.View style={{ flex: 1 }} />;
  } else if (Platform.OS === 'android') {
    return <GoogleMaps.View style={{ flex: 1 }} />;
  } else {
    return <Text>Maps are only available on Android and iOS</Text>;
  }
}

API

import { AppleMaps, GoogleMaps } from 'expo-maps';

// AppleMaps.View 和 GoogleMaps.View 是 React 组件

Components

AppleMapsView

iOS

Type: React.Element<Component<Omit<AppleMapsViewProps, 'ref'>>>

AppleMapsViewProps

annotations

iOS
Optional • Type: AppleMapsAnnotation[]

The array of annotations to display on the map.

cameraPosition

iOS
Optional • Type: CameraPosition

The initial camera position of the map.

circles

iOS
Optional • Type: AppleMapsCircle[]

The array of circles to display on the map.

colorScheme

iOS
Optional • Type: AppleMapsColorScheme • Default: AppleMapsColorScheme.AUTOMATIC

Controls the color scheme (appearance) of the map. Use this to force the map to display in light or dark mode.

markers

iOS
Optional • Type: AppleMapsMarker[]

The array of markers to display on the map.

onAnnotationClick

iOS 18.0+
Optional • Type: (event: AppleMapsAnnotation) => void

Lambda invoked when the annotation is clicked.

onCameraMove

iOS
Optional • Type: (event: { bearing: number, coordinates: Coordinates, latitudeDelta: number, longitudeDelta: number, tilt: number, zoom: number }) => void

Lambda invoked when the map was moved by the user.

onCircleClick

iOS 18.0+
Optional • Type: (event: AppleMapsCircle) => void

Lambda invoked when the circle is clicked.

onMapClick

iOS
Optional • Type: (event: { coordinates: Coordinates }) => void

Lambda invoked when the user clicks on the map. It won't be invoked if the user clicks on POI or a marker.

onMarkerClick

iOS 18.0+
Optional • Type: (event: AppleMapsMarker) => void

Lambda invoked when the marker is clicked.

onPolygonClick

iOS 18.0+
Optional • Type: (event: AppleMapsPolygon) => void

Lambda invoked when the polygon is clicked.

onPolylineClick

iOS 18.0+
Optional • Type: (event: AppleMapsPolyline) => void

Lambda invoked when the polyline is clicked.

polygons

iOS
Optional • Type: AppleMapsPolygon[]

The array of polygons to display on the map.

polylines

iOS
Optional • Type: AppleMapsPolyline[]

The array of polylines to display on the map.

properties

iOS
Optional • Type: AppleMapsProperties

The properties for the map.

ref

iOS
Optional • Type: Ref<AppleMapsViewType>

style

iOS
Optional • Type: StyleProp<ViewStyle>

uiSettings

iOS
Optional • Type: AppleMapsUISettings

The MapUiSettings to be used for UI-specific settings on the map.

GoogleMapsView

Android

Type: React.Element<Component<Omit<GoogleMapsViewProps, 'ref'>>>

GoogleMapsViewProps

cameraPosition

Android
Optional • Type: CameraPosition

The initial camera position of the map.

circles

Android
Optional • Type: GoogleMapsCircle[]

The array of circles to display on the map.

colorScheme

Android
Optional • Type: GoogleMapsColorScheme

Defines the color scheme for the map.

contentPadding

Android
Optional • Type: GoogleMapsContentPadding

The padding values used to signal that portions of the map around the edges may be obscured. The map will move the Google logo, etc. to avoid overlapping the padding.

mapOptions

Android
Optional • Type: GoogleMapsMapOptions

Defines configuration GoogleMapOptions for a GoogleMap

markers

Android
Optional • Type: GoogleMapsMarker[]

The array of markers to display on the map.

onCameraMove

Android
Optional • Type: (event: { bearing: number, coordinates: Coordinates, tilt: number, zoom: number }) => void

Lambda invoked when the map was moved by the user.

onCircleClick

Android
Optional • Type: (event: GoogleMapsCircle) => void

Lambda invoked when the circle is clicked.

onMapClick

Android
Optional • Type: (event: { coordinates: Coordinates }) => void

Lambda invoked when the user clicks on the map. It won't be invoked if the user clicks on POI or a marker.

onMapLoaded

Android
Optional • Type: () => void

Lambda invoked when the map is loaded.

onMapLongClick

Android
Optional • Type: (event: { coordinates: Coordinates }) => void

Lambda invoked when the user long presses on the map.

onMarkerClick

Android
Optional • Type: (event: GoogleMapsMarker) => void

Lambda invoked when the marker is clicked

onPOIClick

Android
Optional • Type: (event: { coordinates: Coordinates, name: string }) => void

Lambda invoked when a POI is clicked.

onPolygonClick

Android
Optional • Type: (event: GoogleMapsPolygon) => void

Lambda invoked when the polygon is clicked.

onPolylineClick

Android
Optional • Type: (event: GoogleMapsPolyline) => void

Lambda invoked when the polyline is clicked.

polygons

Android
Optional • Type: GoogleMapsPolygon[]

The array of polygons to display on the map.

polylines

Android
Optional • Type: GoogleMapsPolyline[]

The array of polylines to display on the map.

properties

Android
Optional • Type: GoogleMapsProperties

The properties for the map.

ref

Android
Optional • Type: Ref<GoogleMapsViewType>

style

Android
Optional • Type: StyleProp<ViewStyle>

uiSettings

Android
Optional • Type: GoogleMapsUISettings

The MapUiSettings to be used for UI-specific settings on the map.

userLocation

Android
Optional • Type: GoogleMapsUserLocation

User location, overrides default behavior.

GoogleStreetView

Android

Type: React.Element<GoogleStreetViewProps>

GoogleStreetViewProps

isPanningGesturesEnabled

Android
Optional • Type: boolean

isStreetNamesEnabled

Android
Optional • Type: boolean

isUserNavigationEnabled

Android
Optional • Type: boolean

isZoomGesturesEnabled

Android
Optional • Type: boolean

position

Android
Type: StreetViewCameraPosition

style

Android
Optional • Type: StyleProp<ViewStyle>

Hooks

useLocationPermissions(options)

Android
iOS
ParameterType
options(optional)PermissionHookOptions<object>

Check or request permissions to access the location. This uses both requestPermissionsAsync and getPermissionsAsync to interact with the permissions.

Returns:
[PermissionResponse | null, RequestPermissionMethod<PermissionResponse>, GetPermissionMethod<PermissionResponse>]

Example

const [status, requestPermission] = useLocationPermissions();

Methods

Maps.getPermissionsAsync()

Android
iOS
Returns:
Promise<PermissionResponse>

Maps.requestPermissionsAsync()

Android
iOS
Returns:
Promise<PermissionResponse>

Types

AppleMapsAnnotation

iOS

Type: AppleMapsMarker extended by:

PropertyTypeDescription
backgroundColor(optional)string

The background color of the annotation.

icon(optional)SharedRefType<'image'>

The custom icon to display in the annotation.

text(optional)string

The text to display in the annotation.

textColor(optional)string

The text color of the annotation.

AppleMapsCircle

iOS
PropertyTypeDescription
centerCoordinates

The coordinates of the circle.

color(optional)ProcessedColorValue | string

The color of the circle.

id(optional)string

The unique identifier for the circle. This can be used to identify the clicked circle in the onCircleClick event.

lineColor(optional)ProcessedColorValue | string

The color of the circle line.

lineWidth(optional)number

The width of the circle line.

radiusnumber

The radius of the circle (in meters).

width(optional)number

The width of the circle.

AppleMapsMarker

iOS
PropertyTypeDescription
coordinates(optional)Coordinates

The coordinates of the marker.

id(optional)string

The unique identifier for the marker. This can be used to identify the clicked marker in the onMarkerClick event.

monogram(optional)string
Only for: 
iOS 17.0+

A short text (typically initials or 1-2 characters) to display on the marker balloon. This is mutually exclusive with systemImage. If both are provided, systemImage takes precedence.

systemImage(optional)string

The SF Symbol to display for the marker. This is mutually exclusive with monogram. If both are provided, systemImage takes precedence.

tintColor(optional)string

The tint color of the marker.

title(optional)string

The title of the marker, displayed in the callout when the marker is clicked.

AppleMapsPointOfInterestCategories

iOS
PropertyTypeDescription
excluding(optional)AppleMapPointOfInterestCategory[]

The POI categories to exclude. To show all POIs, set this to an empty array.

including(optional)AppleMapPointOfInterestCategory[]

The POI categories to include. To hide all POIs, set this to an empty array.

AppleMapsPolygon

iOS
PropertyTypeDescription
color(optional)ProcessedColorValue | string

The color of the polygon.

coordinatesCoordinates[]

The coordinates of the circle.

id(optional)string

The unique identifier for the polygon. This can be used to identify the clicked polygon in the onPolygonClick event.

lineColor(optional)ProcessedColorValue | string

The color of the polygon.

lineWidth(optional)number

The width of the polygon.

AppleMapsPolyline

iOS
PropertyTypeDescription
color(optional)ProcessedColorValue | string

The color of the polyline.

contourStyle(optional)AppleMapsContourStyle

The style of the polyline.

coordinatesCoordinates[]

The coordinates of the polyline.

id(optional)string

The unique identifier for the polyline. This can be used to identify the clicked polyline in the onPolylineClick event.

width(optional)number

The width of the polyline.

AppleMapsProperties

iOS
PropertyTypeDescription
elevation(optional)AppleMapsMapStyleElevation

Values you use to determine whether a map renders elevation.

emphasis(optional)AppleMapsMapStyleEmphasis

Values that control how the framework emphasizes map features.

isMyLocationEnabled(optional)boolean

Whether the user location is shown on the map.

Default:false
isTrafficEnabled(optional)boolean

Whether the traffic layer is enabled on the map.

mapType(optional)AppleMapsMapType

Defines which map type should be used.

pointsOfInterest(optional)AppleMapsPointOfInterestCategories

A structure you use to define points of interest to include or exclude on a map.

polylineTapThreshold(optional)number

The maximum distance in meters from a tap of a polyline for it to be considered a hit. If the distance is greater than the threshold, the polyline is not considered a hit. If a hit occurs, the onPolylineClick event will be triggered. Defaults to 20 meters.

selectionEnabled(optional)boolean

If true, the user can select a location on the map to get more information.

AppleMapsUISettings

iOS
PropertyTypeDescription
compassEnabled(optional)boolean

Whether the compass is enabled on the map. If enabled, the compass is only visible when the map is rotated.

myLocationButtonEnabled(optional)boolean

Whether the my location button is visible.

scaleBarEnabled(optional)boolean

Whether the scale bar is displayed when zooming.

togglePitchEnabled(optional)boolean

Whether the user is allowed to change the pitch type.

AppleMapsViewType

iOS
PropertyTypeDescription
openLookAroundAsync(coordinates: Coordinates) => Promise<void>

Opens the look around view at specified coordinates.

coordinates: Coordinates

The coordinates of the location to open the look around view at.

selectAnnotation(id: string, options: { moveCamera: boolean, zoom: number }) => void
Only for: 
iOS 18.0+

Programmatically select an annotation by its ID.

id: string

The ID of the annotation to select, or undefined to clear selection.

options: { moveCamera: boolean, zoom: number }

Optional configuration for the selection.

selectMarker(id: string, options: { moveCamera: boolean, zoom: number }) => void
Only for: 
iOS 18.0+

Programmatically select a marker by its ID.

id: string

The ID of the marker to select, or undefined to clear selection.

options: { moveCamera: boolean, zoom: number }

Optional configuration for the selection.

setCameraPosition(config: CameraPosition) => void

Update camera position. Animation duration is not supported on iOS.

config: CameraPosition

New camera postion.

CameraPosition

Android
iOS
PropertyTypeDescription
coordinates(optional)Coordinates

The middle point of the camera.

zoom(optional)number

The zoom level of the camera. For some view sizes, lower zoom levels might not be available.

Coordinates

Android
iOS
PropertyTypeDescription
latitude(optional)number

The latitude of the coordinate.

longitude(optional)number

The longitude of the coordinate.

GoogleMapsAnchor

Android
PropertyTypeDescription
xnumber

The normalized horizontal anchor point from 0.0 (left edge) to 1.0 (right edge).

ynumber

The normalized vertical anchor point from 0.0 (top edge) to 1.0 (bottom edge).

GoogleMapsCircle

Android
PropertyTypeDescription
centerCoordinates

The coordinates of the circle.

clickCoordinates(optional)Coordinates

The geographic coordinates of the click point on the map.

color(optional)ProcessedColorValue | string

The color of the circle.

id(optional)string

The unique identifier for the circle. This can be used to identify the clicked circle in the onCircleClick event.

lineColor(optional)ProcessedColorValue | string

The color of the circle line.

lineWidth(optional)number

The width of the circle line.

radiusnumber

The radius of the circle.

GoogleMapsContentPadding

Android
PropertyTypeDescription
bottom(optional)number

The padding on the bottom side of the map.

end(optional)number

In LTR contexts, end will be applied along the right edge. In RTL contexts, end will correspond to the left edge.

start(optional)number

In LTR contexts, start will be applied along the left edge. In RTL contexts, start will correspond to the right edge.

top(optional)number

The padding on the top side of the map.

GoogleMapsMapOptions

Android
PropertyTypeDescription
mapId(optional)string

A map ID is a unique identifier that represents Google Map styling and configuration settings that are stored in Google Cloud.

See: For more information, see https://developers.google.com/maps/documentation/android-sdk/map-ids/mapid-over

GoogleMapsMapStyleOptions

Android
PropertyTypeDescription
jsonstring

The JSON string of the map style options.

See: For creating map style options, see https://mapstyle.withgoogle.com/

GoogleMapsMarker

Android
PropertyTypeDescription
anchor(optional)GoogleMapsAnchor

The anchor used to position the anchor relative to its coordinates.

Default:bottom-center of the icon
coordinates(optional)Coordinates

The coordinates of the marker.

draggable(optional)boolean

Whether the marker is draggable.

icon(optional)SharedRefType<'image'>

The custom icon to display for the marker.

id(optional)string

The unique identifier for the marker. This can be used to identify the clicked marker in the onMarkerClick event.

showCallout(optional)boolean

Whether the callout should be shown when the marker is clicked.

snippet(optional)string

The snippet of the marker, displayed in the callout when the marker is clicked.

title(optional)string

The title of the marker, displayed in the callout when the marker is clicked.

zIndex(optional)number

The z-index to use for the marker.

Default:0

GoogleMapsPolygon

Android
PropertyTypeDescription
color(optional)ProcessedColorValue | string

The color of the polygon.

coordinatesCoordinates[]

The coordinates of the circle.

id(optional)string

The unique identifier for the polygon. This can be used to identify the clicked polygon in the onPolygonClick event.

lineColor(optional)ProcessedColorValue | string

The color of the polygon.

lineWidth(optional)number

The width of the polygon.

GoogleMapsPolyline

Android
PropertyTypeDescription
color(optional)ProcessedColorValue | string

The color of the polyline.

coordinatesCoordinates[]

The coordinates of the polyline.

geodesic(optional)boolean

Whether the polyline is geodesic.

id(optional)string

The unique identifier for the polyline. This can be used to identify the clicked polyline in the onPolylineClick event.

width(optional)number

The width of the polyline.

GoogleMapsProperties

Android
PropertyTypeDescription
isBuildingEnabled(optional)boolean

Whether the building layer is enabled on the map.

isIndoorEnabled(optional)boolean

Whether the indoor layer is enabled on the map.

isMyLocationEnabled(optional)boolean

Whether finding the user's location is enabled on the map.

isTrafficEnabled(optional)boolean

Whether the traffic layer is enabled on the map.

mapStyleOptions(optional)GoogleMapsMapStyleOptions

With style options you can customize the presentation of the standard Google map styles, changing the visual display of features like roads, parks, and other points of interest.

mapType(optional)GoogleMapsMapType

Defines which map type should be used.

maxZoomPreference(optional)number

The maximum zoom level for the map.

minZoomPreference(optional)number

The minimum zoom level for the map.

selectionEnabled(optional)boolean

If true, the user can select a location on the map to get more information.

GoogleMapsUISettings

Android
PropertyTypeDescription
compassEnabled(optional)boolean

Whether the compass is enabled on the map. If enabled, the compass is only visible when the map is rotated.

indoorLevelPickerEnabled(optional)boolean

Whether the indoor level picker is enabled .

mapToolbarEnabled(optional)boolean

Whether the map toolbar is visible.

myLocationButtonEnabled(optional)boolean

Whether the my location button is visible.

rotationGesturesEnabled(optional)boolean

Whether rotate gestures are enabled.

scaleBarEnabled(optional)boolean

Whether the scale bar is displayed when zooming.

scrollGesturesEnabled(optional)boolean

Whether the scroll gestures are enabled.

scrollGesturesEnabledDuringRotateOrZoom(optional)boolean

Whether the scroll gestures are enabled during rotation or zoom.

tiltGesturesEnabled(optional)boolean

Whether the tilt gestures are enabled.

togglePitchEnabled(optional)boolean

Whether the user is allowed to change the pitch type.

zoomControlsEnabled(optional)boolean

Whether the zoom controls are visible.

zoomGesturesEnabled(optional)boolean

Whether the zoom gestures are enabled.

GoogleMapsUserLocation

Android
PropertyTypeDescription
coordinatesCoordinates

User location coordinates.

followUserLocationboolean

Should the camera follow the users' location.

GoogleMapsViewType

Android
PropertyTypeDescription
selectMarker(id: string, options: { moveCamera: boolean, zoom: number }) => Promise<void>

This is an async operation that animates the camera to the marker. If called rapidly, a previous animation may be cancelled, causing the returned promise to reject.

id: string

The ID of the marker to select, or undefined to clear selection.

options: { moveCamera: boolean, zoom: number }

Optional configuration for the selection.

setCameraPosition(config: SetCameraPositionConfig) => void

Update camera position.

config: SetCameraPositionConfig

New camera position config.

SetCameraPositionConfig

Android

Type: CameraPosition extended by:

PropertyTypeDescription
duration(optional)number

The duration of the animation in milliseconds.

StreetViewCameraPosition

Android
PropertyTypeDescription
bearing(optional)number
-
coordinatesCoordinates
-
tilt(optional)number
-
zoom(optional)number
-

Enums

AppleMapPointOfInterestCategory

iOS

AIRPORT

AppleMapPointOfInterestCategory.AIRPORT ＝ "AIRPORT"

AMUSEMENT_PARK

AppleMapPointOfInterestCategory.AMUSEMENT_PARK ＝ "AMUSEMENT_PARK"

ANIMAL_SERVICE

AppleMapPointOfInterestCategory.ANIMAL_SERVICE ＝ "ANIMAL_SERVICE"

AQUARIUM

AppleMapPointOfInterestCategory.AQUARIUM ＝ "AQUARIUM"

ATM

AppleMapPointOfInterestCategory.ATM ＝ "ATM"

AUTOMOTIVE_REPAIR

AppleMapPointOfInterestCategory.AUTOMOTIVE_REPAIR ＝ "AUTOMOTIVE_REPAIR"

BAKERY

AppleMapPointOfInterestCategory.BAKERY ＝ "BAKERY"

BANK

AppleMapPointOfInterestCategory.BANK ＝ "BANK"

BASEBALL

AppleMapPointOfInterestCategory.BASEBALL ＝ "BASEBALL"

BASKETBALL

AppleMapPointOfInterestCategory.BASKETBALL ＝ "BASKETBALL"

BEACH

AppleMapPointOfInterestCategory.BEACH ＝ "BEACH"

BEAUTY

AppleMapPointOfInterestCategory.BEAUTY ＝ "BEAUTY"

BOWLING

AppleMapPointOfInterestCategory.BOWLING ＝ "BOWLING"

BREWERY

AppleMapPointOfInterestCategory.BREWERY ＝ "BREWERY"

CAFE

AppleMapPointOfInterestCategory.CAFE ＝ "CAFE"

CAMPGROUND

AppleMapPointOfInterestCategory.CAMPGROUND ＝ "CAMPGROUND"

CAR_RENTAL

AppleMapPointOfInterestCategory.CAR_RENTAL ＝ "CAR_RENTAL"

CASTLE

AppleMapPointOfInterestCategory.CASTLE ＝ "CASTLE"

CONVENTION_CENTER

AppleMapPointOfInterestCategory.CONVENTION_CENTER ＝ "CONVENTION_CENTER"

DISTILLERY

AppleMapPointOfInterestCategory.DISTILLERY ＝ "DISTILLERY"

EV_CHARGER

AppleMapPointOfInterestCategory.EV_CHARGER ＝ "EV_CHARGER"

FAIRGROUND

AppleMapPointOfInterestCategory.FAIRGROUND ＝ "FAIRGROUND"

FIRE_STATION

AppleMapPointOfInterestCategory.FIRE_STATION ＝ "FIRE_STATION"

FISHING

AppleMapPointOfInterestCategory.FISHING ＝ "FISHING"

FITNESS_CENTER

AppleMapPointOfInterestCategory.FITNESS_CENTER ＝ "FITNESS_CENTER"

FOOD_MARKET

AppleMapPointOfInterestCategory.FOOD_MARKET ＝ "FOOD_MARKET"

FORTRESS

AppleMapPointOfInterestCategory.FORTRESS ＝ "FORTRESS"

GAS_STATION

AppleMapPointOfInterestCategory.GAS_STATION ＝ "GAS_STATION"

GO_KART

AppleMapPointOfInterestCategory.GO_KART ＝ "GO_KART"

GOLF

AppleMapPointOfInterestCategory.GOLF ＝ "GOLF"

HIKING

AppleMapPointOfInterestCategory.HIKING ＝ "HIKING"

HOSPITAL

AppleMapPointOfInterestCategory.HOSPITAL ＝ "HOSPITAL"

HOTEL

AppleMapPointOfInterestCategory.HOTEL ＝ "HOTEL"

KAYAKING

AppleMapPointOfInterestCategory.KAYAKING ＝ "KAYAKING"

LANDMARK

AppleMapPointOfInterestCategory.LANDMARK ＝ "LANDMARK"

LAUNDRY

AppleMapPointOfInterestCategory.LAUNDRY ＝ "LAUNDRY"

LIBRARY

AppleMapPointOfInterestCategory.LIBRARY ＝ "LIBRARY"

MAILBOX

AppleMapPointOfInterestCategory.MAILBOX ＝ "MAILBOX"

MARINA

AppleMapPointOfInterestCategory.MARINA ＝ "MARINA"

MINI_GOLF

AppleMapPointOfInterestCategory.MINI_GOLF ＝ "MINI_GOLF"

MOVIE_THEATER

AppleMapPointOfInterestCategory.MOVIE_THEATER ＝ "MOVIE_THEATER"

MUSEUM

AppleMapPointOfInterestCategory.MUSEUM ＝ "MUSEUM"

MUSIC_VENUE

AppleMapPointOfInterestCategory.MUSIC_VENUE ＝ "MUSIC_VENUE"

NATIONAL_MONUMENT

AppleMapPointOfInterestCategory.NATIONAL_MONUMENT ＝ "NATIONAL_MONUMENT"

NATIONAL_PARK

AppleMapPointOfInterestCategory.NATIONAL_PARK ＝ "NATIONAL_PARK"

NIGHTLIFE

AppleMapPointOfInterestCategory.NIGHTLIFE ＝ "NIGHTLIFE"

PARK

AppleMapPointOfInterestCategory.PARK ＝ "PARK"

PARKING

AppleMapPointOfInterestCategory.PARKING ＝ "PARKING"

PHARMACY

AppleMapPointOfInterestCategory.PHARMACY ＝ "PHARMACY"

PLANETARIUM

AppleMapPointOfInterestCategory.PLANETARIUM ＝ "PLANETARIUM"

POLICE

AppleMapPointOfInterestCategory.POLICE ＝ "POLICE"

POST_OFFICE

AppleMapPointOfInterestCategory.POST_OFFICE ＝ "POST_OFFICE"

PUBLIC_TRANSPORT

AppleMapPointOfInterestCategory.PUBLIC_TRANSPORT ＝ "PUBLIC_TRANSPORT"

RESTAURANT

AppleMapPointOfInterestCategory.RESTAURANT ＝ "RESTAURANT"

RESTROOM

AppleMapPointOfInterestCategory.RESTROOM ＝ "RESTROOM"

ROCK_CLIMBING

AppleMapPointOfInterestCategory.ROCK_CLIMBING ＝ "ROCK_CLIMBING"

RV_PARK

AppleMapPointOfInterestCategory.RV_PARK ＝ "RV_PARK"

SCHOOL

AppleMapPointOfInterestCategory.SCHOOL ＝ "SCHOOL"

SKATE_PARK

AppleMapPointOfInterestCategory.SKATE_PARK ＝ "SKATE_PARK"

SKATING

AppleMapPointOfInterestCategory.SKATING ＝ "SKATING"

SKIING

AppleMapPointOfInterestCategory.SKIING ＝ "SKIING"

SOCCER

AppleMapPointOfInterestCategory.SOCCER ＝ "SOCCER"

SPA

AppleMapPointOfInterestCategory.SPA ＝ "SPA"

STADIUM

AppleMapPointOfInterestCategory.STADIUM ＝ "STADIUM"

STORE

AppleMapPointOfInterestCategory.STORE ＝ "STORE"

SURFING

AppleMapPointOfInterestCategory.SURFING ＝ "SURFING"

SWIMMING

AppleMapPointOfInterestCategory.SWIMMING ＝ "SWIMMING"

TENNIS

AppleMapPointOfInterestCategory.TENNIS ＝ "TENNIS"

THEATER

AppleMapPointOfInterestCategory.THEATER ＝ "THEATER"

UNIVERSITY

AppleMapPointOfInterestCategory.UNIVERSITY ＝ "UNIVERSITY"

VOLLEYBALL

AppleMapPointOfInterestCategory.VOLLEYBALL ＝ "VOLLEYBALL"

WINERY

AppleMapPointOfInterestCategory.WINERY ＝ "WINERY"

ZOO

AppleMapPointOfInterestCategory.ZOO ＝ "ZOO"

AppleMapsColorScheme

iOS

Controls the color scheme (appearance) of the map.

AUTOMATIC

AppleMapsColorScheme.AUTOMATIC ＝ "AUTOMATIC"

The map follows the app's color scheme (light/dark mode).

DARK

AppleMapsColorScheme.DARK ＝ "DARK"

The map is always displayed in dark mode.

LIGHT

AppleMapsColorScheme.LIGHT ＝ "LIGHT"

The map is always displayed in light mode.

AppleMapsContourStyle

iOS

The style of the polyline.

GEODESIC

AppleMapsContourStyle.GEODESIC ＝ "GEODESIC"

A geodesic line.

STRAIGHT

AppleMapsContourStyle.STRAIGHT ＝ "STRAIGHT"

A straight line.

AppleMapsMapStyleElevation

iOS

AUTOMATIC

AppleMapsMapStyleElevation.AUTOMATIC ＝ "AUTOMATIC"

The default elevation style, that renders a flat, 2D map.

FLAT

AppleMapsMapStyleElevation.FLAT ＝ "FLAT"

A flat elevation style.

REALISTIC

AppleMapsMapStyleElevation.REALISTIC ＝ "REALISTIC"

A value that renders a realistic, 3D map.

AppleMapsMapStyleEmphasis

iOS

AUTOMATIC

AppleMapsMapStyleEmphasis.AUTOMATIC ＝ "AUTOMATIC"

The default level of emphasis.

MUTED

AppleMapsMapStyleEmphasis.MUTED ＝ "MUTED"

A muted emphasis style, that deemphasizes the map’s imagery.

AppleMapsMapType

iOS

The type of map to display.

HYBRID

AppleMapsMapType.HYBRID ＝ "HYBRID"

A satellite image of the area with road and road name layers on top.

IMAGERY

AppleMapsMapType.IMAGERY ＝ "IMAGERY"

A satellite image of the area.

STANDARD

AppleMapsMapType.STANDARD ＝ "STANDARD"

A street map that shows the position of all roads and some road names.

GoogleMapsColorScheme

Android

DARK

GoogleMapsColorScheme.DARK ＝ "DARK"

FOLLOW_SYSTEM

GoogleMapsColorScheme.FOLLOW_SYSTEM ＝ "FOLLOW_SYSTEM"

LIGHT

GoogleMapsColorScheme.LIGHT ＝ "LIGHT"

GoogleMapsMapType

Android

The type of map to display.

HYBRID

GoogleMapsMapType.HYBRID ＝ "HYBRID"

Satellite imagery with roads and points of interest overlayed.

NORMAL

GoogleMapsMapType.NORMAL ＝ "NORMAL"

Standard road map.

SATELLITE

GoogleMapsMapType.SATELLITE ＝ "SATELLITE"

Satellite imagery.

TERRAIN

GoogleMapsMapType.TERRAIN ＝ "TERRAIN"

Topographic data.

权限

Android

要在地图上显示用户的位置，expo-maps 库需要以下权限：

  • ACCESS_COARSE_LOCATION：用于获取大致设备位置
  • ACCESS_FINE_LOCATION：用于获取精确设备位置
Android PermissionDescription

ACCESS_COARSE_LOCATION

Allows an app to access approximate location.

Alternatively, you might want ACCESS_FINE_LOCATION.

ACCESS_FINE_LOCATION

Allows an app to access precise location.

Alternatively, you might want ACCESS_COARSE_LOCATION.

FOREGROUND_SERVICE

Allows a regular application to use Service.startForeground.

Allows a regular application to use Service.startForeground.

FOREGROUND_SERVICE_LOCATION

Allows a regular application to use Service.startForeground with the type "location".

Allows a regular application to use Service.startForeground with the type "location".

ACCESS_BACKGROUND_LOCATION

Allows an app to access location in the background.

If you're requesting this permission, you must also request either ACCESS_COARSE_LOCATION or ACCESS_FINE_LOCATION. Requesting this permission by itself doesn't give you location access.

iOS

此库使用以下用途说明键：

Info.plist KeyDescription

NSLocationWhenInUseUsageDescription

A message that tells the user why the app is requesting access to the user’s location information while the app is running in the foreground.