GoogleMap

публичный финальный класс GoogleMap расширяет объект

Это основной класс SDK Google Maps для Android, который является точкой входа для всех методов, связанных с картой. Вы не можете создать экземпляр объекта GoogleMap напрямую, вы должны получить его из метода getMapAsync() в MapFragment или MapView , которые вы добавили в свое приложение.

Примечание. Как и объект View , GoogleMap можно читать и изменять только из потока пользовательского интерфейса Android. Вызов методов GoogleMap из другого потока приведет к исключению.

Вы можете настроить точку обзора карты, изменив положение камеры (в отличие от перемещения карты). Вы можете использовать камеру карты для установки таких параметров, как местоположение, уровень масштабирования, угол наклона и направление. Дополнительную информацию см. в разделе Камера и просмотр .

Руководство разработчика

Для начала прочтите руководство для разработчиков Google Maps SDK для Android .

Сводка вложенных классов

интерфейс GoogleMap.CancelableCallback Интерфейс обратного вызова для сообщения о завершении или отмене задачи.
интерфейс GoogleMap.InfoWindowAdapter Предоставляет представления для индивидуального отображения информационных окон.
интерфейс GoogleMap.OnCameraChangeListener Этот интерфейс устарел. Заменено GoogleMap.OnCameraMoveStartedListener , GoogleMap.OnCameraMoveListener и GoogleMap.OnCameraIdleListener . Порядок, в котором устаревший метод onCameraChange будет вызываться относительно методов в новых прослушивателях смены камеры, не определен.
интерфейс GoogleMap.OnCameraIdleListener Интерфейс обратного вызова, когда движение камеры закончилось.
интерфейс GoogleMap.OnCameraMoveCanceledListener Интерфейс обратного вызова, когда движение камеры было остановлено или когда камера начала двигаться по новой причине.
интерфейс GoogleMap.OnCameraMoveListener Интерфейс обратного вызова, когда камера меняет положение.
интерфейс GoogleMap.OnCameraMoveStartedListener Интерфейс обратного вызова, когда начинается движение камеры.
интерфейс GoogleMap.OnCircleClickListener Интерфейс обратного вызова при нажатии на кружок.
интерфейс GoogleMap.OnGroundOverlayClickListener Интерфейс обратного вызова при нажатии на наземное наложение.
интерфейс GoogleMap.OnIndoorStateChangeListener Прослушиватель изменений состояния помещения.
интерфейс GoogleMap.OnInfoWindowClickListener Интерфейс обратного вызова для событий щелчка/касания в информационном окне маркера.
интерфейс GoogleMap.OnInfoWindowCloseListener Интерфейс обратного вызова для событий закрытия в информационном окне маркера.
интерфейс GoogleMap.OnInfoWindowLongClickListener Интерфейс обратного вызова, когда пользователь долго нажимает на информационное окно маркера.
интерфейс GoogleMap.OnMapClickListener Интерфейс обратного вызова, когда пользователь нажимает на карту.
интерфейс GoogleMap.OnMapLoadedCallback Интерфейс обратного вызова, когда карта завершила рендеринг.
интерфейс GoogleMap.OnMapLongClickListener Интерфейс обратного вызова, когда пользователь долго нажимает на карту.
интерфейс GoogleMap.OnMarkerClickListener Определяет сигнатуры для методов, которые вызываются при щелчке или касании маркера.
интерфейс GoogleMap.OnMarkerDragListener Интерфейс обратного вызова для событий перетаскивания на маркерах.
интерфейс GoogleMap.OnMyLocationButtonClickListener Интерфейс обратного вызова при нажатии кнопки «Мое местоположение».
интерфейс GoogleMap.OnMyLocationChangeListener Этот интерфейс устарел. Вместо этого используйте com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi обеспечивает улучшенное определение местоположения и энергопотребление и используется синей точкой «Мое местоположение». См. руководство «Выбор текущего места» , в котором используется FusedLocationProviderApi, или руководство разработчика местоположения .
интерфейс GoogleMap.OnMyLocationClickListener Интерфейс обратного вызова при нажатии точки «Мое местоположение» (которая обозначает местоположение пользователя).
интерфейс GoogleMap.OnPoiClickListener Прослушиватель нажатий на POI.
интерфейс GoogleMap.OnPolygonClickListener Интерфейс обратного вызова при нажатии на многоугольник.
интерфейс GoogleMap.OnPolylineClickListener Интерфейс обратного вызова при нажатии на ломаную линию.
интерфейс GoogleMap.SnapshotReadyCallback Интерфейс обратного вызова для уведомления о создании моментального снимка.

Постоянное резюме

интервал MAP_TYPE_HYBRID Спутниковые карты с прозрачным слоем основных улиц.
интервал MAP_TYPE_NONE Нет плиток базовой карты.
интервал MAP_TYPE_NORMAL Базовые карты.
интервал MAP_TYPE_SATELLITE Спутниковые карты без надписей.
интервал MAP_TYPE_TERRAIN Карты местности.

Краткое описание общедоступного метода

