Map View

Map View

Download PDF

Map View

Map View is a View that displays a map (with data obtained from the Google Maps). When focused, it will capture keypresses and touch gestures to move the map. This control helps with the accessibility of maps. It also lets you pin the location on the map. Users may explore and interact with maps by panning or zooming.


Configure.IT also lets you fetch the location of the User with the help of this control. The classes of the Maps library offer built-in downloading, rendering, and caching of Maps tiles, etc.

    Keywords:
  • map view in iOS
  • map view in Android
  • location selector
  • geo location
  • map vector
  • Google street View
  • map view icon
  • map view controller

Properties

  • CIT Custom Properties
    PARAMETER
    DESCRIPTION
    Key Name To Location Latitude

    Sets the web service key for latitude of annotation.

    Key Name To Location Longitude

    Sets the web service key for longitude of annotation.

    Key Name To Location Title

    Sets the web service key for title which will be displayed in callout.

    Key Name To Location Description

    Sets the web service key for description which will be displayed in callout.

    Annotation View Nib Name

    This property is for setting "Object ID" of view which has to be shown as annotation view (view that will be shown on tapping a pin on Map View) for Map View.

    Pin Color

    Used to set pin color of pin (ex:1,2,3). Specify image name to show image as pin.

    Location to display on load
    This property is for setting latitude and longitude string of the location to be displayed initially on map view. Value set in this property should be in format {latitude,longitude} e.g, "28.0000,72.0000".
    Zoom level on load

    Sets the level to which map will be zoomed on Load.

    Should Show All Annotations On Map Load

    This property enables display of all annotations on map i.e, map will be zoomed in such a way that all pins added on map will be shown.

    Show Detail Disclosure Button on Call Out

    This property is for enabling detail disclosure button on callout which appears when pin on map is tapped.

    Enable Google Map

    Enables Google Map and further helps in specifying Street view.

    Enable Street View

    This property specifies that street view of a location should be shown, if available. Works only if "Enable Google Map" property is enabled or "Enable Google Map" setting is enabled in "MAP" config under "Other Setting" tab and "Google Map API Key" is set in "MAP" configuration.

    Indoor Enabled

    This property specifies whether indoor maps should be shown, if available. Works only if "Enable Google Map" property is enabled or "Enable Google Map" setting is enabled in "MAP" config under "Other Setting" tab and "Google Map API Key" is set in "MAP" configuration.

    Traffic Enabled

    This property is for enabling drawing of traffic data on map, if available. This is subject to the availability of traffic data. Works only if "Enable Google Map" property is enabled or "Enable Google Map" setting is enabled in "MAP" config under "Other Setting" tab and "Google Map API Key" is set in "MAP" configuration.

    Direction Path Color

    This property is for setting color for direction paths shown on Map View control. Directions can be added using "Show Directions" action.

    Map View Data File

    This property is for setting JSON file from which map data has to be taken.

  • Display
    PARAMETER
    DESCRIPTION
    Map Type

    The type of data displayed by the Map View.

    Shows User Location

    A Boolean value indicating whether the map may display the user location.

    Zoom Enabled

    A Boolean value that determines whether the user may use pinch gestures to zoom in and out of the map.

    Scroll Enabled

    A Boolean value that determines whether the user may scroll around the map.

    Rotation Enabled

    A Boolean value indicating whether the map camera’s heading information is used.

    Pitch Enabled

    A Boolean value indicating whether the map camera’s pitch information is used.

    User Interaction Enabled

    Enables the Interaction with user, i.e. control responds when user taps on it.

    Alpha

    Used to set the transparency to the Map View which ranges from 0 to 1.

    Background Color

    Used to set the background color to the Map View.

  • Custom Border
    PARAMETER
    DESCRIPTION
    Border Width

    Sets border width for a Map View.

    Border Corner Radius

    Sets radius with which control's rounded corners should be drawn. Setting this property will enable control appear with rounded corners.

    Border Color

    Sets the border color for a control. Works only if "Border Width" property is set to a value more than 0. Default would be black color.

    Dash Width For Dashed Border

    Sets width of each dash in dashed border pattern for a control.

    Space Between Dashes For Dashed Border

    Helps set the spacing between Dashes for Dashed Border.

    Transform Angle

    Sets angle in degrees to which control in its normal state has to be rotated. Possible values for this property are -360 to 360.

  • Object
    PARAMETER
    DESCRIPTION
    Xpos

    Sets the X position of the Map View.

    YPos

    Sets the Y position of the Map View.

    Width

    Sets the width of the Map View.

    Height

    Sets the height of the Map View.

    Object ID

    Sets unique identifier for the control. Control can be referenced with the name, set in this property for configuration.

    Object Parent ID

    Sets "Object ID" of View which contains this control or can serve as parent.

    Key Name To Data

    Sets the local JSON file name from which Map View's data has to be loaded.

    Key To DataSource

    Sets “key name to datasource” for a particular part of datasource.

    Map Function

    This property specifies the function that the map should perform i.e, address locator, default map that shows pins, global location search or local search.

  • Vertical
    PARAMETER
    DESCRIPTION
    Vertical Group

    Group of vertical android default properties.

    Reference Type

    These are the android default properties to set selected view with respect of other view.

    Reference Value

    Reference object that is used for positioning selected object

    Offset Type

    marginTop : Specifies extra space on the top side of this view. This space is outside this view's bounds.
    marginBottom : Specifies extra space on the bottom side of this view. This space is outside this view's bounds.

    Offset Value

    Value define the extra space value in pixel.

    Center Vertical

    This property centers the child vertically with respect to the bounds of its parent view.

    Apply Vertical Custom Properties

    If any of the vertical layout setting parameter(s) are selected then this value is selected to indicate user applied vertical custom layout setting parameter(s)

  • Horizontal
    PARAMETER
    DESCRIPTION
    Horizontal Group

    Group of horizontal android default properties.

    Reference Type

    Reference type is the the default property to set selected view with respect to other view.

    Reference Value

    Reference object that is used for positioning selected object.

    Offset Type

    marginLeft : Specifies extra space on the left side of this view. This space is outside this view's bounds.
    marginRight : Specifies extra space on the right side of this view. This space is outside this view's bounds.

    Offset Value

    Offset Value defines the extra space value in the pixel.

    Center Horizontal

    This property centers the child horizontally with respect to the bounds of its parent view.

    Apply Horizontal Custom Properties

    If any of the horizontal layout setting parameter(s) are selected then this value is selected to indicate user applied horizontal custom layout setting parameter(s).

  • Layout Setting
    PARAMETER
    DESCRIPTION
    Layout Height

    Sets the height of the view
    match_parent/fill_parent : Takes the height as its parent view
    wrap_content : Takes the height as its content’s height

    Default Min Height

    The height of the view cannot be less than the given value.
    If user select “Default Min Height” then android default value is taken otherwise it takes 0dp.

    Default Min Width

    The width of the view cannot be less than the given value.
    If user select “Default Min Width” then android default value is taken otherwise it takes 0dp.

    Center In Parent

    This property centers the child vertically with respect to the bounds of its parent view.

    Layout Width

    Sets the width of the view
    match_parent/fill_parent : Takes the width as its parent view
    wrap_content : Takes the width as its content’s width

    Vertical

    Group of vertical android default properties.

    Left

    The padding is expressed in pixels for the left, top, right and bottom parts of the view. Padding can be used to offset the content of the view by a specific amount of pixels.


    For instance, a Left value of 2 will push the view's content by 2 pixels to the right of the left edge.

    Horizontal

    Group of horizontal android default properties.

    Top

    For instance, a Top value of 2 will push the view's content by 2 pixels to the bottom of the top edge.

    Right

    For instance, a Right value of 2 will push the view's content by 2 pixels to the left of the right edge.

    Apply Custom Properties

    If any of the layout setting parameter(s) are selected then this value is selected to indicate user applied custom layout setting parameter(s).

    Bottom

    For instance, a Bottom value of 2 will push the view's content by 2 pixels to the top of the bottom edge.

  • Display/AdvanceText
    PARAMETER
    DESCRIPTION
    Hide

    Hiding an element can be done by checking ‘Hide’. This property lets you hide the control.


    Advance - Sets auto resizing with respect to superview, for Map View.

