GoogleMaps.xml

<?xml version="1.0" encoding="utf-8"?>
<widget id="com.mendix.widget.custom.GoogleMaps.GoogleMaps" needsEntityContext="true" offlineCapable="true" xmlns="http://www.mendix.com/widget/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mendix.com/widget/1.0/ ../xsd/widget.xsd">
    <name>Google Maps</name>
    <description>Show address on Google Maps</description>
    <icon>iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAHt0lEQVR42u1ZC2wUVRRFUH4SlYD4QSWRCIlBTRDQQED5mZ1pC7R0+6NbCpZKgIJYFAXFQtVoTUARCAShfAVMgf2hEMASQEtCCYkICAoBjFTKRwifmdnaPt8NtMycndmZZt8qS/qSlzSdO++ee+a8d+9926xpNI2m8Z8NN2MtJH/NK5JX/VTyKutdXmU3/7tS8qkBl1ddLPuV3OQdrMNdF7j0HXuAB/yx5FPO86BZpMkJ+cflU79PCIZevCuCd/lCo3ng1RCo/fSpdbJPWe3ezh6My8CLGGsu+9W5toHaK+JIQlB9Ov5k71PWmAVE20D2qV/Lfi0zIVjTn6QuBdQkyavNpPPA4p3quCJB8mvTwwNRr8o+7b3cctY60rt0SHL5HzBRwiF3OWt3xwcve0MvcbC1RvDKqYSg1sNxtjjMWrq8WimSQMqJB+nvQvkmBdhTYURtUbtJAS1d9ipjEnzKQAraZK2VoIJavlWevWODT/CqQ8KkH1AGGwNnXXje32my1y+4fFqG3pa2C0kfSCj7f0/3oqLmaWlpS/lU3G4308+kudtx3/oNXzSgvsaDv4LBg2JWGNJoQJUNNpuu1aVmeshf2CRMhI0wxoyA9PT0RDPn7rQ0Jm+oNgRDp3yDOoKsPQ+uCgK2ImGscSuoh/XPkws/R/84E2JGAGd4upnTkeOmhqU7qgV0QSwxCXQXn+u4Uv6GjHGZCLtdTCmf6J8PKwlEJIAwxpKA+WZOkyfPxrS3Vd8DmAQ5tf758G3sSSLMSI42qoEAr5asf5a0YK8dAV/GkoAyvTO+JTLo/9TIGAPUSuvfGeZjjxuDU68wxu4xlsxqibEUVor1qRWUUwGYMoGAslgSUAHOBpgToKzSNUNPAAGXcF2UOTVPt8+Pmr5AwD7ANAAwVcSSgDOggK43KzhlEGSAyobMUc7upUpQ/5wIq39OLTAP+A+r53JAyYNG6Vs4mLsCAWdiEjzJli8egj3Xhp7xYqcjFSr6bi4xwDrXv0uKwG6PcjpXw1f86/8JCrmevI11qn+X0qn+OZXUelyEAQgIwRYTMzIzMx+B4C/qHlOQPxoC8avTdAXQoyR9i9SHJe8UeqeBWJ+qGp5v0Z4zUeYlPTbCGosaoCcwfQjydaExmBtnSP63v6SWisHgpNshY/rUPoDnx82wERbYmj1jsf+TgICt+ueUu0m+esCJCyqKjTZaDy7pgybd3g2umAKSru7rt5U2XzWoRvaqky2wbQVsSbEgYDw4WYY2rnXnvjEAXld1Pb+S3YeXJXSyc7Imcbm/zXsA94hy9pBJWz3DQFLZ5Vq6XrPAtgwU8EYsCJgDBMxBm5R35nl4vc7gq01srC/KDFQRGirAj9az/Pz8thbYisOwiR7IMinC5JwYRaUqSPwi/3IPN8YXD36p4etvOM9Ss3JYdnb2Y47VKWrgPrObqZ48kivDwsj5nUJNP0qT+veHz1pu6xfPp1gQcMgpAAKMBx0VS3Y+6Lzgwf9i6CpXnWDu9AzwYTt/Fk4A5X3HANLSmVx6DE/6Y3wrtIrkg4ocLJhSJr7vzCfWKCJHbm5u68aCSBn/LgVRZwjIr1p2aomB0AtUJ0DnV+XUH07CLCB023obVbJHbyevPrU5/AcP1RX23k+sDV58UIucNnbCGkhveY3qUwQMu44LCfjVcFEyqagXD+wEBPYXZgWeKheGlcR+bST3Mxf8FjrtVDMyMvqLVEAG9txOzgmPx9NJ8ode5l++BpQQbAjeryZaXIFTUB9GyO/oeyPeVYhUQCEAmW8CoAWfdTq7OvqfvqbHAulmk6RUY73v2cbuv0X8m05vewgTqkUkASjF6Q66xQuGazGfshfrf7rcgKuykOwL9dIpbwz4XeH0vpIwiyRgAyyebbJNegABR/E3ASxvcVIahDVTwO/mCBizwf96kTXAHgAyEG34ofMqANiNNvSjqDUBajk1SrDmYPD7QwSMg8D/HpEEnITFu5sowA02G81LXXWRyRV5FZ0HJqT2AgIORMDYHfyfFEmACou3MyFgAoBdbPXjp37vU4ao/xEFR1ZW1jOw5u8RMLYDjKqoq7COAOIK2likrGK0MV51KStJ9pJflazsKI3CmucjYSVsevucnJwOIgh4HkAcsXC+AL7AlGh9FxQUtII1NRulHtXbE3YRRZAEIHY4yBQ0s2K0/dpEsN0BxZAkgoA8ABA3k7BHETrs7fics0RIcEkcE7BEBAHBOCYgKIKAg7BoH5N83d4iVYrwvxH8p0aw7QO2B0UAqIZFO5sclN2wYBHYhywH/69HwNoZbM9FG3xLamt1gdVSi2sCsh843ieQgHmw9lsR8LYgjNCSt2yMP5R2F3B+1gLkCLALCCSgCNaebfPRzurtKYbG+MNmpC84328BchxsgeUCCZgKGL6wIWA/XI31de7NvsPzWoCcAQR8JpCAsYCh1IYALx6a0ZwBUyCwhQ5vjKYJJGAkBLTJBvMiUT0JLVYCi820ALkaCBgtkIAhgGGnDeaZYF8SDQFrYbFch7/PywJvpHsDhkobzLlgvzYaAnbBYkMtCDgATUhvgQR0Awy/2WAeCvbl0RBwnBaJ83k8mv13Ld4JoBiiUcDpu0ABp6MhwAU/OsbVvIXd1axpNI2m0TRMxr9qAToDl7LqegAAAABJRU5ErkJggg==</icon>
    <properties>
        <!-- General -->
        <property key="dataSource" type="enumeration" defaultValue="context">
            <caption>Data source</caption>
            <category>General</category>
            <description>Source of the locations</description>
            <enumerationValues>
                <enumerationValue key="context">Context</enumerationValue>
                <enumerationValue key="XPath">Database</enumerationValue>
                <enumerationValue key="microflow">Microflow</enumerationValue>
                <enumerationValue key="static">Static</enumerationValue>
            </enumerationValues>
        </property>
        <property key="defaultCenterAddress" type="string" required="false">
            <caption>Default center address</caption>
            <category>General</category>
            <description>Map center location when no locations are available. The address will be used to lookup the location. No lookup is done when 'Default center latitude' and 'Default center longitude' contains a valid coordinate</description>
        </property>
        <property key="defaultCenterLatitude" type="string" required="false">
            <caption>Default center latitude</caption>
            <category>General</category>
            <description/>
        </property>
        <property key="defaultCenterLongitude" type="string" required="false">
            <caption>Default center longitude</caption>
            <category>General</category>
            <description/>
        </property>
        <property key="apiKey" type="string" required="false">
            <caption>API key</caption>
            <category>General</category>
            <description>The Google Maps Javascript API v3 does not require an API key to function correctly. However, Google strongly encourages you to load the Maps API using an APIs key.