Круг
addCircle (параметры CircleOptions )
Добавьте круг на эту карту.
GroundOverlay
addGroundOverlay (параметры GroundOverlayOptions )
Добавляет изображение на эту карту.
Маркер
addMarker (параметры MarkerOptions )
Добавляет маркер на эту карту.
Полигон
addPolygon (параметры PolygonOptions )
Добавляет полигон на эту карту.
Полилиния
addPolyline (параметры PolylineOptions )
Добавляет полилинию на эту карту.
ПлиткаНаложение
addTileOverlay (параметры TileOverlayOptions )
Добавляет наложение плиток на эту карту.
пустота
animateCamera (обновление CameraUpdate )
Анимирует перемещение камеры из текущего положения в положение, определенное в обновлении.
пустота
animateCamera (обновление CameraUpdate , обратный вызов GoogleMap.CancelableCallback )
Анимирует перемещение камеры из текущей позиции в позицию, определенную в обновлении, и вызывает дополнительный обратный вызов по завершении.
пустота
animateCamera (обновление CameraUpdate , inturationMs, обратный вызов GoogleMap.CancelableCallback )
Перемещает карту в соответствии с обновлением с анимацией в течение заданной продолжительности и вызывает дополнительный обратный вызов по завершении.
пустота
прозрачный ()
Удаляет с карты все маркеры, полилинии, многоугольники, наложения и т. д.
Положение камеры
getCameraPosition ()
Получает текущее положение камеры.
КрытыйЗдание
getFocusedBuilding ()
Получает здание, находящееся в фокусе.
интервал
getMapType ()
Получает тип карты, отображаемой в данный момент.
плавать
getMaxZoomLevel ()
Возвращает максимальный уровень масштабирования для текущего положения камеры.
плавать
getMinZoomLevel ()
Возвращает минимальный уровень масштабирования.
Расположение
getMyLocation ()
Этот метод устарел. вместо этого используйте com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi обеспечивает улучшенное определение местоположения и энергопотребление и используется синей точкой «Мое местоположение». Пример кода см. MyLocationDemoActivity в папке примеров приложений или в Руководстве разработчика Location .
Проекция
получитьПроекцию ()
Возвращает объект Projection , который можно использовать для преобразования координат экрана в координаты широты и долготы.
Настройки пользовательского интерфейса
получитьUiSettings ()
Получает настройки пользовательского интерфейса для карты.
логическое значение
isBuildingsEnabled ()
Возвращает, включен ли слой 3D-зданий.
логическое значение
isIndoorEnabled ()
Проверяет, включены ли в данный момент карты помещений.
логическое значение
исмилокатионенаблед ()
Получает состояние слоя моего местоположения.
логическое значение
истрафикенаблед ()
Проверяет, отображает ли карта данные о трафике.
пустота
moveCamera (обновление CameraUpdate )
Изменяет положение камеры в соответствии с инструкциями, определенными в обновлении.
пустота
сбросMinMaxZoomPreference ()
Удаляет любые ранее указанные верхние и нижние границы масштабирования.
пустота
setBuildingsEnabled (логическое значение включено)
Включает или выключает слой 3D-зданий.
пустота
setContentDescription (строковое описание)
Устанавливает contentDescription для карты.
логическое значение
setIndoorEnabled (логическое значение включено)
Устанавливает, следует ли включать карты помещений.
пустота
setInfoWindowAdapter (адаптер GoogleMap.InfoWindowAdapter )
Устанавливает пользовательский визуализатор для содержимого информационных окон.
пустота
setLatLngBoundsForCameraTarget (границы LatLngBounds )
Задает LatLngBounds для ограничения цели камеры, чтобы при прокрутке и панорамировании карты цель камеры не выходила за пределы этих границ.
пустота
setLocationSource (источник LocationSource )
Заменяет источник местоположения слоя моего местоположения.
логическое значение
setMapStyle (стиль MapStyleOptions )
Устанавливает стиль базовой карты.
пустота
setMapType (тип int)
Устанавливает тип фрагментов карты, которые должны отображаться.
пустота
setMaxZoomPreference (float maxZoomPreference)
Устанавливает предпочтительную верхнюю границу масштаба камеры.
пустота
setMinZoomPreference (плавающее minZoomPreference)
Устанавливает предпочтительную нижнюю границу масштаба камеры.
пустота
setMyLocationEnabled (логическое значение включено)
Включает или отключает слой моего местоположения.
пустота
пустота
setOnCameraIdleListener (прослушиватель GoogleMap.OnCameraIdleListener )
Устанавливает обратный вызов, который вызывается, когда движение камеры заканчивается.
пустота
setOnCameraMoveCanceledListener (прослушиватель GoogleMap.OnCameraMoveCanceledListener )
Устанавливает обратный вызов, который вызывается, когда движение камеры останавливается или прерывается новым типом анимации.
пустота
setOnCameraMoveListener (прослушиватель GoogleMap.OnCameraMoveListener )
Устанавливает обратный вызов, который вызывается неоднократно, пока камера находится в движении.
пустота
setOnCameraMoveStartedListener (прослушиватель GoogleMap.OnCameraMoveStartedListener )
Устанавливает обратный вызов, который вызывается, когда камера начинает двигаться или меняется причина движения камеры.
пустота
setOnCircleClickListener (прослушиватель GoogleMap.OnCircleClickListener )
Устанавливает обратный вызов, который вызывается при нажатии на кружок.
пустота
setOnGroundOverlayClickListener (прослушиватель GoogleMap.OnGroundOverlayClickListener )
Устанавливает обратный вызов, который вызывается при нажатии на наземное наложение.
пустота
setOnIndoorStateChangeListener (прослушиватель GoogleMap.OnIndoorStateChangeListener )
Устанавливает или очищает прослушиватель для событий в помещении.
пустота
setOnInfoWindowClickListener (прослушиватель GoogleMap.OnInfoWindowClickListener )
Устанавливает обратный вызов, который вызывается при нажатии окна информации о маркере.
пустота
setOnInfoWindowCloseListener (прослушиватель GoogleMap.OnInfoWindowCloseListener )
Устанавливает обратный вызов, который вызывается при закрытии информационного окна маркера.
пустота
setOnInfoWindowLongClickListener (прослушиватель GoogleMap.OnInfoWindowLongClickListener )
Устанавливает обратный вызов, который вызывается при длительном нажатии информационного окна маркера.
пустота
setOnMapClickListener (прослушиватель GoogleMap.OnMapClickListener )
Устанавливает обратный вызов, который вызывается при касании карты.
пустота
setOnMapLoadedCallback (обратный вызов GoogleMap.OnMapLoadedCallback )
Устанавливает обратный вызов, который вызывается после завершения рендеринга карты.
пустота
setOnMapLongClickListener (прослушиватель GoogleMap.OnMapLongClickListener )
Устанавливает обратный вызов, который вызывается при длительном нажатии на карту.
пустота
setOnMarkerClickListener (прослушиватель GoogleMap.OnMarkerClickListener )
Устанавливает обратный вызов, который вызывается при щелчке маркера.
пустота
setOnMarkerDragListener (прослушиватель GoogleMap.OnMarkerDragListener )
Устанавливает обратный вызов, который вызывается при перетаскивании маркера.
пустота
setOnMyLocationButtonClickListener (прослушиватель GoogleMap.OnMyLocationButtonClickListener )
Устанавливает обратный вызов, который вызывается при нажатии кнопки «Мое местоположение».
пустота
setOnMyLocationChangeListener (прослушиватель GoogleMap.OnMyLocationChangeListener )
Этот метод устарел. вместо этого используйте com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi обеспечивает улучшенное определение местоположения и энергопотребление и используется синей точкой «Мое местоположение». Пример кода см. MyLocationDemoActivity в папке примеров приложений или в Руководстве разработчика Location .
пустота
setOnMyLocationClickListener (прослушиватель GoogleMap.OnMyLocationClickListener )
Устанавливает обратный вызов, который вызывается при нажатии точки «Мое местоположение» (которая обозначает местоположение пользователя).
пустота
setOnPoiClickListener (прослушиватель GoogleMap.OnPoiClickListener )
Устанавливает прослушиватель, который будет запускаться при нажатии или касании POI.
пустота
setOnPolygonClickListener (прослушиватель GoogleMap.OnPolygonClickListener )
Устанавливает обратный вызов, который вызывается при щелчке по многоугольнику.
пустота
setOnPolylineClickListener (прослушиватель GoogleMap.OnPolylineClickListener )
Устанавливает обратный вызов, который вызывается при щелчке по ломаной линии.
пустота
setPadding (интервал слева, интервал сверху, интервал справа, интервал снизу)
Устанавливает отступы на карте.
пустота
setTrafficEnabled (логическое значение включено)
Включает или выключает слой трафика.
пустота
снимок (обратный вызов GoogleMap.SnapshotReadyCallback )
Делает снимок карты.
пустота
снимок ( обратный вызов GoogleMap.SnapshotReadyCallback , растровое изображение)
Делает снимок карты.
пустота
стопанимация ()
Останавливает анимацию камеры, если она выполняется.

