# nicogis/streetview_arcgis-experience-builder architecture

> Architecture diagram of the GitHub repository nicogis/streetview_arcgis-experience-builder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nicogis/streetview_arcgis-experience-builder
- Repository: https://github.com/nicogis/streetview_arcgis-experience-builder

## Overview

This is an ArcGIS Experience Builder widget that turns a map click into a Google Street View location. The principal workflow is map selection, coordinate conversion, optional map centering and marker display, then either an embedded preview or a new-tab link. Builder settings configure the map and display options. The runtime excerpt supports map-event handling, marker and centering behavior, and rendering; README statements document URL generation and open modes where the relevant implementation lines were not excerpted.

Main entry points: [`src/runtime/widget.tsx`](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx) (Point capture), [`src/setting/setting.tsx`](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/setting/setting.tsx) (Widget settings), [`src/config.ts`](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/config.ts) (Widget configuration), [`src/runtime/style.ts`](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/style.ts) (Widget styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_builder["Builder settings"]
  node_settings["Widget settings<br/>[setting.tsx]"]
  node_config["Widget configuration<br/>[config.ts]"]
end

subgraph group_runtime["Map interaction"]
  node_runtime["Widget runtime<br/>[widget.tsx]"]
  node_map_binding["Map binding<br/>[widget.tsx]"]
  node_point_capture["Point capture<br/>[widget.tsx]"]
  node_coordinate_conversion["WGS84 conversion<br/>[widget.tsx]"]
  node_marker["Map marker<br/>[widget.tsx]"]
  node_map_centering["Map centering<br/>[widget.tsx]"]
end

subgraph group_presentation["Street View display"]
  node_streetview_url["Street View URL<br/>[widget.tsx]"]
  node_preview["Embedded preview<br/>[widget.tsx]"]
  node_external_link["New-tab link<br/>[widget.tsx]"]
end

subgraph group_shared["Shared presentation"]
  node_style["Widget styling<br/>[style.ts]"]
  node_runtime_locales["Runtime translations<br/>[default.ts]"]
  node_setting_locales["Settings translations<br/>[default.ts]"]
end

node_user(("Experience user"))
node_map["Experience map"]
node_google["Google Maps"]

node_user -->|"configures"| node_settings
node_settings -->|"updates"| node_config
node_config -->|"configures"| node_runtime
node_user -->|"clicks point"| node_map
node_map -->|"provides view"| node_map_binding
node_map_binding -->|"registers clicks"| node_point_capture
node_point_capture -->|"converts point"| node_coordinate_conversion
node_coordinate_conversion -->|"generates URL"| node_streetview_url
node_point_capture -->|"adds marker"| node_marker
node_point_capture -->|"centers map"| node_map_centering
node_streetview_url -->|"renders when configured"| node_preview
node_preview -->|"loads iframe"| node_google
node_streetview_url -->|"opens in tab"| node_external_link
node_runtime -->|"uses styles"| node_style
node_runtime -->|"reads messages"| node_runtime_locales
node_settings -->|"reads messages"| node_setting_locales

click node_settings "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/setting/setting.tsx"
click node_config "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/config.ts"
click node_runtime "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_map_binding "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_point_capture "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_coordinate_conversion "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_marker "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_map_centering "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_streetview_url "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_preview "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_external_link "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx"
click node_style "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/style.ts"
click node_runtime_locales "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/translations/default.ts"
click node_setting_locales "https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/setting/translations/default.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_settings,node_config,node_user toneBlue
class node_runtime,node_map_binding,node_point_capture,node_coordinate_conversion,node_marker,node_map_centering toneAmber
class node_streetview_url,node_preview,node_external_link toneMint
class node_style,node_runtime_locales,node_setting_locales toneRose
class node_map,node_google toneIndigo
```

## Components

### Builder settings

- [Widget settings](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/setting/setting.tsx): `src/setting/setting.tsx`
- [Widget configuration](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/config.ts): `src/config.ts`

### Map interaction

- [Widget runtime](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [Map binding](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [Point capture](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [WGS84 conversion](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [Map marker](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [Map centering](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`

### Street View display

- [Street View URL](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [Embedded preview](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`
- [New-tab link](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/widget.tsx): `src/runtime/widget.tsx`

### Shared presentation

- [Widget styling](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/style.ts): `src/runtime/style.ts`
- [Runtime translations](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/runtime/translations/default.ts): `src/runtime/translations/default.ts`
- [Settings translations](https://github.com/nicogis/streetview_arcgis-experience-builder/blob/master/src/setting/translations/default.ts): `src/setting/translations/default.ts`

### Other components

- **Experience user**
- **Experience map**
- **Google Maps**

## Connections

- Experience user → Widget settings: configures (evidence: `README.md`)
- Widget settings → Widget configuration: updates (evidence: `src/setting/setting.tsx`)
- Widget configuration → Widget runtime: configures (evidence: `README.md`)
- Experience user → Experience map: clicks point (evidence: `README.md`)
- Experience map → Map binding: provides view (evidence: `src/runtime/widget.tsx`)
- Map binding → Point capture: registers clicks (evidence: `src/runtime/widget.tsx`)
- Point capture → WGS84 conversion: converts point (evidence: `README.md`)
- WGS84 conversion → Street View URL: generates URL (evidence: `README.md`)
- Point capture → Map marker: adds marker (evidence: `src/runtime/widget.tsx`)
- Point capture → Map centering: centers map (evidence: `src/runtime/widget.tsx`)
- Street View URL → Embedded preview: renders when configured (evidence: `README.md`)
- Embedded preview → Google Maps: loads iframe (evidence: `README.md`)
- Street View URL → New-tab link: opens in tab (evidence: `README.md`)
- Widget runtime → Widget styling: uses styles (evidence: `src/runtime/widget.tsx`)
- Widget runtime → Runtime translations: reads messages (evidence: `src/runtime/widget.tsx`)
- Widget settings → Settings translations: reads messages (evidence: `src/setting/setting.tsx`)
