Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Comment rechercher des lieux à proximité en fonction du type de nourriture
<a name="how-to-search-nearby-food"></a>

L'`SearchNearby`API vous permet d'interroger les restaurants situés à proximité qui proposent un type de nourriture spécifique. Vous pouvez également exclure certains types d'aliments de vos résultats.

Vous pouvez utiliser l' SearchNearby API pour permettre aux utilisateurs finaux d'explorer les quartiers et de découvrir les lieux d'intérêt. L'API nécessite QueryPosition, ce qui peut être la position de l'appareil, la position IP ou le centre du port de vue d'une carte. Une autre méthode consiste à laisser les utilisateurs finaux fournir le nom de la ville ou du lieu, et l'application peut biaiser les résultats en fonction des coordonnées géographiques.

Pour plus d'informations sur les types d'aliments, voir[Filtres de type alimentaire](places-filtering.md#food-type).

## Cas d'utilisation potentiels
<a name="potential-use-search-nearby-04"></a>
+ Découvrez les différents types de nourriture disponibles dans les environs.
+ Excluez les restaurants qui proposent des types d'aliments auxquels vous êtes allergique.

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

### Rechercher des lieux à proximité par type de nourriture
<a name="search-nearby-food-example"></a>

L'exemple suivant montre comment rechercher des lieux proches en fonction du type de nourriture.

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

Cette demande permet de rechercher des restaurants proposant des plats chinois à proximité des coordonnées spécifiées.

```
{
    "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"]}'
```

------

### Conseils aux développeurs
<a name="search-nearby-food-developer-tips"></a>
+ Vous pouvez l'utiliser `ExludeFoodTypes` pour exclure certaines chaînes commerciales de vos résultats. 
+ Vous pouvez exclure ou inclure plusieurs types d'aliments.