> For the complete documentation index, see [llms.txt](https://docs.ninox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ninox.com/builder-hub/de/visualize-and-organize-your-data/create-and-customize-pages/map-component.md).

# Karten-Komponente

Nutze eine **Karten-Komponente** auf einer Seite, um Datensätze mit Standortdaten anzuzeigen. Sie eignet sich zum Beispiel für Kundenbesuche, Lieferungen, Einsatzgebiete, Projekte und Standortinformationen.

Bevor du die Komponente hinzufügst, stelle sicher, dass die Tabelle Folgendes enthält:

* ein Standortfeld mit gültigen Werten
* eindeutige Datensatznamen für gut erkennbare Marker
* Felder zum Filtern relevanter Datensätze

## Karten-Komponente hinzufügen

{% stepper %}
{% step %}

#### Tab **Add** öffnen

Öffne im **Einstellungsbereich** **Add**.
{% endstep %}

{% step %}

#### Karte hinzufügen

Ziehe unter **Ansichten** **Karte** an die gewünschte Stelle auf der Seite.
{% endstep %}

{% step %}

#### Karte konfigurieren

Wähle in **Settings** die **Tabelle**. Wähle das **Standortfeld** für die Markerposition und das **Farbfeld** für dynamische Markerfarben.
{% endstep %}

{% step %}

#### Marker prüfen

Prüfe die erwarteten Datensätze an den richtigen Positionen. Ziehe die Komponente, um sie zu verschieben. Nutze die Anfasser, um ihre Größe anzupassen.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Um eine Komponente zu entfernen, wähle sie aus und klicke im blauen Menü darüber auf <i class="fa-trash-can">:trash-can:</i> **Komponente löschen**.
{% endhint %}

## Einstellungen der Karten-Komponente

In **Einstellungen** legst du die grundlegenden Details fest:

* **Bezeichnung** zeigt den Titel der Komponente.
* **Interner Name** wird automatisch ausgefüllt. Ändere ihn nur bei Bedarf und mit Bedacht. Skripte verwenden den Internen Namen, nicht die Bezeichnung.

Unter **Verhalten** konfigurierst du die Karte:

* **Datenpunkt** stellt die Datenbeschaffung ein. Verwende **Manuell**, um sie mit Steuerelementen zu konfigurieren oder **Bedingt**, um ein Ninox Skript zu verwenden.\
  \
  Wenn **Datenpunkt** auf **Manuell** gesetzt ist:
* **Tabelle** wählt die Quelltabelle.
* **Standortfeld** wählt das Feld für die Markerposition.
* **Titelfeld** wählt das Feld, das Ninox beim Bewegen des Mauszeigers über den Marker anzeigt.
* **Farbfeld** wählt das Feld für die Markerfarbe.
* **Kartentyp** wählt **Straßenkarte**, **Satellit**, **Hybrid** oder **Gelände** als Kartenstil.
* **Filtern** begrenzt Datensätze mit einer oder mehreren Bedingungen.
* **Suchfeld anzeigen** zeigt ein Suchfeld über der Karte zum Suchen eines Standorts.\
  \
  Wenn **Datenpunkt** auf **Bedingt** gesetzt ist:
* **Datenpunktlogik** fügt das Ninox Skript hinzu, das die Daten abruft.\
  In diesem Fall erwartet Ninox **Schlüssel-Wert-Paare** in geschweiften Klammern **{...}.**

Unter **Sichtbarkeit** wählst du, wie die Komponente auf der Seite angezeigt wird:

* **Sichtbar**, um die Komponente auf der Seite anzuzeigen
* **Versteckt**, um die Komponente auf der Seite auszublenden
* **Bedingt**, um eine **Sichtbarkeitsbedingung** festzulegen, die steuert, wann die Komponente angezeigt oder ausgeblendet wird\
  Nutze **Bedingt**, wenn die Karte nur in bestimmten Fällen erscheinen soll.\
  Erstelle die Bedingung anhand von **Feldern** und **Tabellen**.\
  Dies wirkt sich nur auf die Anzeige auf der Seite aus. Datensätze und Berechtigungen bleiben unverändert.

{% hint style="info" %}
Verwende für die **Logik** unter **Datenpunkt** am besten die Ninox AI im [Logik-Editor](/ninox-scripting/de/automate-your-workflows/explore-core-scripting-elements/logic-editor-features.md). Sie unterstütz dich bei der Erstelling eines Skripts für das benötigte Ergebnis oder erklärt dir ein fertiges Skript.
{% endhint %}

**Schauen wir uns ein Beispiel an:**

{% code lineNumbers="true" %}

```
for r in select kunden do
	{
		Datum: r.standort
	}
end
```

{% endcode %}

Ninox AI erstellt ein solches Skript, wenn du folgenden Prompt eingibst:\
"Zeige mir die Adressen aller Kunden."


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ninox.com/builder-hub/de/visualize-and-organize-your-data/create-and-customize-pages/map-component.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.