FormBuilder form field for selecting a map location using Google Maps

Closes #6309

Author: BurntimeX

com.woltlab.wcf/templates/shared_googleMapsFormField.tpl

@@ -0,0 +1,19 @@
+{capture assign='googleMapsElementID'}{$field->getPrefixedId()}_map{/capture}
+{include file='shared_googleMapsElement' accessUserLocation=true googleMapsLat=$field->getLatitude() googleMapsLng=$field->getLongitude()}
+
+<input
+	type="text"
+	id="{$field->getPrefixedId()}"
+	name="{$field->getPrefixedId()}"
+	{if !$field->getFieldClasses()|empty} class="{implode from=$field->getFieldClasses() item='class' glue=' '}{$class}{/implode}"{/if}
+	value="{$field->getValue()}"
+	{if $field->isAutofocused()} autofocus{/if}
+	{if $field->isRequired()} required{/if}
+	{if $field->isImmutable()} disabled{/if}
+	{if $field->getPlaceholder() !== null} placeholder="{$field->getPlaceholder()}"{/if}
+	{if $field->getDocument()->isAjax()} data-dialog-submit-on-enter="true"{/if}
+	{foreach from=$field->getFieldAttributes() key='attributeName' item='attributeValue'} {$attributeName}="{$attributeValue}"{/foreach}
+	data-google-maps-geocoding="{$googleMapsElementID}"
+	data-google-maps-geocoding-store="{$field->getPrefixedId()}_"
+	data-google-maps-marker
+>

ts/WoltLabSuite/Core/Form/Builder/Field/GoogleMaps.ts

@@ -0,0 +1,24 @@
+/**
+ * Data handler for a Google Maps form builder field in an Ajax form.
+ *
+ * @author    Marcel Werk
+ * @copyright 2001-2025 WoltLab GmbH
+ * @license   GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @since     6.2
+ */
+import { FormBuilderData } from "../Data";
+import Value from "./Value";
+import type WoltlabCoreGoogleMapsElement from "WoltLabSuite/Core/Component/GoogleMaps/woltlab-core-google-maps";
+
+class GoogleMaps extends Value {
+  protected _getData(): FormBuilderData {
+    const map = document.getElementById(this._fieldId + "_map") as WoltlabCoreGoogleMapsElement;
+
+    return {
+      [this._fieldId]: (this._field as HTMLInputElement).value,
+      [this._fieldId + "_coordinates"]: `${map.lat},${map.lng}`,
+    };
+  }
+}
+
+export = GoogleMaps;

wcfsetup/install/files/js/WoltLabSuite/Core/Form/Builder/Field/GoogleMaps.js

@@ -0,0 +1,106 @@
+<?php
+
+namespace wcf\system\form\builder\field;
+
+use wcf\system\form\builder\data\processor\CustomFormDataProcessor;
+use wcf\system\form\builder\IFormDocument;
+
+/**
+ * Implementation of a form field for selecting map coordinates.
+ *
+ * @author      Marcel Werk
+ * @copyright   2001-2025 WoltLab GmbH
+ * @license     GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @since       6.2
+ */
+final class GoogleMapsFormField extends AbstractFormField implements
+    IAttributeFormField,
+    IAutoFocusFormField,
+    ICssClassFormField,
+    IImmutableFormField,
+    IPlaceholderFormField
+{
+    use TAttributeFormField;
+    use TAutoFocusFormField;
+    use TCssClassFormField;
+    use TImmutableFormField;
+    use TPlaceholderFormField;
+
+    /**
+     * @inheritDoc
+     */
+    protected $javaScriptDataHandlerModule = 'WoltLabSuite/Core/Form/Builder/Field/GoogleMaps';
+
+    /**
+     * @inheritDoc
+     */
+    protected $templateName = 'shared_googleMapsFormField';
+
+    private float $latitude = 0;
+    private float $longitude = 0;
+
+    public function __construct()
+    {
+        $this->addFieldClass('long');
+    }
+
+    #[\Override]
+    public function readValue()
+    {
+        if ($this->getDocument()->hasRequestData($this->getPrefixedId())) {
+            $this->value = $this->getDocument()->getRequestData($this->getPrefixedId());
+        }
+
+        if ($this->getDocument()->hasRequestData($this->getPrefixedId() . '_coordinates')) {
+            $coordinates = explode(',', $this->getDocument()->getRequestData(
+                $this->getPrefixedId() . '_coordinates'
+            ));
+            if (\count($coordinates) === 2) {
+                $this->latitude = \floatval($coordinates[0]);
+                $this->longitude = \floatval($coordinates[1]);
+            }
+        }
+
+        return $this;
+    }
+
+    #[\Override]
+    public function populate()
+    {
+        parent::populate();
+
+        $this->getDocument()->getDataHandler()->addProcessor(new CustomFormDataProcessor(
+            'coordinates',
+            function (IFormDocument $document, array $parameters) {
+                if ($this->getValue()) {
+                    $parameters[$this->getPrefixedId() . '_coordinates'] = [
+                        'latitude' => $this->getLatitude(),
+                        'longitude' => $this->getLongitude(),
+                    ];
+                }
+
+                return $parameters;
+            }
+        ));
+
+        return $this;
+    }
+
+    public function getLatitude(): float
+    {
+        return $this->latitude;
+    }
+
+    public function getLongitude(): float
+    {
+        return $this->longitude;
+    }
+
+    public function coordinates(float $latitude, float $longitude): static
+    {
+        $this->latitude = $latitude;
+        $this->longitude = $longitude;
+
+        return $this;
+    }
+}