

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Statische Karten
<a name="static-maps"></a>

**Anmerkung**  
Statische Karten unterstützen nur die Stile Standard und Satellite. Weitere Informationen finden Sie unter [AWS Kartenstile und Funktionen](map-styles.md).

Statische Karten bieten eine vorgerenderte Darstellung geografischer Daten mit der Option, Markierungen (oder Stecknadeln), Routen und Polygonbereiche zu überlagern, je nach Bedarf für Ihre Anwendung. Mit der statischen Karte können Sie statische (nicht interaktive) Kartenbilder auf der Grundlage anpassbarer Parameter und Dateneingaben generieren. Durch das Anpassen von Überlagerungen und Formen oder das Anwenden benutzerdefinierter Stile können Sie mit Static Map Kartenvisualisierungen erstellen, die spezifischen Anforderungen entsprechen, das Benutzererlebnis verbessern und geografische Informationen effektiv vermitteln. Der Server passt die angeforderten Kartenbilder an und stellt sie dem Client als JPEG-Dateien zur Verfügung. Sie können programmgesteuert Kartenbilder anfordern und generieren, die auf Ihre spezifischen Anforderungen zugeschnitten sind.

Die *GetStaticMap API* generiert ein statisches Bild einer Karte auf der Grundlage bestimmter Parameter wie Mittelpunktkoordinaten, Begrenzungsrahmen oder Überlagerungen. Die API ermöglicht die Anpassung der Kartenfunktionen und des Kartenstils und ermöglicht so die Verwendung in Web- oder Mobilanwendungen ohne interaktive Kartenfunktionen.

Weitere Informationen finden Sie [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)in der *Amazon Location Service API-Referenz*.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter [So verwenden Sie statische Maps](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html).

## Häufige Anwendungsfälle
<a name="static-maps-use-cases"></a>
+ **Eingebettete Karten in Web- oder Mobilanwendungen:** Statische Kartenbilder können effizient in Websites oder mobile Anwendungen eingebettet werden, um Standorte, Routen oder Sehenswürdigkeiten mit nicht interaktiven Karten zu visualisieren, wodurch Ladezeiten und Datennutzung reduziert werden. Beispiele hierfür sind Suchmaschinen (wie Yahoo), die Kartenbilder mit Suchergebnissen für anzeigen. POIs
+ **Standortdetails in E-Mails:** Statische Kartenbilder können verwendet werden, um Standortinformationen per E-Mail weiterzugeben, damit Ihre Endnutzer den Kontext der E-Mail besser verstehen. Beispielsweise verwenden Apps für die Lieferung von Lebensmitteln oder Mitfahrgelegenheiten statische Kartenbilder, um Abhol- und Abgabeorte, Routen oder die Umgebung in E-Mails nach der Reise oder der Lieferung anzuzeigen, die Rechnung und Zusammenfassung enthalten.
+ **Marketingmaterialien und gedruckte Dokumente:** Maßgeschneiderte statische Kartenbilder können in Broschüren, Flyer oder andere gedruckte Materialien integriert werden und bieten visuell ansprechende Darstellungen von geographischen Informationen, die für den Inhalt relevant sind.

## Verstehen Sie die Anfrage
<a name="static-maps-understanding-request"></a>

Die Anfrage enthält optionale URI-Parameter wie`BoundedPositions`, `BoundingBox``Center`, und unter anderem zur Definition des sichtbaren Bereichs und der Überlagerungen der Karte. Die Parameter `Height` und `Width` sind für die Definition der Bildgröße erforderlich. Weitere Informationen hierzu finden Sie unter [Statische Karten anpassen](customizing-static-maps.md) und [Overlay auf der statischen Karte](overlaying-static-map.md).
+ `BoundedPositions`: Koordinaten, die in das Bild aufgenommen werden sollen.
+ `BoundingBox`: Koordinaten, die den südwestlichen und nordöstlichen Rand der Karte definieren.
+ `Height`: Gibt die Höhe des Bildes an.
+ `Width`: Gibt die Breite des Bildes an.
+ `GeoJsonOverlay`: Ein gültiges GeoJSON-Objekt zum Hinzufügen von Overlays.

