

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.

# So geokodieren Sie mithilfe des räumlichen Kontextes
<a name="how-to-geocode-geospatial"></a>

Mit der Geocode-API können Sie den räumlichen Kontext (z. B. die Schrägposition) verwenden, um die gewünschten Ergebnisse zu erzielen.

**Anmerkung**  
„Bias-Position“ bezieht sich auf einen Mechanismus, der Suchergebnisse auf der Grundlage des vom Benutzer angegebenen Standorts oder eines definierten Bereichs priorisiert. Dadurch wird der Fokus der Suchergebnisse im Wesentlichen auf Standorte verlagert, die geografisch näher an einem bestimmten Zielpunkt liegen, ohne dass andere Ergebnisse unbedingt ausgeschlossen werden. 

## Mögliche Verwendung
<a name="geospatial-uses"></a>

Verwenden Sie den räumlichen Kontext, um die richtigen Ergebnisse auf der Grundlage Ihrer Geschäftsanforderungen zu erzielen.

## Beispiele
<a name="geospatial-examples"></a>

### Richten Sie die Ergebnisse auf eine bestimmte Position ein
<a name="bias-position-example"></a>

Indem Sie sich auf eine bestimmte Position konzentrieren, können Sie die Rangfolge Ihrer Ergebnisse ändern. Probieren Sie das folgende Beispiel mit — und dann ohne — den `BiasPosition` Wert aus und vergleichen Sie die Ergebnisse.

------
#### [ Sample request ]

```
{
    "QueryText": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Street",
            "Title": "George St, Sydney NSW, Australia",
            "Address": {
                "Label": "George St, Sydney NSW, Australia",
                "Country": {
                    "Code2": "AU",
                    "Code3": "AUS",
                    "Name": "Australia"
                },
                "Region": {
                    "Code": "NSW",
                    "Name": "New South Wales"
                },
                "Locality": "Sydney",
                "Street": "George St",
                "StreetComponents": [
                    {
                        "BaseName": "George",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ]
            },
            "Position": [
                151.20691,
                -33.86974
            ],
            "Distance": 117,
            "MapView": [
                151.20225,
                -33.88406,
                151.20912,
                -33.85635
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Intersection": [
                            1
                        ]
                    }
                }
            }
        },
        ...
        ...
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "George Street" --bias-position 151.2059 -33.8691
```

------

## Tipps für Entwickler
<a name="geospatial-developer-tips"></a>

Versuchen Sie, für die Adressen-Geokodierung vollständige Adressen oder eine Abfragekomponente mit einer Kombination aus Bias-Position, einschließlich Land und Ort, zu verwenden. Weitere Informationen hierzu finden Sie unter [So geokodieren Sie eine Adresse](how-to-geocode-address.md).