From a76193dbeeac7822f84fcf637b7037caefb34497 Mon Sep 17 00:00:00 2001
From: NativeScript-Bot <oss@nativescript.org>
Date: Fri, 14 Mar 2025 08:05:10 +0000
Subject: [PATCH 1/2] chore(update-plugins): Fri Mar 14 08:05:10 UTC 2025

---
 content/plugins/google-maps.md | 227 ++++++++++++++++-----------------
 1 file changed, 110 insertions(+), 117 deletions(-)

diff --git a/content/plugins/google-maps.md b/content/plugins/google-maps.md
index a2419018..c15c1be8 100644
--- a/content/plugins/google-maps.md
+++ b/content/plugins/google-maps.md
@@ -21,9 +21,6 @@ A plugin that allows you to use the [Maps SDK](https://developers.google.com/map
 
   - [Use @nativescript/google-maps with Angular](#use-nativescriptgoogle-maps-with-angular)
   - [Use @nativescript/google-maps with Vue](#use-nativescriptgoogle-maps-with-vue)
-  - [Control the camera](#control-the-camera)
-  - [Set the map type](#set-the-map-type)
-  - [Styling The Map](#styling-the-map)
 
 - [API](#api)
 
@@ -33,10 +30,14 @@ A plugin that allows you to use the [Maps SDK](https://developers.google.com/map
   - [GoogleMap Object](#googlemap-object)
     - [Properties](#properties)
     - [Methods](#methods)
-  - [Camera Position](#camera-position)
-  - [Projection](#projection)
-  - [UISettings](#uisettings-interface)
-  - [MapType enum](#maptype-enum)
+  - [Control the camera](#control-the-camera)
+    - [Camera Position](#camera-position)
+    - [Projection](#projection)
+  - [Map Customization](#map-customization)
+    - [UISettings](#uisettings-interface)
+    - [Setting the map type](#setting-the-map-type)
+    - [MapType enum](#maptype-enum)
+    - [Styling The Map](#styling-the-map)
   - [Markers](#markers)
     - [Adding Markers](#adding-markers)
     - [Marker Object](#marker-object)
@@ -192,17 +193,6 @@ import { GoogleMapsModule } from '@nativescript/google-maps/angular';
 
 2. Add [MapView](#mapview-class) to your markup.
 
-```html
-<MapView
-  (mapTap)="onTap($event)"
-  (mapLongPress)="onLongPress($event)"
-  (markerTap)="onMarkerTap($event)"
->
-</MapView>
-```
-
-3. Manage
-
 ```html
 <MapView
   (ready)="onReady($event)"
@@ -262,79 +252,6 @@ To handle the map features, see the [GoogleMap object](#googlemap-object) API.
 
 3. To manage the mapping features, listen to the map view's `ready` event and get the reference to the [GoogleMap](#googlemap-object) instance from the event data.
 
-### Control the camera
-
-To programmatically update the camera position, call the `animateCamera()` method on the `GoogleMap` object and pass it a [CameraUpdate](#cameraupdate-class) instance.
-
-```ts
-import { CameraUpdate } from '@nativescript/google-maps'
-
-googleMap.animateCamera(
-  CameraUpdate.fromCoordinate(
-    {
-      lat: -32.1234,
-      lng: 125.1234,
-    },
-    googleMap.cameraPosition.zoom,
-  ),
-)
-```
-
-### Set the map type
-
-To set the map type, set the `mapType` property to one of the [MapType](#maptype-enum) options.
-
-```ts
-import { GoogleMap, MapType } from '@nativescript/google-maps'
-
-map: GoogleMap
-map.mapType = MapType.Hybrid
-```
-
-See [CameraUpdate](#cameraupdate-class) for more methods you can call and pass to the `animateCamera()` method.
-
-### Styling the map
-
-You can style the map's items, such as roads, parks, businesses, and other points of interest.
-
-Styling works only on the [normal](#maptype-enum) map type. Styling does not affect indoor maps.
-
-To style your map, use a JSON file generated by the [Google Maps APIs Styling Wizard](https://mapstyle.withgoogle.com). In addition to changing the appearance of features, you can also hide features completely.
-
-```json
-[
-  {
-    "featureType": "all",
-    "stylers": [{ "color": "#C0C0C0" }]
-  },
-  {
-    "featureType": "road.arterial",
-    "elementType": "geometry",
-    "stylers": [{ "color": "#CCFFFF" }]
-  },
-  {
-    "featureType": "landscape",
-    "elementType": "labels",
-    "stylers": [{ "visibility": "off" }]
-  }
-]
-```
-
-To apply a custom style to your map you can set the `mapStyle` property on your `GoogleMap` object:
-
-```ts
-import { GoogleMap } from '@nativescript/google-maps'
-
-map: GoogleMap
-map.mapStyle = [
-  {
-    featureType: 'landscape',
-    elementType: 'labels',
-    stylers: [{ visibility: 'off' }],
-  },
-]
-```
-
 ## API
 
 ### MapView Class
@@ -343,13 +260,14 @@ map.mapStyle = [
 
 The following properties are available for adjusting the camera view on initialization:
 
-| Property  | Type     | Description                                                                                                     |
-| :-------- | :------- | :-------------------------------------------------------------------------------------------------------------- |
-| `lat`     | `number` | Latitude, in degrees                                                                                            |
-| `lng`     | `number` | Longitude, in degrees                                                                                           |
-| `zoom`    | `number` | Zoom level (described [here](https://developers.google.com/maps/documentation/javascript/tutorial#zoom-levels)) |
-| `bearing` | `number` | Bearing, in degrees                                                                                             |
-| `tilt`    | `number` | Tilt, in degrees                                                                                                |
+| Property                          | Type      | Description                                                                                                     |
+| :-------------------------------- | :-------- | :-------------------------------------------------------------------------------------------------------------- |
+| `lat`                             | `number`  | Latitude, in degrees                                                                                            |
+| `lng`                             | `number`  | Longitude, in degrees                                                                                           |
+| `zoom`                            | `number`  | Zoom level (described [here](https://developers.google.com/maps/documentation/javascript/tutorial#zoom-levels)) |
+| `bearing`                         | `number`  | Bearing, in degrees                                                                                             |
+| `tilt`                            | `number`  | Tilt, in degrees                                                                                                |
+| `preventDefaultMarkerTapBehavior` | `boolean` | Prevents the default marker event handling (panning/info windows) done by Google Maps                           |
 
 #### Events
 
@@ -384,7 +302,7 @@ The following properties are available for adjusting the camera view on initiali
 
 ### GoogleMap Object
 
-This class provides the mapping features and its instance is available from the [MapView](#mapview-class) instance's `ready` [event](#events):
+This class encapsulates the core, cross-platform mapping features. Its instance is made available when the [MapView](#mapview-class) fires the `ready` [event](#events), and this is where you'll perform the majority of your mapping tasks.
 
 ```ts
 function onReady(event: MapReadyEvent) {
@@ -434,6 +352,26 @@ function onReady(event: MapReadyEvent) {
 
 consult the appropriate SDK reference on how to use it: [iOS](https://developers.google.com/maps/documentation/ios-sdk/reference/interface_g_m_s_map_view) | [Android](https://developers.google.com/android/reference/com/google/android/gms/maps/GoogleMap)
 
+## Control the camera
+
+To programmatically update the camera position, call the `animateCamera()` method on the `GoogleMap` object and pass it a [CameraUpdate](#cameraupdate-class) instance.
+
+```ts
+import { CameraUpdate } from '@nativescript/google-maps'
+
+googleMap.animateCamera(
+  CameraUpdate.fromCoordinate(
+    {
+      lat: -32.1234,
+      lng: 125.1234,
+    },
+    googleMap.cameraPosition.zoom,
+  ),
+)
+```
+
+See [CameraUpdate](#cameraupdate-class) for more methods you can call and pass to the `animateCamera()` method.
+
 ### Camera Position
 
 The map's current camera position can be read from the `cameraPosition` property of a [GoogleMap](#googlemap-object) object.
@@ -472,6 +410,8 @@ A projection is used to translate between on screen location and geographic coor
 | `toScreenLocation(coordinate: Coordinate)`            | Returns a screen location that corresponds to a geographical coordinate.                                                   |
 | `containsCoordinate(coordinate: Coordinate)`          | Returns true if the coordinate is visible in the current viewport.                                                         |
 
+## Map Customization
+
 ### UISettings Interface
 
 You can adjust the maps UI settings from the `GoogleMap` object by configuring the following properties of the `uiSettings` property:
@@ -489,6 +429,17 @@ You can adjust the maps UI settings from the `GoogleMap` object by configuring t
 | `zoomControlsEnabled`                     | `boolean` | Whether map zoom controls are enabled or not                  |
 | `scrollGesturesEnabledDuringRotateOrZoom` | `boolean` | Whether scroll gestures are enabled while rotating or zooming |
 
+### Setting the map type
+
+To set the map type, set the `mapType` property to one of the [MapType](#maptype-enum) options.
+
+```ts
+import { GoogleMap, MapType } from '@nativescript/google-maps'
+
+map: GoogleMap
+map.mapType = MapType.Hybrid
+```
+
 ### MapType enum
 
 The Google Maps API offers the following five types of maps:
@@ -501,9 +452,51 @@ The Google Maps API offers the following five types of maps:
 | `Terrain`   | Topographic data. The map includes colors, contour lines and labels, and perspective shading. Some roads and labels are also visible.                  |
 | `Hybrid`    | Satellite photograph data with road maps added. Road and feature labels are also visible.                                                              |
 
-### Markers
+### Styling the map
+
+You can style the map's items, such as roads, parks, businesses, and other points of interest.
+
+Styling works only on the [normal](#maptype-enum) map type. Styling does not affect indoor maps.
+
+To style your map, use a JSON file generated by the [Google Maps APIs Styling Wizard](https://mapstyle.withgoogle.com). In addition to changing the appearance of features, you can also hide features completely.
+
+```json
+[
+  {
+    "featureType": "all",
+    "stylers": [{ "color": "#C0C0C0" }]
+  },
+  {
+    "featureType": "road.arterial",
+    "elementType": "geometry",
+    "stylers": [{ "color": "#CCFFFF" }]
+  },
+  {
+    "featureType": "landscape",
+    "elementType": "labels",
+    "stylers": [{ "visibility": "off" }]
+  }
+]
+```
+
+To apply a custom style to your map you can set the `mapStyle` property on your `GoogleMap` object:
+
+```ts
+import { GoogleMap } from '@nativescript/google-maps'
+
+map: GoogleMap
+map.mapStyle = [
+  {
+    featureType: 'landscape',
+    elementType: 'labels',
+    stylers: [{ visibility: 'off' }],
+  },
+]
+```
+
+## Markers
 
-#### Adding Markers
+### Adding Markers
 
 You can create markers using the [GoogleMap](#googlemap-object)'s object `addMarker` method by passing it a [MarkerOptions](#markeroptions) object.
 
@@ -542,14 +535,14 @@ It implements the [MarkerOptions] interface and has the following additional met
 | `userData`  | `any`                              | Additional information assigned to the marker                                                                                                                                                          |
 | `zIndex`    | `number`                           | Z-index of the marker                                                                                                                                                                                  |
 
-### Coordinate
+#### Coordinate
 
 | Property | Type     |
 | :------- | :------- |
 | `lat`    | `number` |
 | `lng`    | `number` |
 
-#### Removing Markers
+### Removing Markers
 
 To remove a marker from the map, call the `removeMarker()` method on the [GoogleMap](#googlemap-object) instance and pass it the marker to be removed.
 
@@ -559,7 +552,7 @@ function removeMarker(map: GoogleMap, marker: Marker) {
 }
 ```
 
-### Circles
+## Circles
 
 ### Adding Circles
 
@@ -586,7 +579,7 @@ function addCircle(map: GoogleMap, circleOptions: CircleOptions): Circle {
 | `zIndex`        | `number`                                |
 | `userData`      | `{ [key: string]: any }`                |
 
-#### Removing Circles
+### Removing Circles
 
 You can remove a circle using the [GoogleMap](#googlemap-object)'s `removeCircle()` method.
 
@@ -596,9 +589,9 @@ function removeCircle(map: GoogleMap, circle: Circle) {
 }
 ```
 
-### Polygons
+## Polygons
 
-#### Adding Polygons
+### Adding Polygons
 
 You can create polygons using the [GoogleMap](#googlemap-object)'s object `addPolygon()` method by passing in the specified [PolygonOptions](#polygonoptions).
 
@@ -608,7 +601,7 @@ function addPolygon(map: GoogleMap, polygonOptions: PolygonOptions): Polygon {
 }
 ```
 
-### PolygonOptions
+#### PolygonOptions
 
 | Property          | Type                                    |
 | :---------------- | :-------------------------------------- |
@@ -635,9 +628,9 @@ function removePolygon(map: GoogleMap, polygon: Polygon) {
 }
 ```
 
-### Polylines
+## Polylines
 
-##### Adding Polylines
+### Adding Polylines
 
 You can create Polylines using the [GoogleMap](#googlemap-object)'s object `addPolyline` function by passing it a [PolylineOptions](#polylineoptions) object.
 
@@ -667,7 +660,7 @@ function addPolyline(
 | `endCap`    | Cap & Partial\<NativeObject\>           |
 | `userData`  | `{ [key: string]: any }`                |
 
-#### Removing Polylines
+### Removing Polylines
 
 You can remove a Polyline using the [GoogleMap](#googlemap-object)'s `removePolyline` function, like so:
 
@@ -677,9 +670,9 @@ function removePolyline(map: GoogleMap, polyline: Polyline) {
 }
 ```
 
-### Ground Overlays
+## Ground Overlays
 
-##### Adding Ground Overlays
+### Adding Ground Overlays
 
 You can create Ground Overlays using the [GoogleMap](#googlemap-object)'s object `addGroundOverlay` function by passing in the specified [GroundOverlay Options](#groundoverlayoptions).
 
@@ -710,7 +703,7 @@ function addGroundOverlay(
 | `anchorU`      | `number`                  |
 | `anchorV`      | `number`                  |
 
-#### Removing Ground Overlays
+### Removing Ground Overlays
 
 You can remove a GroundOverlay using the [GoogleMap](#googlemap-object)'s `removeGroundOverlay` function, like so:
 
@@ -722,7 +715,7 @@ function removeGroundOverlay(map: GoogleMap, groundOverlay: GroundOverlay) {
 
 ## Tile Overlays
 
-#### Adding Tile Overlays
+### Adding Tile Overlays
 
 You can create Tile Overlays using the [GoogleMap](#googlemap-object)'s object `addTileOverlay` function by passing in the specified [TileOverlay Options](#tileoverlayoptions).
 
@@ -748,7 +741,7 @@ function addTileOverlay(
 
 Setting tile overlay options after the tile overlay has been added to the map can have no effect on the tile overlay. To update the tile overlay, you may need to call `clearTileCache()`.
 
-#### Removing Tile Overlays
+### Removing Tile Overlays
 
 You can remove a TileOverlay using the [GoogleMap](#googlemap-object)'s `removeTileOverlay` function, like so:
 
@@ -758,7 +751,7 @@ function removeTileOverlay(map: GoogleMap, tileOverlay: TileOverlay) {
 }
 ```
 
-#### Tile Providers
+## Tile Providers
 
 Tile providers are objects that provide tiles to be used in a Tile Overlay.
 

From 2c83411866d572f79106d8f0d64bf9f7e3e5acf8 Mon Sep 17 00:00:00 2001
From: Dylan Llewellyn <46717769+herefishyfish@users.noreply.github.com>
Date: Fri, 27 Feb 2026 14:17:20 +0800
Subject: [PATCH 2/2] chore: update Windows setup instructions for Node and JDK

---
 content/setup/windows.md | 41 ++++++++++++++++++++++++++++++++--------
 1 file changed, 33 insertions(+), 8 deletions(-)

diff --git a/content/setup/windows.md b/content/setup/windows.md
index e86e8c45..f3c7c997 100644
--- a/content/setup/windows.md
+++ b/content/setup/windows.md
@@ -4,6 +4,7 @@ prev: /setup
 next: /guide/creating-a-project
 contributors:
   - rigor789
+  - herefishyfish
 ---
 
 ## Setting up Windows for Android
@@ -18,10 +19,24 @@ Setting up the Android development environment can be daunting if you are new to
 
 ### Installing Node
 
-To install **Node** we recommend using a node version manager, such as [nvm-windows](https://github.com/coreybutler/nvm-windows), [nvs](https://github.com/jasongin/nvs) or any other node version manager you prefer. In these docs we will be using **nvm-windows**, but feel free to use a different node version manager.
+To install **Node** we recommend using a node version manager, such as [nvm-windows](https://github.com/coreybutler/nvm-windows), [nvs](https://github.com/jasongin/nvs) or any other node version manager you prefer. In these docs we will be using [nvm-windows](https://github.com/coreybutler/nvm-windows), but feel free to use a different node version manager.
 
-1. Follow the [install instructions in the nvm-windows repository](https://github.com/coreybutler/nvm-windows#installation--upgrades). We recommend using the installer, however if you have a more advanced understanding of your needs you may also go for the manual installation instead.
-2. Run and follow the `nvm-setup.exe` instructions.
+1. Install [nvm-windows](https://github.com/coreybutler/nvm-windows) using one of the following methods:
+   ::: code-group
+   
+   ```bash [Chocolatey]
+   choco install -y nvm
+   ```
+   
+   ```text [Installer Instructions]
+   https://github.com/coreybutler/nvm-windows#installation--upgrades
+   ```
+   
+   :::
+2. After installation, open a new Command Prompt and verify:
+   ```bash
+   nvm version
+   ```
 3. Once the installation is complete, open a new Command Prompt and verify you can run `nvm ls`.
 4. Install the latest Node release with:
    ```bash
@@ -46,7 +61,7 @@ If any of the above failed, we recommend checking out the [Microsoft Docs for Se
 To install a **JDK** (using the prebuilt OpenJDK binaries from [Adoptium](https://adoptium.net/)) open an Administrator Command Prompt (right click and select "Run as Administrator") and run the following command:
 
 ```bash
-choco install -y temurin17
+choco install -y temurin21
 ```
 
 Once installed, you might need to add it to your `Path`. First, check if you need to add it to your `Path` by opening a new Command Prompt and running the following:
@@ -60,10 +75,10 @@ If you see a version number printed, you may skip this step. Otherwise, you will
 1. Search for "**Edit the system environment variables**" in Windows Search and select
 2. Click on "**Environment variables...**" in the bottom corner
 3. Under the "**User variables for...**" select the **Path** variable and click **Edit...**
-4. Click **New** and add the **JDK binaries folder** path to the list.
-   The default location is
+4. Click **New** and add the **JDK `bin` folder path** to the list.
+   The **JDK** location may vary depending on the version you have installed.
    ```
-   C:\Program Files\Eclipse Adoptium\jdk-17.X.X\bin
+   C:\Program Files\Eclipse Adoptium\jdk-21.0.9.10\bin
    ```
 
 Additionally, some installations may require creating the `JAVA_HOME` environment variable manually:
@@ -74,7 +89,7 @@ Additionally, some installations may require creating the `JAVA_HOME` environmen
 4. Add the following variable. Ensure you're using the correct JDK path, without the \bin suffix. Example:
    ```
    VARIABLE_NAME: JAVA_HOME
-   VARIABLE_VALUE: C:\Program Files\Eclipse Adoptium\jdk-17.0.12.7-hotspot
+   VARIABLE_VALUE: C:\Program Files\Eclipse Adoptium\jdk-21.0.9.10-hotspot
    ```
 
 You may need to restart your terminal for changes to apply.
@@ -141,6 +156,16 @@ ns doctor android
 
 If you see **No issues were detected** then you have successfully set up your system.
 
+If you're using Chocolatey and prefer not to open a new terminal, you can refresh your environment variables in the current PowerShell session by running:
+
+```bash
+Import-Module "$env:ChocolateyInstall/helpers/chocolateyInstaller.psm1"
+Update-SessionEnvironment
+```
+
+After refreshing, run the `ns doctor` command again to confirm everything is working as expected.
+
+
 Lastly, you will also want to [set up an android device](/guide/running#enable-usb-debugging-on-android-devices) or [emulator](/guide/running#android-emulators).
 
 ::: warning Troubleshooting