Сводка унаследованных методов

Константы

публичный статический финал int MAP_TYPE_HYBRID

Спутниковые карты с прозрачным слоем основных улиц.

Постоянное значение: 4

общедоступный статический окончательный int MAP_TYPE_NONE

Нет плиток базовой карты.

Постоянное значение: 0

публичный статический финал int MAP_TYPE_NORMAL

Базовые карты.

Постоянное значение: 1

публичный статический финал int MAP_TYPE_SATELLITE

Спутниковые карты без надписей.

Постоянное значение: 2

публичный статический финал int MAP_TYPE_TERRAIN

Карты местности.

Постоянное значение: 3

Публичные методы

public Circle addCircle (параметры CircleOptions )

Добавьте круг на эту карту.

Параметры
параметры Объект параметров круга, определяющий способ отображения круга.
Возврат
  • Объект Circle , добавленный на карту.

public GroundOverlay addGroundOverlay (параметры GroundOverlayOptions )

Добавляет изображение на эту карту.

Параметры
параметры Объект параметров наложения земли, определяющий способ визуализации наложения. В параметрах должно быть указано изображение (AnchoredBitmap) и позиция.
Возврат
Броски
IllegalArgumentException если в параметрах не указано изображение или положение.

общедоступный маркер addMarker (параметры MarkerOptions )

