Embedding Maps with Non-Clickable Marker Pop-ups
You can embed Concept3D maps within your applications, utilizing a simple query parameter to display non-clickable marker pop-ups. This feature is designed to support customers with advanced developer resources, including those developing custom mobile applications, by providing a foundation that can be built upon to create unique and tailored map displays.
Using the Query Parameter
To implement this new feature, add the &mbh (marker balloon hide) query parameter to your map URL. This parameter enables the map to suppress the default clickable marker pop-ups, allowing for a seamless integration into your custom interface.
Example URL with the new parameter:
https://map.concept3d.com/?id=[mapID]&mbh#!ct/[CategoryID]
For additional examples of parameters you can add to the URL, refer to our help documentation on Query Strings.
Interactive Messaging with Embedded Maps
When embedded within an iframe, if enabled, the map can communicate interactive events via messages through the postMessages API. These messages are crucial for the implementation of custom displays in response to user interactions with the map. The map sends a message to the parent window upon a marker being clicked and when a click occurs outside of a marker area on the map. This functionality allows clients to control the opening and closing of custom displays based on these interactions.
Note: to utilize these events a setting needs to be enabled by your client success manager.
Message structure when a marker is clicked:
json
{
"type": "c3dMarkerClick",
"id": "{markerId}"
}
Message structure for map clicks outside a marker:
json
{
"type": "c3dMapClick"
}
Leveraging Marker IDs
Clients are responsible for associating each marker ID with the corresponding location or content to be displayed. This association is essential for determining what content to present when a marker is clicked. Alternatively, clients can utilize our API to retrieve this information dynamically.
This new feature is part of our ongoing commitment to provide flexible and powerful tools for our customers. By enabling more advanced customizations, we aim to enhance the user experience and offer solutions that meet the unique needs of your applications and projects.
For further assistance or inquiries about integrating this new feature, please contact us at Support@concept3d.com or reach out to your dedicated Client Success Manager!