FGX.Map.TfgCustomMap: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
Строка 79: | Строка 79: | ||
<p>Настройки стиля Google карты.</p><div class="info">Актуально только для Андроид платформы.</div> | <p>Настройки стиля Google карты.</p><div class="info">Актуально только для Андроид платформы.</div> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>StandardLayerKinds: [[FGX.Map.Types.TfgMapStandardLayerKinds|TfgMapStandardLayerKinds]]</code> | ||
+ | <p>Настройки отображения стандартных слоев.</p> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>UserGestureKinds: [[FGX.Map.Types.TfgMapUserGestureKinds|TfgMapUserGestureKinds]]</code> | ||
+ | <p>Какие жесты разрешается совершать пользователю с картой.</p> | ||
|} | |} | ||
Строка 114: | Строка 120: | ||
| <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCircleTap: [[TfgMapCircleEvent]]</code> | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCircleTap: [[TfgMapCircleEvent]]</code> | ||
<p>Вызывается, когда пользователь нажимает на круг.</p> | <p>Вызывается, когда пользователь нажимает на круг.</p> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnInfoWindowTap: [[TfgMapMarkerEvent]]</code> | ||
+ | <p>Вызывается, когда пользователь нажимает на информационное окно, появляющееся рядом с маркером.</p> | ||
|} | |} | ||
Версия 22:01, 17 февраля 2021
Delphi
TfgCustomMap = class (TfgControl, IFGXMapObjectFactory)
TComponent -> TfgControl -> TfgCustomMap
Прямые наследники: TfgMap
Содержание
Описание
Контрол отображения нативной карты. Карта позволяет работать с графическими объектами на карте, маркерами, а так же обеспечивает базовые настройки работы с камерой и способов отображения карты.
Для того, чтобы начать использовать камеру на Android, необходимо получить API ключ от Google Maps. Это делается таким же способом, как и для FMX. Инструкция доступна здесь: http://docwiki.embarcadero.com/RADStudio/Rio/en/Configuring_Android_Applications_to_Use_Google_Maps
Google карта требует наличие следующих разрешений, которые нужно запросить при помощи сервиса TfgPermissionService в рантайме:
- android.permission.ACCESS_COARSE_LOCATION
- android.permission.ACCESS_FINE_LOCATION
Обратите внимание, что работа с маркерами доступна только после полной загрузки карты, а именно в событии OnMapReady или позже.
Конструкторы
constructor
|
Create(AOwner: TComponent)
Описание отсутствует. |
Методы
function
|
IsMapReadyToUse(): Boolean
Готова ли карта к работе. Карта инициализируется асинхронно, поэтому работа с картой доступна только после полной инициализации. Проверить готовность карты к работе можно через этот метод или в событии OnMapReady . |
procedure
|
ClearObjects()
Очистка всех объектов карты (маркеры, кривые, полигоны). |
function
|
CoordinateToPosition(const ACoordinate: TfgMapCoordinate): TPointF
Выполняет конвертацию указанных географических координат ACoodrinate в локальные координаты компонента. Метод должен вызывать только, когда карта проинициализирована и готова к использованию OnMapReady , IsMapReadyToUse .
|
function
|
PositionToCoordinate(const APosition: TPointF): TfgMapCoordinate
Выполняет конвертацию точки APosition в локальной системе координаты компонента в географических координаты. Метод должен вызывать только, когда карта проинициализирована и готова к использованию OnMapReady , IsMapReadyToUse .
|
Свойства
property
|
Markers: TfgMapMarkerList
Описание отсутствует. |
property
|
Polylines: TfgMapPolylineList
Описание отсутствует. |
property
|
Polygons: TfgMapPolygonList
Описание отсутствует. |
property
|
Circles: TfgMapCircleList
Описание отсутствует. |
property
|
CameraTarget: TfgMapCoordinate
Географические координаты относительно которой размещается камера. |
property
|
CameraZoom: Single
Зум камеры [1..20]:
|
property
|
CameraTilt: Single
Наклон камеры относительно перпендикуляра опущеного на землю и направления обзора с камеры в точку CameraTarget . |
property
|
CameraBearing: Single
Пеленг камеры в градусах по часовой стрелке относительно Севера. |
property
|
ControlsSettings: TfgMapControlSettings
Настройки отображения элементов управления картой. |
property
|
MapType: TfgMapType
Тип карты. |
property
|
GoogleMapStyle: TfgGoogleMapStyleOptions
Настройки стиля Google карты. Актуально только для Андроид платформы.
|
property
|
StandardLayerKinds: TfgMapStandardLayerKinds
Настройки отображения стандартных слоев. |
property
|
UserGestureKinds: TfgMapUserGestureKinds
Какие жесты разрешается совершать пользователю с картой. |
События
event
|
OnCameraChanging: TNotifyEvent
Срабатывает в процессе изменения параметров камеры. |
event
|
OnCameraChanged: TNotifyEvent
Срабатывает в конце процесса изменения параметров камеры. |
event
|
OnMapReady: TNotifyEvent
Вызывается, когда карта проинициализирована и готова к использованию. Именно в этот момент можно работать с объектами на карте. |
event
|
OnMarkerTap: TfgMapMarkerEvent
Вызывается, когда пользователь нажимает на маркер. |
event
|
OnMarkerDragStart: TfgMapMarkerEvent
Вызывается, когда маркер начинает перетаскиваться. |
event
|
OnMarkerDrag: TfgMapMarkerEvent
Вызывается повторно во время перетаскивания маркера. |
event
|
OnMarkerDragEnd: TfgMapMarkerEvent
Вызывается после перетаскивания маркера. |
event
|
OnPolygonTap: TfgMapPolygonEvent
Вызывается, когда пользователь нажимает на полигон. |
event
|
OnPolylineTap: TfgMapPolylineEvent
Вызывается, когда пользователь нажимает на кривую. |
event
|
OnCircleTap: TfgMapCircleEvent
Вызывается, когда пользователь нажимает на круг. |
event
|
OnInfoWindowTap: TfgMapMarkerEvent
Вызывается, когда пользователь нажимает на информационное окно, появляющееся рядом с маркером. |
Константы
const
|
DefaultMapType: TfgMapType
Описание отсутствует. |