Добавляет маркер на эту карту.

Значок маркера отображается на карте в месте Marker.position. При нажатии на маркер камера центрируется на маркере. Если Marker.title определен, на карте отображается информационное окно с названием и фрагментом маркера. Если маркер можно перетаскивать, длительное нажатие и последующее перетаскивание маркера перемещает его.

Параметры
параметры Объект параметров маркера, определяющий способ отображения маркера.
Возврат
  • Marker , добавленный на карту.

общедоступный Polygon addPolygon (параметры PolygonOptions )

Добавляет полигон на эту карту.

Параметры
параметры Объект параметров многоугольника, определяющий способ визуализации многоугольника.
Возврат
  • Объект Polygon , добавляемый на карту.

общедоступная полилиния addPolyline (параметры PolylineOptions )

Добавляет полилинию на эту карту.

Параметры
параметры Объект параметров полилинии, определяющий способ визуализации полилинии.
Возврат
  • Объект Polyline , добавленный на карту.

public TileOverlay addTileOverlay (параметры TileOverlayOptions )

Добавляет наложение плиток на эту карту. См. TileOverlay для получения дополнительной информации.

Обратите внимание, что в отличие от других наложений, если карта создается заново, наложения плиток не восстанавливаются автоматически, и их необходимо повторно добавлять вручную.

Параметры
параметры Объект параметров наложения плитки, определяющий способ отображения наложения. В параметрах должен быть указан TileProvider , в противном случае будет выдано исключение IllegalArgumentException .
Возврат
  • TileOverlay , добавленный на карту.
Броски
IllegalArgumentException если TileProvider не указан в параметрах.

public void animateCamera (обновление CameraUpdate )

Анимирует перемещение камеры из текущего положения в положение, определенное в обновлении. Во время анимации вызов getCameraPosition() возвращает промежуточное местоположение камеры.

См. CameraUpdateFactory для получения набора обновлений.

Параметры
обновлять Изменение, которое следует применить к камере.

public void animateCamera (обновление CameraUpdate , обратный вызов GoogleMap.CancelableCallback )

Анимирует перемещение камеры из текущей позиции в позицию, определенную в обновлении, и вызывает дополнительный обратный вызов по завершении. См. CameraUpdateFactory для получения набора обновлений.

Во время анимации вызов getCameraPosition() возвращает промежуточное местоположение камеры.

Параметры
обновлять Изменение, которое следует применить к камере.
перезвонить Обратный вызов, вызываемый из потока пользовательского интерфейса Android при остановке анимации. Если анимация завершается нормально, вызывается onFinish() ; в противном случае вызывается onCancel() . Не обновляйте и не анимируйте камеру изнутри onCancel() .

public void animateCamera (обновление CameraUpdate , inturationMs, обратный вызов GoogleMap.CancelableCallback )

Перемещает карту в соответствии с обновлением с анимацией в течение заданной продолжительности и вызывает дополнительный обратный вызов по завершении. См. CameraUpdateFactory для получения набора обновлений.

Если во время анимации вызывается getCameraPosition() , он возвращает текущее местоположение камеры в полете.

Параметры
обновлять
продолжительностьМс Длительность анимации в миллисекундах. Оно должно быть строго положительным, иначе будет выдано исключение IllegalArgumentException .
перезвонить Необязательный обратный вызов, который будет уведомлен из потока пользовательского интерфейса Android, когда анимация остановится. Если анимация останавливается из-за ее естественного завершения, обратный вызов будет уведомлен с помощью onFinish() . Если анимация останавливается из-за прерывания последующим движением камеры или жестом пользователя, будет вызван onCancel() . Обратный вызов не должен пытаться переместить или анимировать камеру в методе отмены. Если обратный вызов не требуется, оставьте значение null .

public void ясно ()

Удаляет с карты все маркеры, полилинии, многоугольники, наложения и т. д.

общедоступная CameraPosition getCameraPosition ()

Получает текущее положение камеры.

Возвращенное значение CameraPosition представляет собой снимок текущего положения и не обновляется автоматически при движении камеры.

Дополнительные сведения об изменении положения камеры см. в разделе Камера и вид .

Возврат
  • Текущее положение камеры.

public IndoorBuilding getFocusedBuilding ()

Получает здание, находящееся в фокусе.

Возврат
  • Текущее выделенное здание или null , если ни одно здание не выделено.

public int getMapType ()

Получает тип карты, отображаемой в данный момент. Возможные значения см. в MAP_TYPE_NORMAL , MAP_TYPE_SATELLITE , MAP_TYPE_TERRAIN .

Возврат
  • Тип карты.

общедоступное число с плавающей запятой getMaxZoomLevel ()

Возвращает максимальный уровень масштабирования для текущего положения камеры. При этом учитывается, какой тип карты используется в данный момент, например, спутник или местность могут иметь более низкий максимальный уровень масштабирования, чем фрагменты базовой карты.

Дополнительные сведения об изменении уровня масштабирования камеры см. в разделе Камера и вид .

Возврат
  • Максимальный уровень масштабирования, доступный в текущем положении камеры.

