Create and Manage Places

Create places to define the storage and usage locations of your asset.

You can search for your places in the map view and zoom into the available assets. If an asset moves out of its permitted place, Oracle IoT Asset Monitoring Cloud Service can generate an incident that is reported to the operations manager.

For example, an electrocardiogram (EKG) machine is critical diagnostic tool used by a hospital cardiac unit. The cardiac unit wants to make sure the EKG machine does not move outside of their unit. When an assigned location is defined for the EKG machine, cardiac staff can be alerted when the machine moves outside of the unit.

Create outdoor places by drawing a geofence on the map. For indoor places, you can additionally make use of floor plans and altitude data.

Create a Place Using a Geofence

Create a place by drawing a geofence boundary on the map. Use the place to define the storage or usage location of your asset.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Places from the Design Center sub-menu.
  3. Click the Add icon (Add icon) to add a new place.
  4. Complete these fields in the Details area:
    • Name: Enter a name for the place.
    • Parent: If you have an existing place that will contain this new place, select the existing place as the parent.
    • Description: Enter an optional description for the place.
    • Tags: Enter optional tags for the place. Press the Enter key after entering each tag name.
    • Minimum Altitude (meters): To use an altitude or floor delimiter for the place, specify the minimum altitude in meters.
    • Maximum Altitude (meters): To use an altitude or floor delimiter for the place, specify the maximum altitude in meters.
  5. Navigate to the region that you wish to choose on the map.
    Click the Zoom in (Zoom in icon) icon to zoom in to a map location, or click the Zoom out (Zoom out icon) icon to zoom out from a map location. Click and hold the left mouse button to drag the map.

    You can also use the location search icon (Location search icon) to look for a city, state, zip code, or an existing place name.

  6. Click the Draw (Draw icon) icon to draw the geofence for the asset.
  7. Click the map area to start drawing a polygon.
  8. Drag the mouse to a new location on the map and click to complete the first side of your polygon.
  9. Repeat the preceding step to complete the other sides of the polygon. You can draw a polygon with three, four, or more sides.
  10. Click on the starting point to complete the polygon.
    Your geofence is now complete.

    Note:

    If you wish to redraw the polygon, click the polygon and select Delete Polygon.

  11. (Optional) Drag the white circles on the edges of the polygon to adjust or fine-tune your geofence.
  12. Click Save.
  13. Click Back to return to the Places list.

Create a Place with a Floor Plan

For indoor assets, you can choose to add your floor plans on top of the map before you create your geofence boundaries. You can also use the altitude parameter to distinguish between assets on various floors.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Places from the Design Center sub-menu.
  3. Click the Add icon (Add icon) to add a new place.
  4. Complete these fields in the Details area:
    • Name: Enter a name for the place.
    • Parent: If you have an existing place that will contain this new place, select the existing place as the parent.
    • Description: Enter an optional description for the place.
    • Tags: Enter optional tags for the place. Press the Enter key after entering each tag name.
    • Minimum Altitude (meters): To use an altitude or floor delimiter for the place, specify the minimum altitude in meters.
    • Maximum Altitude (meters): To use an altitude or floor delimiter for the place, specify the maximum altitude in meters.
  5. To add a new floor plan:
    1. Click Add Floor Plan.
    2. Browse to the location of the floor plan image and select the image file.
    3. Click Open, and then click Continue.
    4. Drag the two marker icons (Marker Icon) to two different locations on the plan and enter the respective Latitude and Longitude values.
    5. Click Show Floor Plan on Map to view the floor plan superimposed on the map.
    Alternatively, click Use Parent Floor Plan if you wish to use the floor plan of the parent place.
  6. To draw the geofence for the asset on the map:
    1. Navigate to the floor plan image on the map.
      Click the Zoom in (Zoom in icon) icon to zoom in to a map location, or click the Zoom out (Zoom out icon) icon to zoom out from a map location. Click and hold the left mouse button to move the map.
    2. Click the Draw (Draw icon) icon to draw the geofence in or around the floor plan on the map.
    3. Click the map area to start drawing a polygon.
    4. Drag the mouse to a new location on the map and click to complete the first side of your polygon.
    5. Repeat the preceding step to complete the other sides of the polygon. You can draw a polygon with three, four, or more sides.
    6. Click on the starting point to complete the polygon.
      Your geofence is now complete.

      Note:

      If you wish to redraw the polygon, click the polygon and select Delete Polygon.

    7. (Optional) Drag the white circles on the edges of the polygon to adjust or fine-tune your geofence.
  7. Click Save.
  8. Click Back to return to the Places list.

Edit a Place

Edit a place to edit, add, duplicate, or remove place settings including the place name, description, altitude minimum and maximums, floor plan graphics, or geo-boundaries.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Places from the Design Center sub-menu.
  3. Select a place in the Places list.
  4. Click the Edit (Edit icon) icon.
  5. Edit the Name, Description or Tags fields.
  6. Select one of these options to edit a geo-boundary:
    • Click Add Floor Plan to add a new floor plan.
    • Edit the Min and Max altitude numbers of the Plan Altitude Range to edit altitude settings.
    • Click the Edit (Edit icon) icon in the map to add an additional geo-boundary.
    • Click and drag a large circle to move a control point of an existing geo-boundary.
    • Click a small circle to add a new control point between two large circles in an existing geo-boundary.
  7. Click Save.

Delete a Place

Delete a place when it is no longer needed.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Places from the Design Center sub-menu.
  3. Select a place in the Places list.
  4. Click the Delete (Delete icon) icon.
  5. Click Yes.