

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.

# Wie benutzt man SearchNearby
<a name="search-nearby-how-to"></a>

Dieser Abschnitt enthält eine Vielzahl von Anleitungen und Anwendungsbeispielen SearchNearby.

**Topics**
+ [So suchen Sie von einer Position aus in der Nähe](how-to-search-nearby.md)
+ [So suchen Sie nach Orten in der Nähe anhand von Kategorien](how-to-search-nearby-category.md)
+ [So suchen Sie nach Orten in der Nähe anhand der Art des Essens](how-to-search-nearby-food.md)
+ [So suchen Sie in der Nähe basierend auf der Geschäftskette](how-to-search-nearby-business.md)
+ [So suchen Sie in der Nähe eines Landes](how-to-search-nearby-country.md)
+ [So suchen Sie in der Nähe mithilfe des räumlichen Kontextes](how-to-search-nearby-geospatial.md)

# So suchen Sie von einer Position aus in der Nähe
<a name="how-to-search-nearby"></a>

Die SearchNearby API ermöglicht die Abfrage aller nahegelegenen Orte und Sehenswürdigkeiten (POI), ohne dass ein bestimmter Text eingegeben werden muss. Benutzer können mit dieser API Nachbarschaften erkunden POIs, entdecken und vieles mehr. Sie erfordert eine`QueryPosition`, die den Standort eines Geräts, die IP-basierte Position oder die Mitte des Kartenansichtsfensters darstellen kann. Alternativ können Benutzer eine Stadt oder einen Ort angeben, um die Ergebnisse anhand der Geokoordinaten dieses Standorts zu verzerren.

## Mögliche Anwendungsfälle
<a name="potential-use"></a>
+ **Erkunden Sie die Umgebung POIs:** Sehen Sie sich alle Sehenswürdigkeiten in der Nähe der aktuellen Position an.
+ **Orte in der Nähe erkunden:** Alle Orte oder Orte in der Nähe einer bestimmten Position anzeigen.

## Beispiele
<a name="search-nearby-examples"></a>

### Suchen Sie von einer Position aus in der Nähe
<a name="search-nearby-from-position"></a>

In diesem Beispiel wird die Suche von einer Position in Dubai mit dem Breitengrad 25,26951 und dem Längengrad 55,30884 aus durchgeführt.

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

```
{
    "QueryPosition": [
        55.30884,
        25.26951
    ]
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "هما",
            "Address": {
                "Label": "هما, شارع مستشفى آل مكتوم, نايف دبي, الإمارات العربية المتحدة",
                "Country": {
                    "Code2": "AE",
                    "Code3": "ARE",
                    "Name": "الإمارات العربية المتحدة"
                },
                "SubRegion": {
                    "Name": "دبي"
                },
                "Locality": "دبي",
                "District": "نايف",
                "Street": "شارع مستشفى آل مكتوم",
                "StreetComponents": [
                    {
                        "BaseName": "مستشفى آل مكتوم",
                        "Type": "شارع",
                        "TypePlacement": "BeforeBaseName",
                        "TypeSeparator": " ",
                        "Language": "ar"
                    }
                ]
            },
            "Position": [
                55.30884,
                25.26951
            ],
            "Distance": 0,
            "Categories": [
                {
                    "Id": "department_store",
                    "Name": "Department Store",
                    "LocalizedName": "مول تجاري",
                    "Primary": true
                }
            ],
            "BusinessChains": [
                {
                    "Name": "HEMA",
                    "Id": "HEMA"
                }
            ]
        },
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Locality",
            "Title": "دبي, الإمارات العربية المتحدة",
            "Address": {
                "Label": "دبي, الإمارات العربية المتحدة",
                "Country": {
                    "Code2": "AE",
                    "Code3": "ARE",
                    "Name": "الإمارات العربية المتحدة"
                },
                "SubRegion": {
                    "Name": "دبي"
                },
                "Locality": "دبي"
            },
            "Position": [
                55.30884,
                25.26951
            ],
            "Distance": 0,
            "MapView": [
                54.64906,
                24.62308,
                55.7371,
                25.36995
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
        55.30884,
        25.26951
    ],
    "MaxResults": 2
}'
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position 55.30884 25.26951 \
--max-results 2
```