общедоступное число с плавающей запятой getMinZoomLevel ()

Возвращает минимальный уровень масштабирования. Это одинаково для каждой локации (в отличие от максимального уровня масштабирования), но может различаться в зависимости от устройства и размера карты.

Дополнительные сведения об изменении уровня масштабирования камеры см. в разделе Камера и вид .

Возврат
  • Минимальный доступный уровень масштабирования.

общедоступное местоположение getMyLocation ()

Этот метод устарел.
вместо этого используйте com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi обеспечивает улучшенное определение местоположения и энергопотребление и используется синей точкой «Мое местоположение». Пример кода см. MyLocationDemoActivity в папке примеров приложений или в Руководстве разработчика Location .

Возвращает текущее отображаемое местоположение пользователя или null , если данные о местоположении отсутствуют.

Возврат
Броски
IllegalStateException если слой моего местоположения не включен.

общественная проекция getProjection ()

Возвращает объект Projection , который можно использовать для преобразования координат экрана в координаты широты и долготы.

Возвращаемая Projection представляет собой снимок текущей проекции и не обновляется автоматически при движении камеры. Поскольку эта операция является дорогостоящей, проекцию следует получать только один раз на экран. Карты Google используют проекцию Меркатора для создания карт на основе географических данных и преобразования точек на карте в географические координаты.

Возврат
  • Projection карты в текущем состоянии.

общедоступные UiSettings getUiSettings ()

Получает настройки пользовательского интерфейса для карты.

Возврат
  • Настройки UiSettings для этой карты.

общедоступное логическое значение isBuildingsEnabled ()

Возвращает, включен ли слой 3D-зданий.

Возврат
  • true , если здания включены; false в противном случае.

общедоступное логическое значение isIndoorEnabled ()

Проверяет, включены ли в данный момент карты помещений.

Возврат
  • true , если карты помещений включены; false , если карты помещений отключены;

общедоступное логическое значение isMyLocationEnabled ()

Получает состояние слоя моего местоположения.

Возврат
  • true , если слой моего местоположения включен; false в противном случае.

общедоступное логическое значение isTrafficEnabled ()

Проверяет, отображает ли карта данные о трафике. Это зависит от наличия данных о трафике.

Возврат
  • true , если данные о трафике включены; false в противном случае.

public void moveCamera (обновление CameraUpdate )

Изменяет положение камеры в соответствии с инструкциями, определенными в обновлении. Перемещение происходит мгновенно, и последующий вызов getCameraPosition() отразит новую позицию. См. CameraUpdateFactory для получения набора обновлений.

Параметры
обновлять Изменение, которое следует применить к камере.

общественный недействительный сбросMinMaxZoomPreference ()

Удаляет любые ранее указанные верхние и нижние границы масштабирования.

public void setBuildingsEnabled (логическое значение включено)

Включает или выключает слой 3D-зданий.

Параметры
включено true , чтобы включить слой 3D-зданий; false , чтобы отключить 3D-здания.

public void setContentDescription (описание строки)

Устанавливает contentDescription для карты.

Это используется для предоставления устного описания карты в режиме специальных возможностей. Значение по умолчанию — «Карта Google».

Параметры
описание строка, которая будет использоваться в качестве описания.

общедоступное логическое значение setIndoorEnabled (логическое значение включено)

Устанавливает, следует ли включать карты помещений. В настоящее время карты помещений могут отображаться только на одной карте одновременно, и по умолчанию это первая карта, добавленная в ваше приложение. Чтобы включить карты помещений на другой карте, необходимо сначала отключить карты помещений на исходной карте. Если вы попытаетесь включить карты помещений, когда они включены на другой карте, ничего не произойдет и будет возвращено значение false . Если Indoor не включен для карты, все методы, относящиеся к внутреннему пространству, будут возвращать null или false .

Параметры
включено true , чтобы попытаться включить карты помещений; false , чтобы отключить карты помещений.
Возврат
  • можно ли было включить карты помещений.

public void setInfoWindowAdapter (адаптер GoogleMap.InfoWindowAdapter )

Устанавливает пользовательский визуализатор для содержимого информационных окон.

Как и прослушиватели событий карты, это состояние не сериализуется вместе с картой. Если карта создается заново (например, из-за изменения конфигурации), вы должны убедиться, что вы вызываете этот метод еще раз, чтобы сохранить настройку.

Параметры
адаптер Адаптер, который будет использоваться для содержимого информационного окна, или null , чтобы использовать отрисовку содержимого по умолчанию в информационных окнах.

public void setLatLngBoundsForCameraTarget (границы LatLngBounds )

Задает LatLngBounds для ограничения цели камеры, чтобы при прокрутке и панорамировании карты цель камеры не выходила за пределы этих границ.

Установите значение null, чтобы полностью очистить ограничивающую рамку. Новые границы заменяют любую ранее указанную ограничивающую рамку.

Когда LatLngBounds изменяется, SDK настраивает все последующие обновления камеры так, чтобы они, если возможно, учитывали эти границы. Обратите внимание, что существуют технические соображения, которые могут помешать SDK удерживать цель камеры строго в пределах границ. Например, ошибки округления с плавающей запятой или очень низкий уровень масштабирования.

