Situm SDK JS
    Preparing search index...

    Class CartographyApi

    Service that exposes the cartography domain.

    Represents the CartographyAPI class that provides methods for listing/creating/updating/deleting buildings, floors, geofences, POIs, paths, and POI categories.

    Index

    Constructors

    Methods

    • Creates a new floor

      Parameters

      • floorForm: FloorForm

        The floor information used to create it

      Returns Promise<Floor>

      Promise Promise that resolves to the created floor

    • Creates a new POI category.

      Parameters

      • poiCategoryForm: PoiCategoryForm

        The form data for the POI category to be created.

      Returns Promise<PoiCategory>

      Promise A promise that resolves to the created POI category.

    • Deletes a building given its id

      Parameters

      • buildingId: number

        The building id to delete

      Returns Promise<void>

      Promise A promise that resolves after deleting the building

    • Deletes a floor given its ID.

      Parameters

      • floorId: number

        The ID of the floor to delete

      Returns Promise<void>

      Promise Promise that resolves once the floor is deleted

    • Deletes a geofence by its ID.

      Parameters

      • geofenceId: string

        The ID of the geofence to delete.

      Returns Promise<void>

      Promise

    • Deletes the GeoJSON for a building.

      Parameters

      • buildingId: number

        The ID of the building

      Returns Promise<void>

      Resolves when deletion completes

    • Deletes a POI given its id.

      Parameters

      • poiId: number

        The POI id to delete.

      Returns Promise<void>

      Promise A Promise that resolves to void.

    • Deletes a POI category.

      Parameters

      • poiCategoryId: number

        The ID of the POI category to delete.

      Returns Promise<void>

      void A Promise that resolves when the deletion is successful.

    • Deletes an array of POIs in batch.

      Parameters

      • poiIds: number[]

        An array of POI ids to delete.

      Returns Promise<void[]>

      Promise<void[]> A Promise that resolves to void.

    • Returns the building information for a given ID.

      Parameters

      • buildingId: number

        The ID of the building to fetch.

      • Optionalparams: { view?: "compact" } = {}

        The parameters for the request.

        • Optionalview?: "compact"

          The view of the building.

      Returns Promise<Building>

      Promise - A promise that resolves to the building information.

    • Retrieves a list of buildings.

      Parameters

      • params: { view?: "compact" } = {}

        The parameters for the request.

        • Optionalview?: "compact"

          The view of the buildings.

      Returns Promise<readonly BuildingListElement[]>

      Promise<readonly BuildingListElement[]> - A promise that resolves to a list of building list elements.

    • Retrieves a floor by its ID.

      Parameters

      • floorId: number

        The ID of the floor to retrieve

      Returns Promise<Floor>

      Promise A promise that resolves to the retrieved floor

    • Returns a list of floors given a search criteria

      Parameters

      • params: FloorSearch = {}

        the list of parameters to filter the response

      Returns Promise<readonly Floor[]>

      Promise<readonly Floor[]> A promise that resolves to a list of floors

    • Retrieves a geofence by its ID.

      Parameters

      • geofenceId: string

        The ID of the geofence to retrieve.

      Returns Promise<Geofence>

      Promise - A Promise that resolves to the retrieved geofence.

    • Retrieves a paginated list of geofences based on the provided search parameters. If no organizationId is provided in the search parameters, it retrieves the organizationId from the JWT.

      Parameters

      • Optionalparams: GeofenceSearch = {}

        The search parameters for the geofences.

      Returns Promise<Paginated<Geofence>>

      Promise<Paginated> A promise that resolves to a paginated list of geofences.

    • Retrieves paths based on the provided parameters.

      Parameters

      • params: PathSearch = {}

        The search parameters for fetching paths.

      Returns Promise<Paths[]>

      Promise<Paths[]> - A Promise that resolves to an array of paths.

    • Retrieves a list of Poi objects based on the provided search parameters.

      Parameters

      • Optionalparams: PoiSearch = {}

        Optional search parameters to filter the Poi objects.

      Returns Promise<Poi[]>

      Promise<Poi[]> - A Promise that resolves to an array of Poi objects.

    • Updates a building given its id and the information to update

      Parameters

      • buildingId: number

        the building id to update

      • buildingForm: BuildingForm

        the building information to use

      Returns Promise<BuildingListElement>

      Promise A promise that resolves to the updated building

    • Updates a floor given its id and the information to update

      Parameters

      • floorId: number

        the floor id to update

      • floorForm: FloorForm

        the floor information to use

      Returns Promise<Floor>

      Promise Promise that resolves to the updated floor

    • Updates a geofence with the specified ID using the provided data.

      Parameters

      • geofenceId: string

        The ID of the geofence to update.

      • geofenceForm: Partial<GeofenceForm>

        The partial data to update the geofence with.

      Returns Promise<Geofence>

      Promise - A Promise that resolves to the updated geofence.

    • Updates a path given its id and the information to update

      Parameters

      • buildingId: number

        the building id to update paths from

      • pathForm: Paths

        the path information to use

      Returns Promise<Paths>

      Promise

    • Updates a POI (Point of Interest) with the given ID using the provided form data.

      Parameters

      • poiId: number

        The ID of the POI to update.

      • poiForm: PoiUpdateForm

        The form data containing the updated POI information.

      Returns Promise<Poi>

      Promise A Promise that resolves to the updated POI object.

    • Patches a POI category.

      Parameters

      • poiCategoryId: number

        The ID of the POI category to patch.

      • poiCategoryForm: Partial<PoiCategoryForm>

        The partial POI category form.

      Returns Promise<PoiCategory>

      Promise A promise that resolves to the updated POI category.

    • Updates an array of POIs in bulk.

      Parameters

      • poiUpdateForms: (PoiUpdateForm & { id: number })[]

        An array of POI update forms.

      Returns Promise<Poi[]>

      Promise<Poi[]> An array of Promises that resolves to an array of updated POIs or reject if the update has failed.