## Verstehe die Antwort
<a name="static-maps-understanding-response"></a>

Die Antwort enthält Header wie `CacheControl` `ContentType``ETag`, und und und gibt die statische Map als binären Blob im JPEG- oder PNG-Format zurück. Die Header stellen Metadaten wie Cache-Kontrolle, Inhaltstyp und Version für statische Bilder bereit.
+ `CacheControl`: Gibt Caching-Konfigurationen für das Kartenbild an.
+ `ContentType`: Gibt das Format des Kartenbilds an (JPEG oder PNG).
+ `ETag`: Ein Bezeichner für die Version des statischen Kartenbilds.
+ `Blob`: Stellt das Kartenbild entweder im JPEG- oder PNG-Format dar.

# Statische Karten anpassen
<a name="customizing-static-maps"></a>

**Anmerkung**  
Statische Karten unterstützen nur den Satelliten-Stil. Weitere Informationen finden Sie unter [AWS Kartenstile und Funktionen](map-styles.md).

Dieser Abschnitt bietet einen Überblick darüber, wie statische Karten, die mit Amazon Location Service generiert wurden, angepasst werden können. Er behandelt verschiedene Funktionen wie das Anpassen von Position, Größe, Sprache, Maßstab, Überlagerungen und Zuordnung der Karte, sodass Sie die Karte an Ihre spezifischen Anforderungen anpassen können.

Weitere Informationen finden Sie [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)in der *Amazon Location Service API-Referenz*.

## Position
<a name="customizing-static-maps-position"></a>

Die Position ermöglicht es Ihnen, den Mittelpunkt und die Grenzen der Karte zu definieren. Sie können den Fokus der Karte steuern, indem Sie die Mittelpunktkoordinaten oder einen Begrenzungsrahmen festlegen oder mithilfe einer Zoomstufe bestimmen, wie viel Fläche angezeigt werden soll. Informationen zur Funktionsweise finden Sie unter[So erhalten Sie eine statische Karte einer bestimmten Position](get-static-map-specific-position.md).
+ `Center`: Definiert den Mittelpunkt der Karte anhand von Längen- und Breitengradkoordinaten.
+ `Radius`: Gibt den Radius (Entfernung vom Mittelpunkt) an, der auf der statischen Karte angezeigt wird.
+ `Bounding Box`: Definiert einen rechteckigen Bereich der Karte, der durch Angabe der Koordinaten der oberen linken und unteren rechten Ecke festgelegt wird.
+ `Zoom`: Steuert die Zoomstufe der Karte. Höhere Zoomstufen zeigen mehr Details in einem kleineren Bereich, während niedrigere Zoomstufen weniger Details in einem größeren Bereich anzeigen.

## Dimension und Qualität
<a name="customizing-static-maps-dimension-quality"></a>

Sie können die Größe und visuelle Qualität der statischen Map anpassen, indem Sie ihre Abmessungen (Höhe und Breite) definieren und für eine bessere Darstellung von Markierungen und anderen Elementen Abstände hinzufügen. Informationen zur Funktionsweise finden Sie unter[So erhalten Sie eine statische Karte einer bestimmten Dimension](get-static-map-specific-dimension.md).
+ `Height and Width`: Gibt die Größe des statischen Kartenbilds an, indem dessen Höhe und Breite in Pixeln definiert werden.
+ `Padding`: Fügt zusätzlichen Platz an den Rändern der Karte hinzu und ermöglicht so eine bessere Visualisierung beim Platzieren von Markierungen, Linien oder Formen.

## Skalieren
<a name="customizing-static-maps-scale"></a>