Параметры
границы Границы, ограничивающие цель камеры.

public void setLocationSource (источник LocationSource )

Заменяет источник местоположения слоя моего местоположения.

Параметры
источник Источник местоположения для использования на слое моего местоположения. Установите значение null , чтобы использовать источник местоположения по умолчанию.

общедоступное логическое значение setMapStyle (стиль MapStyleOptions )

Устанавливает стиль базовой карты.

Используя параметры стиля, вы можете применять собственные стили к объектам и элементам на карте. См. MapStyleOptions для получения подробной информации об определении стиля.

Установите значение null, чтобы удалить все предыдущие пользовательские стили.

Параметры
стиль
Возврат
  • true , если стиль был успешно проанализирован; false если были обнаружены проблемы с MapStyleOptions , включая, например, неразбираемый стиль JSON, нераспознанный тип объекта, нераспознанный тип элемента или недопустимые ключи стилизатора. Если возвращаемое значение — false , текущий стиль остается неизменным.

public void setMapType (тип int)

Устанавливает тип фрагментов карты, которые должны отображаться. Допустимые значения:

Параметры
тип Тип отображаемой карты.

public void setMaxZoomPreference (float maxZoomPreference)

Устанавливает предпочтительную верхнюю границу масштаба камеры.

Когда максимальный масштаб изменяется, SDK настраивает все последующие обновления камеры так, чтобы он соответствовал этому максимальному значению, если это возможно. Обратите внимание, что существуют технические соображения, которые могут помешать SDK разрешить пользователям слишком глубоко увеличивать масштаб карты. Например, спутник или местность могут иметь меньший максимальный масштаб, чем фрагменты базовой карты.

SDK разрешает любые конфликты в минимальных и максимальных значениях. Если вы установите для минимального масштаба более высокий уровень масштабирования, чем текущий максимум, то SDK будет использовать новое минимальное значение как для минимума, так и для максимума. Если вы установите для максимального масштаба более низкий уровень масштабирования, чем минимальный, SDK будет использовать новое максимальное значение как для минимума, так и для максимума. Например: предположим, что текущий минимальный масштаб равен 8, а максимальный — 14. Затем вы устанавливаете максимальный масштаб равным 6. SDK использует минимальный масштаб 6 и максимальный масштаб 6.

Параметры
МаксZoomPreference Предпочтительная верхняя граница.

public void setMinZoomPreference (float minZoomPreference)

Устанавливает предпочтительную нижнюю границу масштаба камеры.

При изменении минимального масштаба SDK настраивает все последующие обновления камеры так, чтобы, если это возможно, соблюдать этот минимум. Обратите внимание, что существуют технические соображения, которые могут помешать SDK разрешить пользователям слишком низкое масштабирование.

SDK разрешает любые конфликты в минимальных и максимальных значениях. Если вы установите для минимального масштаба более высокий уровень масштабирования, чем текущий максимум, то SDK будет использовать новое минимальное значение как для минимума, так и для максимума. Если вы установите для максимального масштаба более низкий уровень масштабирования, чем минимальный, SDK будет использовать новое максимальное значение как для минимума, так и для максимума. Например: предположим, что текущий минимальный масштаб равен 8, а максимальный — 14. Затем вы устанавливаете минимальный масштаб 16. SDK использует минимальный масштаб 16 и максимальный масштаб 16.

Параметры
минZoomPreference Предпочтительная нижняя граница.

public void setMyLocationEnabled (логическое значение включено)

Включает или отключает слой моего местоположения.

Когда слой «Мое местоположение» включен и местоположение доступно, он постоянно отображает текущее местоположение и направление пользователя, а также отображает элементы пользовательского интерфейса, которые позволяют пользователю взаимодействовать со своим местоположением (например, включать или отключать отслеживание камерой своего местоположения). расположение и направление).

Чтобы использовать функцию уровня моего местоположения, вам необходимо запросить разрешение для ACCESS_COARSE_LOCATION или ACCESS_FINE_LOCATION , если вы не установили собственный источник местоположения.

Если вы установили собственный источник местоположения с помощью setLocationSource(LocationSource) SDK Google Maps для Android не будет проверять, предоставлены ли вышеуказанные разрешения. Однако вам все равно необходимо убедиться, что пользователь предоставил все разрешения, необходимые для вашего пользовательского источника местоположения.

Параметры
включено true , чтобы включить; false , чтобы отключить.
Броски
Исключение безопасности если разрешение на определение местоположения не предоставлено.

public void setOnCameraChangeListener (прослушиватель GoogleMap.OnCameraChangeListener )

Этот метод устарел.
Заменено на setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener) , setOnCameraMoveListener(GoogleMap.OnCameraMoveListener) , setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) и setOnCameraIdleListener(GoogleMap.OnCameraIdleListener) .

Устанавливает обратный вызов, который вызывается при смене камеры.

Параметры
слушатель Обратный вызов, который вызывается при смене камеры. Чтобы отключить обратный вызов, используйте null .

public void setOnCameraIdleListener (прослушиватель GoogleMap.OnCameraIdleListener )

