Planned Access Point

Location in GUI: Design » Network Hierarchy » Floor » Add Planned APs

Diagram

Classes

floors (catalyst_center.sites)

Name	Type	Constraint	Mandatory	Default Value
planned_access_points	List	[planned_access_points]	No

planned_access_points (catalyst_center.sites.floors)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
ap_type	String		Yes
position_x	Number		Yes
position_y	Number		Yes
position_z	Number		No
mac_address	String		No
radios	List	[radios]	Yes

radios (catalyst_center.sites.floors.planned_access_points)

Name	Type	Constraint	Mandatory	Default Value
band	Choice	2.4, 5, 6	Yes
channel	Integer		No
tx_power	Integer		No
antenna_name	String		No
antenna_azimuth	Integer		No
antenna_elevation	Integer		No

Planned Access Points are Day 0 design-time resources for RF planning on floor maps in Cisco Catalyst Center. No physical APs are needed in the inventory - planned APs are virtual markers that represent future AP placements. They are nested under Floors via the planned_access_points attribute.

Note: The ap_type must be a valid AP model supported by your Catalyst Center version. Use the /dna/intent/api/v1/maps/supported-access-points API to list supported models and their compatible antennas. The antenna_name in radios must match a valid antenna for the selected ap_type.

Examples

Example-1: Single planned AP with one 5 GHz radio on a floor for basic RF planning:

catalyst_center:
  sites:
    floors:
      - name: Ground Floor
        parent_name: Global/Americas/USA/California/Corporate Headquarters
        floor_number: 0
        height: 18
        length: 500
        width: 300
        rf_model: Cubes And Walled Offices
        planned_access_points:
          - name: AP-GF-001
            ap_type: AP9166I
            position_x: 50.0
            position_y: 30.0
            position_z: 3.0
            radios:
              - band: "5"
                channel: 36
                tx_power: 17
                antenna_name: Internal-CW9166I-x-5GHz
                antenna_azimuth: 0
                antenna_elevation: 0

Example-2: Multiple planned APs on a floor for comprehensive RF coverage planning with different positions and channels:

catalyst_center:
  sites:
    floors:
      - name: Second Floor
        parent_name: Global/EMEA/United Kingdom/London Office
        floor_number: 2
        height: 15
        length: 400
        width: 250
        rf_model: Drywall Office Only
        image_path: floor_plans/london_second_floor.png
        planned_access_points:
          - name: AP-2F-001
            ap_type: AP9166I
            position_x: 30.0
            position_y: 20.0
            position_z: 3.0
            radios:
              - band: "5"
                channel: 36
                tx_power: 17
                antenna_name: Internal-CW9166I-x-5GHz
                antenna_azimuth: 0
                antenna_elevation: 0
          - name: AP-2F-002
            ap_type: AP9166I
            position_x: 80.0
            position_y: 20.0
            position_z: 3.0
            radios:
              - band: "5"
                channel: 44
                tx_power: 17
                antenna_name: Internal-CW9166I-x-5GHz
                antenna_azimuth: 0
                antenna_elevation: 0
          - name: AP-2F-003
            ap_type: AP9166I
            position_x: 55.0
            position_y: 50.0
            position_z: 3.0
            radios:
              - band: "5"
                channel: 52
                tx_power: 17
                antenna_name: Internal-CW9166I-x-5GHz
                antenna_azimuth: 0
                antenna_elevation: 0

Example-3: Outdoor planned AP with tri-band radios (2.4/5/6 GHz) and external antenna:

catalyst_center:
  sites:
    floors:
      - name: Warehouse Floor
        parent_name: Global/Americas/USA/Texas/Distribution Center
        floor_number: 1
        height: 40
        length: 650
        width: 500
        rf_model: Outdoor Open Space
        planned_access_points:
          - name: AP-WH-001
            ap_type: CW9174E
            position_x: 100.0
            position_y: 80.0
            position_z: 10.0
            mac_address: "00:11:22:33:44:55"
            radios:
              - band: "2.4"
                channel: 6
                tx_power: 14
                antenna_name: C-ANT9103-2.4GHz
                antenna_azimuth: 45
                antenna_elevation: -9
              - band: "5"
                channel: 36
                tx_power: 20
                antenna_name: C-ANT9103-5GHz
                antenna_azimuth: 45
                antenna_elevation: -9
              - band: "6"
                channel: 5
                tx_power: 18
                antenna_name: 2_CW-ANT-T-O2-D8-Dual-6GHz
                antenna_azimuth: 45
                antenna_elevation: -9