Release notes July 2025

Learn about recent changes to the ArcGIS Urban API. The release date is July 24th, 2025.

What's new

• Added an OverviewVisualizationBranchId field to the Projects.attributes. Now you can define which scenario in a project is visible in the overview and other plans and projects as context.

• Field thresholdDiscreteInterval was added to object type ShadowcastParameter. See the shadow cast analysis documentation to learn more on how discrete shadows are being used.

Examples

The following section provides a few examples of how to use the new Urban API features added in the July 2025 release.

Mutating Scenario visible in overview

You can now define which branch (scenario) of a project is visible in the overview. The following example shows how you can set the OverviewVisualizationBranchId in the projects.attributes:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation SetOverviewBranch (
  $urbanDatabaseId: PortalItemId!
  $projectID: GlobalID!
  $overviewBranchID: GlobalID!
) {
  updateProjects(
    urbanDatabaseId: $urbanDatabaseId
    projects: [{
      attributes: {GlobalID: $projectID, OverviewVisualizationBranchId: $overviewBranchID }
    }]
  ) {
    attributes { GlobalID OverviewVisualizationBranchId }
  }
}

Querying Scenario visible in overview

This example returns the information for the branch (scenario) to be shown in the overview due to the filter: {overviewVisualization:true} filter. The GlobalID of the overview branch is also available via the OverviewVisualizationBranchId field in the ProjectAttributes object. The GlobalID of the overview branch is also available via the OverviewVisualizationBranchId field in the ProjectAttributes object.

1
2
3
4
5
6
7
fragment ProjectOverviewBranch on Project {
  attributes { OverviewVisualizationBranchId }

  branches(filter: { overviewVisualization: true }) {
    attributes { GlobalID }
  }
}

Schema changes

This section describes new features and changes made to the Urban API schema.

The following fields and inputs related to project scenarios (branches) were added to projects:

• Field OverviewVisualizationBranchId was added to the Projects.attributes

• Input field OverviewVisualizationBranchId of type GlobalID was added to input object type UpdateProjectAttributesInput

• Input field OverviewVisualizationBranchId of type GlobalID was added to input object type CreateProjectAttributesInput

The following fields and inputs related to the Shadowcast were added:

• Field thresholdDiscreteInterval was added to object type ShadowcastParameter

• Input field thresholdDiscreteInterval of type Float! was added to input object type ShadowcastParameterInput

Bug fixes and improvements

• In certain cases, some queries would treat null in returned values incorrectly, replacing them with default values. Null values are now handled consistently and returned when appropriate.

• If there are multiple projects in the same database (e.g. Projects in the 'UrbanDatabase') then the analysis query would always only return the analyses from the first project. This bug has been fixed by filtering for the parent UrbanEventID.

Deprecations

The following fields on Plans have been deprecated:

• criteria (Removal date: 2026-07-25). This field is no longer supported.

• criteriaMeta (Removal date: 2026-07-25). This field is no longer supported.

• suitabilityModels (Removal date: 2026-07-25). This field is no longer supported.

• suitabilityModelsMeta (Removal date: 2026-07-25). This field is no longer supported.

Breaking changes

The following previously deprecated fields have been removed.

• ModalSplit has been removed from Branch:

• Field ModalSplit (deprecated) was removed from object type BranchAttributes

  • Input field ModalSplit was removed from input object type CreateBranchAttributesInput
  • Input field ModalSplit was removed from input object type UpdateBranchAttributesInput
  • Type ModalSplit was removed
  • Type ModalSplitInput was removed