Устанавливает обратный вызов, который вызывается, когда движение камеры заканчивается.

Параметры
слушатель Вызванный обратный вызов. Чтобы отключить обратный вызов, используйте null .

public void setOnCameraMoveCanceledListener (прослушиватель GoogleMap.OnCameraMoveCanceledListener )

Устанавливает обратный вызов, который вызывается, когда движение камеры останавливается или прерывается новым типом анимации.

Параметры
слушатель Вызванный обратный вызов. Чтобы отключить обратный вызов, используйте null . Не обновляйте и не анимируйте камеру изнутри onCameraMoveCanceled() .

public void setOnCameraMoveListener (прослушиватель GoogleMap.OnCameraMoveListener )

Устанавливает обратный вызов, который вызывается неоднократно, пока камера находится в движении. Обратный вызов может вызываться не чаще одного раза в каждом кадре и не должен выполнять дорогостоящие операции.

Параметры
слушатель Вызванный обратный вызов. Чтобы отключить обратный вызов, используйте null .

public void setOnCameraMoveStartedListener (прослушиватель GoogleMap.OnCameraMoveStartedListener )

Устанавливает обратный вызов, который вызывается, когда камера начинает двигаться или меняется причина движения камеры.

Параметры
слушатель Вызванный обратный вызов. Чтобы отключить обратный вызов, используйте null . Не обновляйте и не анимируйте камеру изнутри onCameraMoveStarted() .

public void setOnCircleClickListener (прослушиватель GoogleMap.OnCircleClickListener )

Устанавливает обратный вызов, который вызывается при нажатии на кружок.

Параметры
слушатель Обратный вызов, который вызывается при нажатии на кружок. Чтобы отключить обратный вызов, используйте null .

public void setOnGroundOverlayClickListener (прослушиватель GoogleMap.OnGroundOverlayClickListener )

Устанавливает обратный вызов, который вызывается при нажатии на наземное наложение.

Параметры
слушатель Обратный вызов, который вызывается при нажатии на наземное наложение. Чтобы отключить обратный вызов, используйте null .

public void setOnIndoorStateChangeListener (прослушиватель GoogleMap.OnIndoorStateChangeListener )

Устанавливает или очищает прослушиватель для событий в помещении. Может быть установлен только один прослушиватель. Установка нового прослушивателя приведет к удалению предыдущего прослушивателя.

Параметры
слушатель прослушиватель событий в помещении, если оно не равно нулю; в противном случае очищает слушателя

public void setOnInfoWindowClickListener (прослушиватель GoogleMap.OnInfoWindowClickListener )

Устанавливает обратный вызов, который вызывается при нажатии окна информации о маркере.

Параметры
слушатель Обратный вызов, который вызывается при нажатии окна информации о маркере. Чтобы отключить обратный вызов, используйте null .

public void setOnInfoWindowCloseListener (прослушиватель GoogleMap.OnInfoWindowCloseListener )

Устанавливает обратный вызов, который вызывается при закрытии информационного окна маркера.

Параметры
слушатель Обратный вызов, вызываемый при закрытии информационного окна маркера. Чтобы отключить обратный вызов, используйте null .

public void setOnInfoWindowLongClickListener (прослушиватель GoogleMap.OnInfoWindowLongClickListener )

Устанавливает обратный вызов, который вызывается при длительном нажатии информационного окна маркера.

Параметры
слушатель Обратный вызов, который вызывается при длительном нажатии информационного окна маркера. Чтобы отключить обратный вызов, используйте null .

public void setOnMapClickListener (прослушиватель GoogleMap.OnMapClickListener )

Устанавливает обратный вызов, который вызывается при касании карты.

Параметры
слушатель Обратный вызов, который вызывается при касании карты. Чтобы отключить обратный вызов, используйте null .

public void setOnMapLoadedCallback (обратный вызов GoogleMap.OnMapLoadedCallback )

Устанавливает обратный вызов, который вызывается после завершения рендеринга карты. Обратный вызов будет вызван только один раз.

Если этот метод вызывается, когда карта полностью отрисована, обратный вызов будет вызван немедленно. Это событие не сработает, если карта никогда не загружается из-за проблем с подключением или если карта постоянно меняется и никогда не завершает загрузку из-за того, что пользователь постоянно взаимодействует с картой.

Параметры
перезвонить Обратный вызов, вызываемый после завершения рендеринга карты. Чтобы отключить обратный вызов, используйте null .

public void setOnMapLongClickListener (прослушиватель GoogleMap.OnMapLongClickListener )

Устанавливает обратный вызов, который вызывается при длительном нажатии на карту.

Параметры
слушатель Обратный вызов, который вызывается при длительном нажатии на карту. Чтобы отключить обратный вызов, используйте null .

public void setOnMarkerClickListener (прослушиватель GoogleMap.OnMarkerClickListener )

Устанавливает обратный вызов, который вызывается при щелчке маркера.

Параметры
слушатель Обратный вызов, который вызывается при щелчке маркера. Чтобы отключить обратный вызов, используйте null .

public void setOnMarkerDragListener (прослушиватель GoogleMap.OnMarkerDragListener )

Устанавливает обратный вызов, который вызывается при перетаскивании маркера.