Der Maßstab ermöglicht die Steuerung des Maßstabs der Karte und definiert die Einheiten (Kilometer, Meilen) zur Entfernungsmessung. Dies ist nützlich, um die Größen- und Entfernungsbeziehungen der Karte genau darzustellen. Informationen zur Funktionsweise finden Sie unter[So fügen Sie einen Maßstab für eine statische Karte hinzu](add-scale-static-map.md).
+ `Scale Unit`: Definiert die Einheiten für die Maßstabsleiste der Karte (z. B. Kilometer oder Meilen), sodass Benutzer Entfernungen auf der Karte genau messen können.

## Überlagerung
<a name="customizing-static-maps-overlay"></a>

Sie können Markierungen, Linien zum Anzeigen von Routen, Polygone zum Anzeigen von Bereichen und mehr hinzufügen. Wie das funktioniert, erfahren Sie unter [So fügen Sie einer statischen Karte eine Markierung hinzu](add-marker-static-map.md)[So fügen Sie einer statischen Karte eine Linie hinzu](how-to-add-line-static.md), oder. [So fügen Sie einer statischen Karte eine Route hinzu](how-to-add-route.md)

# Overlay auf der statischen Karte
<a name="overlaying-static-map"></a>

In diesem Abschnitt wird erklärt, wie Sie mithilfe von Amazon Location Service zusätzliche Informationen auf statischen Karten einblenden können. Sie können Ihre statischen Karten anpassen, indem Sie verschiedene geografische Merkmale wie Punkte, Linien und Polygone hinzufügen, um die visuelle Darstellung der Karte zu verbessern. Amazon Location Service unterstützt mehrere Formate, darunter GeoJSON und ein kompaktes Overlay-Format, um flexible und effiziente Möglichkeiten zum Hinzufügen von Overlays zu bieten.

Weitere Informationen finden Sie [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)in der *Amazon Location Service API-Referenz*.

## Mit GeoJSON
<a name="overlaying-static-map-geojson"></a>

GeoJSON ist ein vielseitiges Format, mit dem Sie benutzerdefinierte Daten auf statischen Karten überlagern können. Durch die Definition geografischer Merkmale wie Punkte, Linien und Polygone können Sie die visuelle Darstellung Ihrer Karten verbessern und Benutzern so wertvollen Kontext bieten. GeoJSON wird weitgehend unterstützt und bietet Flexibilität bei der Gestaltung und Anpassung von Karten-Overlays. Damit ist es ein ideales Format für die Anzeige von Regionen, das Plotten von Routen oder die Darstellung räumlicher Beziehungen.

Mit Amazon Location Service können Sie GeoJSON nutzen, um dynamische, standortbasierte Funktionen direkt zu Ihren statischen Karten hinzuzufügen. Auf diese Weise können Sie hochgradig anpassbare Overlays erstellen, die auf Ihre spezifischen Geschäftsanforderungen zugeschnitten werden können. GeoJSON unterstützt mehrere Geometrietypen, darunter`Point`, `LineString``Polygon`, und`MultiPolygon`, sodass Sie eine Vielzahl von Features anzeigen können, von Markierungen und Routen bis hin zu komplexen Gebietsdarstellungen.

## Colors (Farben)
<a name="overlaying-static-map-geojson-colors"></a>

Beim Stylen von GeoJSON-Features haben Sie Flexibilität bei der Definition von Farben. Sie können Farben in verschiedenen Formaten angeben, z. B. mit Hexadezimalwerten (wie \$1ff0000 für Rot) oder mit Alpha-Transparenz (wie \$1ff000080 für halbtransparentes Rot). Dadurch wird sichergestellt, dass Ihre Overlays visuell dem Kartenstil entsprechen. Wenn keine Farbe angegeben ist, wird die Standardfarbe für den ausgewählten Kartenstil angewendet.

## Reihenfolge der Zeichnungen
<a name="overlaying-static-map-drawing-order"></a>