WARNING: Address lookups are Google APIs calls which are limited in the free trier, it is recommended to use longitude latitude coordinates</description>
        </property>
        <!-- Data source -->
        <property key="addressAttributeContext" type="attribute" required="false">
            <caption>Address attribute </caption>
            <category>Context</category>
            <description>The address will be used to lookup the location. No lookup is done when 'Latitude attribute' and 'Longitude attribute' contains a valid coordinate</description>
            <attributeTypes>
                <attributeType name="String"/>
            </attributeTypes>
        </property>
        <property key="latitudeAttributeContext" type="attribute" required="false">
            <caption>Latitude attribute </caption>
            <category>Context</category>
            <description/>
            <attributeTypes>
                <attributeType name="Decimal"/>
            </attributeTypes>
        </property>
        <property key="longitudeAttributeContext" type="attribute" required="false">
            <caption>Longitude attribute </caption>
            <category>Context</category>
            <description/>
            <attributeTypes>
                <attributeType name="Decimal"/>
            </attributeTypes>
        </property>
        <property key="locationsEntity" type="entity" required="false" allowNonPersistableEntities="true">
            <caption>Locations entity</caption>
            <category>Database / Microflow</category>
            <description/>
        </property>
        <property key="entityConstraint" type="entityConstraint" entityProperty="locationsEntity" required="false">
            <caption>XPath constraint</caption>
            <category>Database / Microflow</category>
            <description>Constraint the 'Data source' 'Database' locations. It could be used with relation to '[%CurrentObject%]'</description>
        </property>
        <property key="dataSourceMicroflow" type="microflow" required="false">
            <caption>Microflow</caption>
            <category>Database / Microflow</category>
            <description>The 'Datasource' 'Microflow' that returns the list of locations</description>
            <returnType type="Object" entityProperty="locationsEntity" isList="true"/>
        </property>
        <property key="addressAttribute" type="attribute" entityProperty="locationsEntity" required="false">
            <caption>Address attribute</caption>
            <category>Database / Microflow</category>
            <description>The address will be used to lookup the location. No lookup is done when 'Latitude attribute' and 'Longitude attribute' contains a valid coordinate</description>
            <attributeTypes>
                <attributeType name="String"/>
            </attributeTypes>
        </property>
        <property key="latitudeAttribute" type="attribute" entityProperty="locationsEntity" required="false">
            <caption>Latitude attribute</caption>
            <category>Database / Microflow</category>
            <description/>
            <attributeTypes>
                <attributeType name="Decimal"/>
            </attributeTypes>
        </property>
        <property key="longitudeAttribute" type="attribute" entityProperty="locationsEntity" required="false">
            <caption>Longitude attribute  </caption>
            <category>Database / Microflow</category>
            <description/>
            <attributeTypes>
                <attributeType name="Decimal"/>
            </attributeTypes>
        </property>
        <property key="staticLocations" type="object" isList="true" required="false">
            <caption>Static locations</caption>
            <category>Static</category>
            <description/>
            <properties>
                <property key="address" type="string" required="false">
                    <caption>Address</caption>
                    <category>Location</category>
                    <description>The address will be used to lookup the location. No lookup is done when 'Latitude' and 'Longitude' contains a valid coordinate</description>
                </property>
                <property key="latitude" type="string" required="false">
                    <caption>Latitude</caption>
                    <category>Location</category>
                    <description/>
                </property>
                <property key="longitude" type="string" required="false">
                    <caption>Longitude</caption>
                    <category>Location</category>
                    <description/>
                </property>
                <property key="icon" type="image" required="false">
                    <caption>Marker image</caption>
                    <category>Location</category>
                    <description/>
                </property>
            </properties>
        </property>
        <!-- Appearance -->
        <property key="autoZoom" type="boolean" defaultValue="true">
            <caption>Auto zoom</caption>
            <category>Appearance</category>
            <description>Initial best fit zoom based the available makers. It will overwrite the specified 'Zoom level'</description>
        </property>
         <property key="zoomLevel" type="integer" defaultValue="10">
            <caption>Zoom level</caption>
            <category>Appearance</category>
            <description>1: World, 5: Landmass/continent, 10: City, 15: Streets, 20: Buildings</description>
        </property>
        <property key="widthUnit" type="enumeration" defaultValue="percentage">
            <caption>Width unit</caption>
            <category>Appearance</category>
            <description/>
            <enumerationValues>
                <enumerationValue key="percentage">Percentage</enumerationValue>
                <enumerationValue key="pixels">Pixels</enumerationValue>
            </enumerationValues>
        </property>
         <property key="width" type="integer" defaultValue="100">
            <caption>Map width</caption>
            <category>Appearance</category>
            <description/>
        </property>
        <property key="heightUnit" type="enumeration" defaultValue="percentageOfWidth">
            <caption>Height unit</caption>
            <category>Appearance</category>
            <description>'Percentage of width' is the aspect ratio, 'Pixels' is absolute. Warning: the 'Percentage of parent' only works when the parent has an absolute height, else it will not display</description>
            <enumerationValues>
                <enumerationValue key="percentageOfWidth">Percentage of width</enumerationValue>
                <enumerationValue key="pixels">Pixels</enumerationValue>
                <enumerationValue key="percentageOfParent">Percentage of parent</enumerationValue>
            </enumerationValues>
        </property>
        <property key="height" type="integer" defaultValue="75">
            <caption>Map height</caption>
            <category>Appearance</category>
            <description/>
        </property>
        <!-- Map controls -->
        <property key="optionDrag" type="boolean" defaultValue="true">
            <caption>Drag</caption>
            <category>Controls</category>
            <description>Enable moving center by dragging</description>
        </property>
        <property key="optionScroll" type="boolean" defaultValue="true">
            <caption>Scroll to zoom</caption>
            <category>Controls</category>
            <description>Enable zooming the map using the mouse scroll wheel</description>
        </property>
        <property key="optionMapControl" type="boolean" defaultValue="true">
            <caption>Map type</caption>
            <category>Controls</category>
            <description>Show map type (Map, Terrain, Satellite) control, positioned at top left corner on the map</description>
        </property>
        <property key="optionStreetView" type="boolean" defaultValue="true">
            <caption>Street view</caption>
            <category>Controls</category>
            <description>Show the Street View Pegman control</description>
        </property>
        <property key="optionZoomControl" type="boolean" defaultValue="true">
            <caption>Zoom</caption>
            <category>Controls</category>
            <description>Show zoom control [ + ] [ - ]</description>
        </property>
        <!-- Custom markers -->
        <property key="defaultMakerIcon" type="image" required="false">
            <caption>Default image</caption>
            <category>Markers</category>
            <description>Overwrite the default marker image of the widget</description>
        </property>
        <property key="markerImageAttributeContext" type="attribute" required="false">
            <caption>Image attribute (Context)</caption>
            <category>Markers</category>
            <description>For 'Datasource' 'Context'; Display custom markers based on the enumeration attribute value, as configured in the 'Images' list</description>
            <attributeTypes>
                <attributeType name="Enum"/>
            </attributeTypes>
        </property>
        <property key="markerImageAttribute" type="attribute" required="false" entityProperty="locationsEntity">
            <caption>Image attribute (Database / Microflow)</caption>
            <category>Markers</category>
            <description>For 'Datasource' 'Database' or 'Microflow'; Display custom markers based on the enumeration attribute value, as configured in the 'Images' list</description>
            <attributeTypes>
                <attributeType name="Enum"/>
            </attributeTypes>
        </property>
        <property key="markerImages" type="object" isList="true" required="false">
            <caption>Images</caption>
            <category>Markers</category>
            <description>Marker images for the configured 'Image attribute'. When the attribute value does not match a name, the marker will show the 'Default image' when available, or the standard marker</description>
            <properties>
                <property key="enumKey" type="string">
                    <caption>Enumeration name</caption>
                    <category>Appearance</category>
                    <description>The enumeration name as a string. (Empty enumeration names can not be used)</description>
                </property>
                <property key="enumImage" type="image">
                    <caption>Image</caption>
                    <category>Appearance</category>
                    <description/>
                </property>
            </properties>
        </property>
        <property key="markerLabelAttributeContext" type="attribute" required="false">
            <caption>Marker label (Context)</caption>
            <category>Markers</category>
            <description>For 'Datasource' 'Context'; Add a single character label inside the default marker to identify markers.</description>
            <attributeTypes>
                <attributeType name="String"/>
            </attributeTypes>
        </property>
        <property key="markerLabelAttribute" type="attribute" required="false" entityProperty="locationsEntity">
            <caption>Marker label (Database / Microflow)</caption>
            <category>Markers</category>
            <description>For 'Datasource' 'Database' or 'Microflow'; Add a single character label inside the default marker to identify markers.</description>
            <attributeTypes>
                <attributeType name="String"/>
            </attributeTypes>
        </property>
        <!-- Maps styles -->
        <property key="mapStyles" type="string" multiline="true" required="false">
            <caption>Map styles</caption>
            <category>Styles</category>
            <description>JSON array with Google Maps styles. See https://developers.google.com/maps/documentation/javascript/style-reference This can be generated with tools like https://mapstyle.withgoogle.com</description>
        </property>
    </properties>
</widget>