Параметры
слушатель Обратный вызов, вызываемый при событиях перетаскивания маркера. Чтобы отключить обратный вызов, используйте null .

public void setOnMyLocationButtonClickListener (прослушиватель GoogleMap.OnMyLocationButtonClickListener )

Устанавливает обратный вызов, который вызывается при нажатии кнопки «Мое местоположение».

Если listener возвращает true , событие используется, и поведение по умолчанию не произойдет. Если он возвращает false , произойдет поведение по умолчанию (т. е. камера перемещается так, что центрируется по местоположению пользователя).

Параметры
слушатель Обратный вызов, который вызывается при нажатии кнопки «Мое местоположение».

public void setOnMyLocationChangeListener (прослушиватель GoogleMap.OnMyLocationChangeListener )

Этот метод устарел.
вместо этого используйте com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi обеспечивает улучшенное определение местоположения и энергопотребление и используется синей точкой «Мое местоположение». Пример кода см. MyLocationDemoActivity в папке примеров приложений или в Руководстве разработчика Location .

Устанавливает обратный вызов, который вызывается, когда точка «Мое местоположение» меняет местоположение.

Параметры
слушатель Обратный вызов, который вызывается при изменении точки «Мое местоположение».

public void setOnMyLocationClickListener (прослушиватель GoogleMap.OnMyLocationClickListener )

Устанавливает обратный вызов, который вызывается при нажатии точки «Мое местоположение» (которая обозначает местоположение пользователя).

Параметры
слушатель Обратный вызов, который вызывается при нажатии точки «Мое местоположение».

public void setOnPoiClickListener (прослушиватель GoogleMap.OnPoiClickListener )

Устанавливает прослушиватель, который будет запускаться при нажатии или касании POI.

Передайте null , чтобы очистить прослушиватель.

Параметры
слушатель

public void setOnPolygonClickListener (прослушиватель GoogleMap.OnPolygonClickListener )

Устанавливает обратный вызов, который вызывается при щелчке по многоугольнику.

Параметры
слушатель Обратный вызов, вызываемый при щелчке по многоугольнику. Чтобы отключить обратный вызов, используйте null .

public void setOnPolylineClickListener (прослушиватель GoogleMap.OnPolylineClickListener )

Устанавливает обратный вызов, который вызывается при щелчке по ломаной линии.

Параметры
слушатель Обратный вызов, вызываемый при щелчке по ломаной линии. Чтобы отключить обратный вызов, используйте null .

public void setPadding (int слева, int сверху, int справа, int снизу)

Устанавливает отступы на карте.

Этот метод позволяет вам определить видимую область на карте, чтобы сообщить карте, что части карты по краям могут быть скрыты, путем установки отступов для каждого из четырех краев карты. Функции карты будут адаптированы к отступам. Например, элементы управления масштабированием, компас, уведомления об авторских правах и логотип Google будут перемещены в пределах определенной области, движения камеры будут осуществляться относительно центра видимой области и т. д.

Параметры
левый количество пикселей заполнения, которые будут добавлены слева от карты.
вершина количество пикселей заполнения, добавляемых в верхнюю часть карты.
верно количество пикселей заполнения, добавляемых справа от карты.
нижний количество пикселей заполнения, добавляемых внизу карты.

public void setTrafficEnabled (логическое значение включено)

Включает или выключает слой трафика.

Параметры
включено

общедоступный снимок void (обратный вызов GoogleMap.SnapshotReadyCallback )

Делает снимок карты.

Вы можете использовать снимки в своем приложении, когда использование интерактивной карты затруднено или невозможно. Например, изображения, созданные методом snapshot() могут использоваться для отображения миниатюры карты в вашем приложении, или снимок в центре уведомлений.

ПРИМЕЧАНИЕ. Изображения карты не должны передаваться на ваши серверы или иным образом использоваться за пределами приложения. Если вам нужно отправить карту другому приложению или пользователю, отправьте данные, которые позволяют им реконструировать карту для нового пользователя вместо снижения.

Параметры
перезвонить Метод обратного вызовов призван, когда сделан снимок.

Public void Snapshot ( GoogleMap.snapShotReadyCallback обратный вызов, растровый карта)

Делает снимок карты.

Этот метод эквивалентен snapshot(SnapshotReadyCallback) , но позволяет вам предоставить предварительно Bitmap . Если растровый карта не соответствует текущим размерам карты, будет выделен еще одна растровая карта, которая соответствует размерам карты.

Хотя в большинстве случаев объект, передаваемый методом обратного вызова, такой же, как и тот, который приведен в параметре этого метода, в некоторых случаях возвращаемый объект может быть разным (например, если размеры представления изменились к моменту снижения. взятый). Таким образом, вы должны доверять только содержанию растрового изображения, передаваемого методом обратного вызова.

Параметры
перезвонить Метод обратного вызовов призван, когда сделан снимок.
битовая карта Предварительно растровая карта. Если null , ведет себя как snapshot(SnapshotReadyCallback) .

Public void Stopanimation ()

Останавливает анимацию камеры, если он находится в процессе. Когда метод вызывается, камера перестает двигаться немедленно и остается в этом положении.