Benutzerdefinierte Überlagerungen werden in einer bestimmten Reihenfolge gezeichnet, um die Übersichtlichkeit zu wahren und visuelle Unordnung zu vermeiden. In Amazon Location Service werden Overlay-Features wie Polygone, Linien und Punkte über der Basiskarte, aber unter den Kartenbeschriftungen angezeigt. Bei der Darstellungsreihenfolge werden zuerst Polygone priorisiert, dann Linien und dann Punkte oder Markierungen.

## Maßeinheiten
<a name="overlaying-static-map-measurement-units"></a>

Für Eigenschaften wie `width` und können Sie verschiedene Maßeinheiten verwenden`outline-width`, um die Größe anzugeben, darunter Pixel (px), Meter (m), Kilometer (km), Meilen (mi) und Prozentsätze (%). Die Prozenteinheit passt die Eigenschaft relativ zu einem Standardwert an und bietet so mehr Flexibilität bei der Gestaltung Ihrer Überlagerungen.

## Geometrietypen
<a name="overlaying-static-map-geometry-types"></a>

Amazon Location Service unterstützt mehrere GeoJSON-Geometrietypen wie`Point`, `LineString``Polygon`, und`MultiPolygon`. Jeder Geometrietyp kann mithilfe des Eigenschaftenobjekts in GeoJSON gestaltet und angepasst werden, sodass Markierungen, Routen und Bereiche auf Ihrer Karte umfassend angepasst werden können.

## Mit kompakter Überlagerung
<a name="overlaying-static-map-compact-overlay"></a>

**Anmerkung**  
Compact Overlay unterstützt die folgenden Geometrietypen: Punkt, Linie und Polygon. , oder wird nicht unterstützt`multiPoint`. `multiLine` `multiPolgyon`

Mit der kompakten Overlay-Option können Sie mithilfe eines einzigen Abfrageparameters mehrere Geometrien effizient auf einer statischen Karte anzeigen. Dieser optimierte Ansatz vereinfacht das Anforderungsformat und reduziert die Größe der Anfrage, wodurch die Übertragung von Overlay-Daten erleichtert wird. Kunden können verschiedene Geometrietypen und ihre entsprechenden Stileigenschaften in einen Abfrageparameter eingeben, und Amazon Location Service übernimmt die schwere Arbeit, indem es das Overlay wie angegeben analysiert und rendert.

Beachten Sie bei der Verwendung des kompakten Overlay-Formats, dass die Größe der Anforderungs-URL begrenzt ist. Amazon Location Service optimiert zwar die Abfrage, stellen Sie jedoch sicher, dass Ihre Anfrage innerhalb angemessener Grenzen bleibt, insbesondere wenn es sich um mehrere Geometrien und die zugehörigen Eigenschaften handelt.

## Format
<a name="overlaying-static-map-compact-overlay-format"></a>

Das kompakte Overlay-Format ist wie folgt strukturiert: `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...`

Jeder Geometrietyp wird zusammen mit seinen Stileigenschaften definiert. Mehrere Geometrien werden durch einen Pipeoperator (\$1) getrennt, und die Eigenschaften der einzelnen Geometrien werden durch ein Semikolon getrennt.

## Unterstützte Geometrietypen
<a name="overlaying-static-map-supported-geometry-types"></a>

Amazon Location Service unterstützt mehrere Geometrietypen `Point``MultiPoint`, darunter`LineString`,`Polygon`, und`MultiPolygon`. Diese Geometrietypen können mithilfe des kompakten Overlay-Formats innerhalb desselben Abfrageparameters kombiniert und gestaltet werden.

## Eigenschaften gestalten
<a name="overlaying-static-map-styling-properties"></a>

Jede Geometrie kann mithilfe verschiedener Stileigenschaften wie Farbe, Umrissfarbe, Größe und mehr angepasst werden. Mit diesen Eigenschaften können Sie das Aussehen der einzelnen Geometrien auf der Karte steuern und so sicherstellen, dass das Overlay Ihren Geschäftsanforderungen entspricht.