website·Indexed 36 days ago
https://developer.mappedin.comDeveloper documentation for Mappedin's indoor mapping ecosystem, featuring SDKs for JS, React, React Native, iOS, and Android (v6.0). Includes guides on 3D model implementation, Mappedin Venue Format (MVF v1 and v3), Blue Dot positioning, and specialized tools like the 3D Model Mapper and MapLibre Overlay for interactive 3D indoor maps and wayfinding.
@mappedin/mappedin-js and includes full TypeScript support.An MVF v3 package, when parsed with core extensions, produces an object containing geometry, floors, and a manifest. The geometry extension organizes data by floorId (matching IDs in floors.geojson), allowing for partial parsing and faster load times.
manifest.geojson): Contains the file structure of the MVF and global metadata (e.g., venue name, default map, language).floors.geojson): A FeatureCollection of all floors/levels, including names and elevations.floorId. These files contain all geometry (lines, polygons, points) for that floor. Geometry features may include an externalId (e.g., a room number).{
geometry: {
abcde1234: { // GeometryFeatureCollection },
abcde1235: { // GeometryFeatureCollection }
},
floors: { // FloorsFeatureCollection },
manifest: { // ManifestFeatureCollection }
}mapView.on with Events.Click. The callback provides a ClickPayload containing information about the clicked element, such as labels, spaces, paths, floors, and coordinates.mapView.on(Events.Click) { clickPayload ->
clickPayload ?: return@on
val labels = clickPayload.labels
if (!labels.isNullOrEmpty()) {
Log.i("Click", "Label Clicked: ${labels.first().text}")
}
val spaces = clickPayload.spaces
if (!spaces.isNullOrEmpty()) {
Log.i("Click", "Space Clicked: ${spaces.first().name}")
}
Log.i("Click", "Coordinate: ${clickPayload.coordinate.latitude}, ${clickPayload.coordinate.longitude}")
}mapView.mapData.getByType with the MapDataType.ANNOTATION type.mapView.mapData.getByType<Annotation>(com.mappedin.models.MapDataType.ANNOTATION) { r ->
r.onSuccess { annotations ->
// Log the name of each annotation
annotations.forEach { annotation ->
Log.d("Annotation", annotation.name)
}
}
}mapView.on() method with Events.click and Events.longPress to listen for user interactions. Both events provide a ClickPayload containing information about the clicked element, such as floors, labels, spaces, paths, and the specific geographic coordinates.// Set up click listener
mapView.on(Events.click) { [weak self] clickPayload in
guard let self = self, let click = clickPayload else { return }
self.handleClick(click, longPress: false)
}
// Set up long-press listener
mapView.on(Events.longPress) { [weak self] clickPayload in
guard let self = self, let click = clickPayload else { return }
self.handleClick(click, longPress: true)
}
private func handleClick(_ clickPayload: ClickPayload, longPress: Bool = false) {
// Extract data from ClickPayload
let title = clickPayload.floors?.first?.name ?? "Map"
let labelText = clickPayload.labels?.first?.text
let spaceName = clickPayload.spaces?.first?.name
let coordinate = clickPayload.coordinate
print("Clicked at: \(coordinate.latitude), \(coordinate.longitude)")
}mapData.getByType('enterprise-venue');useMapViewEvent hook to listen for click and long-press events. The event payload (Mappedin.TClickPayload) provides information about the clicked element, such as floors, labels, spaces, paths, and geographic coordinates.const handleEvent = (payload: Mappedin.TClickPayload, longPress: boolean) => {
const title = payload.floors?.[0]?.name ?? (longPress ? "Map Long Press" : "Map Click");
console.log(title);
if (longPress) {
console.log("Long press");
}
if (payload.labels && payload.labels.length > 0) {
console.log("Label Clicked: " + payload.labels[0].text);
}
if (payload.spaces && payload.spaces.length > 0) {
console.log("Space clicked: " + payload.spaces[0].name);
}
if (payload.paths && payload.paths.length > 0) {
console.log("You clicked a path.");
}
console.log("Latitude: " + payload.coordinate.latitude);
console.log("Longitude: " + payload.coordinate.longitude);
};
useMapViewEvent("click", (payload: Mappedin.TClickPayload) => {
handleEvent(payload, false);
});
useMapViewEvent("long-press", (payload: Mappedin.TClickPayload) => {
handleEvent(payload, true);
});DynamicFocus class acts as a MapView scene manager. It is designed to maintain the visibility of the outdoors while automatically fading building interiors in and out as the camera pans, creating a seamless transition between different map views.