Actions

  • Load

    This event is triggered on load of Map View. Hence, any actions you want to perform when Map View loads like API Call to load data to be shown on Map View can be configured in "LOAD" event listed under ”ACTION(S) tab of the Map View control.

  • Detail Disclosure Tapped

    This event is triggered when user taps detail disclosure button on Map View control call out (Detail disclosure button appears on Map View call out if you enable "Show Detail Disclosure Button On Call Out"). Hence, any actions you want to perform on detail disclosure button click can be configured in "Detail Disclosure Tapped" event listed in ”ACTION(S)” tab of Map View control.

  • Pin Dragging Ended

    This event is triggered when user drags and drops a draggable pin on Map View control. Hence, any actions you want perform on pin drop, can be configured in “Pin Dragging Ended” event listed in ”ACTION(S)” tab of the map view control.

  • Google Places Address Selected

    This event is triggered when an address from Google places list is selected during global location search.(‘Map Function’ property is set to ‘Global Location Search’)

  • Pin Tapped

    This event is triggered when pin on a map is tapped

  • Alert Button Click

    This event is triggered when user taps a button on alert view, which was shown using “Show Alert” action, so any actions you want perform when alert button button is tapped can be configured in “Alert Button Click” event listed in ”ACTION(S)” tab of the control on which you have configured “Show Alert” action or Under Data source events of "Data sources" tab (if alert was shown on using “Show Alert” action configured in "Datasource Loaded" event of a data source in "Data Sources" list, you can configure actions of alert button click in "Alert Button Click" listed under data source events). “seletedButtonIndex” and "selectedButtonTitle" are the response parameters which indicate which button is tapped by user. Add condition for checking value of “seletedButtonIndex” or "selectedButtonTitle" response parameter value in order to configure actions for each button of alert view separately. You can access user input in alert view text fields using "alert_text_1" and "alert_text_2" response parameters in case of alert type is "SecureTextInput", "PlainTextInput" or "LoginAndPasswordInput"

    Following are the response parameters for this event :-

    1) selectedButtonIndex :- Index of the tapped button

    2) selectedButtonTitle :- Title of the tapped button

    3) alert_text_1 :- Text entered by user in text field one. If alert type is
    "SecureTextInput", "PlainTextInput" or "LoginAndPasswordInput"

    4) alert_text_2 :- Text entered by user in text field two(password). If alert type is
    "LoginAndPasswordInput"

  • Map Scroll End

    This event is triggered when user will end map scroll

Remarks

  • Custom Annotation

    Configure.IT provides you with feature of showing a custom view designed by you to be shown as callout when user taps pin on map instead of default callout bubble. You can add this feature by adding ‘Map Annotation View’ control to Map View control and design the Map Annotation View as you desire. You can also use multiple annotation view with single map control.

  • Global Address Search

    This lets you make your map function work like global address search engine. All you need to do is - set ‘Map Function’ property to ‘Global Location Search’. A search bar will be added to your map (you can also add an external search bar and set its Object Parent ID property to Map View control), where user can type a location name to get list of locations matching that query and can select a location from that list. When user selects a location from search results, pin gets added on map at that particular location.

  • Address Locator

    Map can be used as location reverse geocoder or location selector. You can enable this feature by setting ‘Map Function’ property to ‘Address Locator’. A pin will be added at user location initially.
    User can drag that pin and drop it at desired location on map and that location details will be fetched and stored in session with following keys :-
    -> search_location_lat
    -> search_location_lon
    -> search_postal_code
    -> search_location_country
    -> search_location_state
    -> search_address

  • User Location

    User current location indicator can be shown on map by enabling ‘Shows User Location’ property.