------

# So suchen Sie nach Orten in der Nähe anhand von Kategorien
<a name="how-to-search-nearby-category"></a>

Die SearchNearby API ermöglicht die Abfrage von Points of Interest (POI) unter Einbeziehung oder Ausschluss bestimmter Kategorien. Dies kann Benutzern helfen, Stadtteile zu erkunden, lokale Orte zu entdecken und POIs vieles mehr. Für die API ist eine erforderlich`QueryPosition`, die auf dem Standort, der IP-Position oder der Mitte des Kartenansichtsfensters eines Geräts basieren kann. Alternativ können Benutzer eine Stadt oder einen Ort angeben, sodass die Anwendung die Ergebnisse anhand der Koordinaten dieses Standorts verzerrt.

Weitere Informationen zu unterstützten Kategorien finden Sie unter[Filter für Kategorien](places-filtering.md#place-categories).

## Mögliche Anwendungsfälle
<a name="potential-use"></a>
+ **Erkunden Sie lokale Einrichtungen:** Finden Sie verfügbare Einrichtungen in einer Nachbarschaft.
+ **Entdecken Sie Touristenattraktionen:** Identifizieren Sie Touristenattraktionen in einer Stadt.
+ **Reisen in einer Stadt planen:** Organisieren Sie Reisen zu verschiedenen Orten POIs innerhalb einer ausgewählten Stadt.

## Beispiele
<a name="search-nearby-category-examples"></a>

### Kategorie einbeziehen
<a name="include-category"></a>

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

```
{
    "QueryPosition": [
        4.35609,
        50.84439
    ],
    "Filter": {
        "IncludeCategories": ["airport"]
    }
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Brussels Airport",
            "Address": {
                "Label": "Brussels Airport, A201, 1930 Zaventem, België",
                "Country": {
                    "Code2": "BE",
                    "Code3": "BEL",
                    "Name": "België"
                },
                "Region": {
                    "Code": "VLG",
                    "Name": "Vlaanderen"
                },
                "SubRegion": {
                    "Name": "Vlaams Brabant"
                },
                "Locality": "Zaventem",
                "PostalCode": "1930",
                "Street": "A201",
                "StreetComponents": [
                    {
                        "BaseName": "A201",
                        "Language": "nl"
                    }
                ]
            },
            "Position": [
                4.47767,
                50.89452
            ],
            "Distance": 10191,
            "Categories": [
                {
                    "Id": "airport",
                    "Name": "Airport",
                    "LocalizedName": "Luchthaven",
                    "Primary": true
                }
            ]
        },
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Internationale Luchthaven Antwerpen",
            "Address": {
                "Label": "Internationale Luchthaven Antwerpen, Luchthavenlei 1, 2100 Antwerpen, België",
                "Country": {
                    "Code2": "BE",
                    "Code3": "BEL",
                    "Name": "België"
                },
                "Region": {
                    "Code": "VLG",
                    "Name": "Vlaanderen"
                },
                "SubRegion": {
                    "Name": "Antwerpen"
                },
                "Locality": "Antwerpen",
                "District": "Deurne",
                "PostalCode": "2100",
                "Street": "Luchthavenlei",
                "StreetComponents": [
                    {
                        "BaseName": "Luchthaven",
                        "Type": "lei",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": "",
                        "Language": "nl"
                    }
                ],
                "AddressNumber": "1"
            },
            "Position": [
                4.45083,
                51.18867
            ],
            "Distance": 38852,
            "Categories": [
                {
                    "Id": "airport",
                    "Name": "Airport",
                    "LocalizedName": "Luchthaven",
                    "Primary": true
                }
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
        4.35609,
        50.84439
    ],
    "Filter": {
        "IncludeCategories": ["airport"]
    },
    "MaxResults": 2
}
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position 4.35609 50.84439 \
--filter '{"IncludeCategories": ["airport"]}' \
--max-results 2
```

------

### Kategorie ausschließen
<a name="exclude-category"></a>

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

```
{
    "QueryPosition": [
        4.35609,
        50.84439
    ],
    "Filter": {
        "ExcludeCategories": ["airport"]
    }
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Socialbrands Module 2",
            "Address": {
                "Label": "Socialbrands Module 2, Albertinaplein, 1000 Brussel, België",
                "Country": {
                    "Code2": "BE",
                    "Code3": "BEL",
                    "Name": "België"
                },
                "Region": {
                    "Code": "BRU",
                    "Name": "Brussel"
                },
                "SubRegion": {
                    "Name": "Brussel"
                },
                "Locality": "Brussel",
                "District": "Koningswijk",
                "PostalCode": "1000",
                "Street": "Albertinaplein",
                "StreetComponents": [
                    {
                        "BaseName": "Albertina",
                        "Type": "plein",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": "",
                        "Language": "nl"
                    }
                ]
            },
            "Position": [
                4.35609,
                50.84439
            ],
            "Distance": 0,
            "Categories": [
                {
                    "Id": "commercial_services",
                    "Name": "Commercial Services",
                    "LocalizedName": "Commerciële diensten",
                    "Primary": true
                }
            ],
            "Contacts": {
                "Websites": [
                    {
                        "Value": "https://oneread.net"
                    }
                ]
            },
            "AccessPoints": [
                {
                    "Position": [
                        4.35609,
                        50.84439
                    ]
                }
            ]
        },
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Barman Privé",
            "Address": {
                "Label": "Barman Privé, Albertinaplein, 1000 Brussel, België",
                "Country": {
                    "Code2": "BE",
                    "Code3": "BEL",
                    "Name": "België"
                },
                "Region": {
                    "Code": "BRU",
                    "Name": "Brussel"
                },
                "SubRegion": {
                    "Name": "Brussel"
                },
                "Locality": "Brussel",
                "District": "Koningswijk",
                "PostalCode": "1000",
                "Street": "Albertinaplein",
                "StreetComponents": [
                    {
                        "BaseName": "Albertina",
                        "Type": "plein",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": "",
                        "Language": "nl"
                    }
                ]
            },
            "Position": [
                4.35609,
                50.84439
            ],
            "Distance": 0,
            "Categories": [
                {
                    "Id": "catering_and_other_food_services",
                    "Name": "Catering and Other Food Services",
                    "LocalizedName": "Catering- en horecadiensten",
                    "Primary": true
                }
            ],
            "Contacts": {
                "Phones": [
                    {
                        "Value": "+32476891634"
                    }
                ]
            },
            "OpeningHours": [
                {
                    "Display": [
                        "ma-zo: 00:00 - 24:00"
                    ],
                    "OpenNow": true,
                    "Components": [
                        {
                            "OpenTime": "T000000",
                            "OpenDuration": "PT24H00M",
                            "Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR,SA,SU"
                        }
                    ]
                }
            ],
            "AccessPoints": [
                {
                    "Position": [
                        4.35609,
                        50.84439
                    ]
                }
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
        4.35609,
        50.84439
    ],
    "Filter": {
        "ExcludeCategories": ["airport"]
    }
}
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position 4.35609 50.84439 \
--filter '{"ExcludeCategories": ["airport"]}' \
--max-results 2
```

------

# So suchen Sie nach Orten in der Nähe anhand der Art des Essens
<a name="how-to-search-nearby-food"></a>

Mit der `SearchNearby` API können Sie Restaurants in der Nähe abfragen, die eine bestimmte Art von Essen servieren. Sie können auch Lebensmittelarten aus Ihren Ergebnissen ausschließen.

Sie können die SearchNearby API verwenden, damit Endbenutzer Stadtteile erkunden und interessante Orte entdecken können. Die API erfordert QueryPosition, dass es sich dabei um eine Geräteposition, eine IP-Position oder den Mittelpunkt des Kartenansichtsfensters handeln kann. Eine andere Möglichkeit besteht darin, Endbenutzer den Stadt- oder Ortsnamen angeben zu lassen, sodass die Anwendung die Ergebnisse anhand der Geokoordinaten verzerren kann.

Weitere Informationen zu Lebensmittelarten finden Sie unter. [Filter für den Lebensmitteltyp](places-filtering.md#food-type)

## Mögliche Anwendungsfälle
<a name="potential-use-search-nearby-04"></a>
+ Erkunden Sie die Arten von Lebensmitteln, die in der Umgebung erhältlich sind.
+ Schließen Sie Restaurantoptionen aus, die Lebensmittel servieren, gegen die Sie allergisch sind.

## Beispiel
<a name="search-neaby-food-examples"></a>

### Suchen Sie nach Lebensmittelart nach Orten in der Nähe
<a name="search-nearby-food-example"></a>

Das folgende Beispiel zeigt, wie Sie anhand der Lebensmittelart nach Orten in der Nähe suchen.

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

Diese Anfrage sucht nach Restaurants, die chinesisches Essen in der Nähe der angegebenen Koordinaten servieren.

```
{
    "QueryPosition": [
        12.49563,
        41.90325
    ],
    "Filter": {
        "IncludeFoodTypes": ["chinese"]
    }
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Bufala e Pachino",
            "Address": {
                "Label": "Bufala e Pachino, Via Firenze, 53, 00184 Roma RM, Italia",
                "Country": {
                    "Code2": "IT",
                    "Code3": "ITA",
                    "Name": "Italia"
                }
            },
            "Position": [
                12.49409,
                41.90237
            ],
            "Distance": 161,
            "Categories": [
                {
                    "Id": "restaurant",
                    "Name": "Restaurant",
                    "LocalizedName": "Ristorante",
                    "Primary": true
                }
            ],
            "FoodTypes": [
                {
                    "LocalizedName": "Pizza",
                    "Id": "pizza",
                    "Primary": true
                },
                {
                    "LocalizedName": "Cinese",
                    "Id": "chinese",
                    "Primary": false
                }
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [12.49563, 41.90325],
    "Filter": {
        "IncludeFoodTypes": ["chinese"]
    }
}'
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeFoodTypes": ["chinese"]}'
```

------

### Tipps für Entwickler
<a name="search-nearby-food-developer-tips"></a>
+ Sie können `ExludeFoodTypes` damit bestimmte Geschäftsketten aus Ihren Ergebnissen ausschließen. 
+ Sie können mehrere Lebensmittelarten ausschließen oder einbeziehen.

# So suchen Sie in der Nähe basierend auf der Geschäftskette
<a name="how-to-search-nearby-business"></a>

Mit der SearchNearby API können Sie Geschäftsketten in der Nähe abfragen. Sie können bestimmte Geschäftsketten in Ihre Suche einbeziehen oder ausschließen. Diese Funktion ermöglicht es Endbenutzern, Stadtteile zu erkunden, Sehenswürdigkeiten zu entdecken und vieles mehr.

Um die SearchNearby API verwenden zu können QueryPosition, müssen Sie Folgendes angeben:
+ Eine Geräteposition
+ Eine IP-basierte Position
+ Der Mittelpunkt des Darstellungsfensters einer Karte

Alternativ können Benutzer einen Stadtnamen oder einen Ort angeben, und die Anwendung kann die Ergebnisse anhand der Geokoordinaten dieses Standorts verzerren.

Weitere Informationen zu unterstützten Geschäftsketten finden Sie unter. [Filter für Unternehmensketten](places-filtering.md#business-chains)

## Mögliche Anwendungsfälle
<a name="potential-use-search-nearby-business"></a>
+ Erkunden Sie Unternehmen in der Nähe
+ Erweitern Sie Ihr Geschäft, indem Sie B2B-Kunden in der Nähe finden

## Beispiele
<a name="search-neaby-business-examples"></a>

### Suchen Sie nach Geschäftsketten nach Orten in der Nähe
<a name="search-nearby-business-example"></a>

Das folgende Beispiel zeigt, wie Sie nach Starbucks-Standorten in der Nähe suchen.

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

Diese Anfrage sucht nach Starbucks-Standorten in der Nähe der angegebenen Koordinaten.

```
{
    "QueryPosition": [
        12.49563,
        41.90325
    ],
    "Filter" : {
        "IncludeBusinessChains": ["Starbucks"]
    }    
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Starbucks",
            "Address": {
                "Label": "Starbucks, Via Giovanni Giolitti, 2, 00185 Roma RM, Italia",
                "Country": {
                    "Code2": "IT",
                    "Code3": "ITA",
                    "Name": "Italia"
                },
                "Region": {
                    "Name": "Lazio"
                },
                "SubRegion": {
                    "Code": "RM",
                    "Name": "Roma"
                },
                "Locality": "Roma",
                "District": "Esquilino",
                 "PostalCode": "00185",
                "Street": "Via Giovanni Giolitti",
                "StreetComponents": [
                    {
                        "BaseName": "Giovanni Giolitti",
                        "Type": "Via",
                        "TypePlacement": "BeforeBaseName",
                        "TypeSeparator": " ",
                        "Language": "it"
                    }
                ],
                "AddressNumber": "2"
            },
            "Position": [
                12.50102,
                41.90093
            ],
            "Distance": 515,
            "Categories": [
                {
                    "Id": "coffee_shop",
                    "Name": "Coffee Shop",
                    "LocalizedName": "Bar",
                    "Primary": true
                }
            ],
            "BusinessChains": [
                {
                    "Name": "Starbucks",
                    "Id": "Starbucks"
                }
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
                12.49563,
                41.90325
        ],
        "Filter" : {
        "IncludeBusinessChains": ["Starbucks"]
    }    
}'
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeBusinessChains": ["Starbucks"]}'
```

------

## Tipps für Entwickler
<a name="search-nearby-business-developer-tips"></a>
+ Sie können `ExcludeBusinessChains` damit bestimmte Geschäftsketten aus Ihren Ergebnissen ausschließen.
+ Sie können mehrere Geschäftsketten ausschließen oder einbeziehen.

# So suchen Sie in der Nähe eines Landes
<a name="how-to-search-nearby-country"></a>

Die SearchNearby API ermöglicht es Ihnen, nach Orten in der Nähe in einem bestimmten Land zu suchen. Um die API verwenden zu können QueryPosition, müssen Sie Folgendes angeben:
+ Eine Geräteposition
+ Eine IP-basierte Position
+ Die Mitte des Darstellungsfensters einer Karte

Alternativ können Benutzer einen Stadtnamen oder einen Ort angeben, und die Anwendung kann die Ergebnisse anhand der Geokoordinaten dieses Standorts verzerren.

## Mögliche Anwendungsfälle
<a name="potential-use-search-nearby-country"></a>
+ Erkunden Sie Unternehmen innerhalb eines Landes
+ Finden Sie B2B-Kunden in der Nähe innerhalb eines Landes
+ Erkunden Sie touristische Orte innerhalb eines Landes

## Beispiele
<a name="search-neaby-country-examples"></a>

### Suchen Sie nach Golfplätzen in Kanada
<a name="search-nearby-country-example"></a>

Das folgende Beispiel zeigt, wie Sie nach Golfplätzen in Kanada in der Nähe bestimmter Koordinaten suchen.

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

Diese Anfrage sucht nach Golfplätzen in Kanada in der Nähe des angegebenen Standorts.

```
{
    "QueryPosition": [
            -122.741803, 
            49.002478
    ],
    "Filter" : {
        "IncludeCategories": ["golf_course"],
        "IncludeCountries": ["CAN"]
    }
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Peace Portal Golf Course",
            "Address": {
                "Label": "Peace Portal Golf Course, 16900 * Ave, Surrey, BC V*Z *P*, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Surrey",
                "District": "South Surrey",
                "PostalCode": "V*Z *P*",
                "Street": "* Ave",
                "StreetComponents": [
                    {
                        "BaseName": "4",
                        "Type": "Ave",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "16900"
            },
            "Position": [
                -122.75086,
                49.00921
            ],
            "Distance": 998,
            "Categories": [
                {
                    "Id": "golf_course",
                    "Name": "Golf Course",
                    "LocalizedName": "Golf Course",
                    "Primary": true
                }
            ],
            "Contacts": {
                "Phones": [
                    {
                        "Value": "+16045384818"                    }
                ],
                "Websites": [
                    {
                        "Value": "http://www.peaceportalgolf.com"
                    }
                ]
            },
            "AccessPoints": [
                {
                    "Position": [
                        -122.75087,
                        49.00935
                    ]
                }
            ]
        }
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
         -122.741803, 
         49.002478
        ],
        "Filter" : {
        "IncludeCategories": ["golf_course"],
              "IncludeCountries": ["CAN"]
    }
    
}'
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position -122.741803 49.002478 \
--filter '{"IncludeCategories": ["golf_course"], "IncludeCountries": ["CAN"]}'
```

------

# So suchen Sie in der Nähe mithilfe des räumlichen Kontextes
<a name="how-to-search-nearby-geospatial"></a>

Die SearchNearby API ermöglicht es Ihnen, die Umgebung zu erkunden und gleichzeitig die Ergebnisse innerhalb des räumlichen Kontextes (z. B. eines Kreises oder eines Begrenzungsrahmens) einzuschränken.

Mit der SearchNearby API können Sie Ergebnisse mithilfe von räumlichen Kontexten wie Kreisen und Begrenzungsrahmen filtern. Durch die Definition dieser geografischen Grenzen können Sie die Suchergebnisse auf bestimmte Bereiche beschränken.

## Mögliche Anwendungsfälle
<a name="potential-use-search-nearby-geospatial"></a>
+ Beschränken Sie die Suchergebnisse auf ein bestimmtes geografisches Gebiet
+ Suchen Sie innerhalb benutzerdefinierter Grenzen
+ Konzentrieren Sie die Ergebnisse auf bestimmte Stadtteile oder Bezirke

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

### Suchen Sie mit dem Abfrageradius
<a name="search-nearby-geospatial-example"></a>

Das folgende Beispiel zeigt, wie nach Schulen in einem Umkreis von 1000 Metern um die angegebenen Koordinaten gesucht wird.

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

Diese Anfrage sucht nach Schulen in einem Umkreis von 1000 Metern (1 Kilometer).

```
{
    "QueryPosition": [
                 -122.741803, 
         49.002478
        ],
        "QueryRadius":1000,
        "Filter" : {
            "IncludeCategories": ["school"]
    }
    
}
```

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

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Grace Lutheran Church",
            "Address": {
                "Label": "Grace Lutheran Church, 702 G St, Blaine, WA 98230-5125, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "WA",
                    "Name": "Washington"
                },
                "SubRegion": {
                    "Name": "Whatcom"
                },
                "Locality": "Blaine",
                "PostalCode": "98230-5125",
                "Street": "G St",
                "StreetComponents": [
                    {
                        "BaseName": "G",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "702"
            },
            "Position": [
                -122.74157,
                48.99533
            ],
            "Distance": 795,
            "Categories": [
                {
                    "Id": "church",
                    "Name": "Church",
                    "LocalizedName": "Church",
                    "Primary": true
                },
                {
                    "Id": "kindergarten_and_childcare",
                    "Name": "Kindergarten and Childcare",
                    "LocalizedName": "Kindergarten & Childcare",
                    "Primary": false
                },
                {
                    "Id": "school",
                    "Name": "School",
                    "LocalizedName": "School",
                    "Primary": false
                }
            ]
        }
        ...
    ]
}
```

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

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
         -122.741803, 
         49.002478
    ],
    "QueryRadius": 1000,
    "Filter": {
        "IncludeCategories": ["school"]
    }
}'
```

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

```
aws geo-places search-nearby --key ${YourKey} \
--query-position -122.741803 49.002478 \
--query-radius 1000 \
--filter '{"IncludeCategories": ["school"]}'
```

------

## Tipps für Entwickler
<a name="search-nearby-geospatial-developer-tips"></a>
+ Alternativ können Sie einen Bounding-Box-Filter verwenden.