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 utiliser SearchNearby
Cette section contient une variété de guides pratiques et d'exemples d'utilisation SearchNearby.
**Topics**
+ [Comment effectuer une recherche à proximité à partir d'une position](how-to-search-nearby.md)
+ [Comment rechercher des lieux à proximité en fonction de la catégorie](how-to-search-nearby-category.md)
+ [Comment rechercher des lieux à proximité en fonction du type de nourriture](how-to-search-nearby-food.md)
+ [Comment effectuer une recherche à proximité en fonction de la chaîne d'entreprises](how-to-search-nearby-business.md)
+ [Comment effectuer une recherche à proximité dans un pays](how-to-search-nearby-country.md)
+ [Comment effectuer une recherche à proximité à l'aide du contexte géospatial](how-to-search-nearby-geospatial.md)
# Comment effectuer une recherche à proximité à partir d'une position
L' SearchNearby API permet de rechercher tous les lieux et points d'intérêt (POI) situés à proximité sans saisir de texte spécifique. Les utilisateurs peuvent explorer les quartiers POIs, découvrir et bien plus encore à l'aide de cette API. Cela nécessite un`QueryPosition`, qui peut représenter l'emplacement d'un appareil, la position basée sur l'IP ou le centre de la fenêtre d'affichage de la carte. Les utilisateurs peuvent également spécifier une ville ou un lieu pour biaiser les résultats en fonction des coordonnées géographiques de cet emplacement.
## Cas d'utilisation potentiels
+ **Explorez les environs POIs :** consultez tous les points d'intérêt situés à proximité de la position actuelle.
+ **Explorez les lieux à proximité :** Afficher tous les emplacements ou lieux proches d'une position donnée.
## Exemples
### Rechercher à proximité à partir d'une position
Dans cet exemple, la recherche est effectuée à partir d'une position à Dubaï située à 25,26951 de latitude et 55,30884 de longitude.
------
#### [ Sample request ]
```
{
"QueryPosition": [
55.30884,
25.26951
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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": "",
"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
```
------
# Comment rechercher des lieux à proximité en fonction de la catégorie
L' SearchNearby API permet de rechercher des points d'intérêt (POI) en incluant ou en excluant des catégories spécifiques. Cela peut aider les utilisateurs à explorer les quartiers, à découvrir les quartiers locaux POIs, etc. L'API nécessite un`QueryPosition`, qui peut être basé sur l'emplacement d'un appareil, la position IP ou le centre de la fenêtre cartographique. Les utilisateurs peuvent également spécifier une ville ou un lieu, et l'application biaisera les résultats en fonction des coordonnées de cet emplacement.
Pour en savoir plus sur les catégories prises en charge, consultez[Filtres par catégories](places-filtering.md#place-categories).
## Cas d'utilisation potentiels
+ **Explorez les installations locales :** trouvez les installations disponibles dans un quartier.
+ **Découvrez les attractions touristiques :** identifiez les sites touristiques d'une ville.
+ **Planifiez votre voyage dans une ville :** organisez différents déplacements POIs au sein d'une ville donnée.
## Exemples
### Inclure la catégorie
------
#### [ Sample request ]
```
{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"IncludeCategories": ["airport"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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": "",
"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
```
------
### Exclure une catégorie
------
#### [ Sample request ]
```
{
"QueryPosition": [
4.35609,
50.84439
],
"Filter": {
"ExcludeCategories": ["airport"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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": "",
"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
```
------
# Comment rechercher des lieux à proximité en fonction du type de nourriture
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
+ 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
### Rechercher des lieux à proximité par type de nourriture
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": "",
"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
+ Vous pouvez l'utiliser `ExludeFoodTypes` pour exclure certaines chaînes commerciales de vos résultats.
+ Vous pouvez exclure ou inclure plusieurs types d'aliments.
# Comment effectuer une recherche à proximité en fonction de la chaîne d'entreprises
L' SearchNearby API vous permet d'interroger les chaînes commerciales voisines. Vous pouvez inclure ou exclure des chaînes commerciales spécifiques dans votre recherche. Cette fonctionnalité permet aux utilisateurs finaux d'explorer les quartiers, de découvrir des points d'intérêt, etc.
Pour utiliser l' SearchNearby API, vous devez fournir un QueryPosition, qui peut être :
+ Une position de l'appareil
+ Une position basée sur l'IP
+ Centre de la fenêtre d'affichage d'une carte
Les utilisateurs peuvent également fournir le nom d'une ville ou d'un lieu, et l'application peut biaiser les résultats en fonction des coordonnées géographiques de cet emplacement.
Pour plus d'informations sur les chaînes commerciales prises en charge, consultez[Filtre Business Chains](places-filtering.md#business-chains).
## Cas d'utilisation potentiels
+ Découvrez les entreprises des environs
+ Développez votre activité en trouvant des clients B2B à proximité
## Exemples
### Rechercher des lieux à proximité par chaîne d'entreprises
L'exemple suivant montre comment rechercher des établissements Starbucks à proximité.
------
#### [ Sample request ]
Cette demande recherche des établissements Starbucks situés à proximité des coordonnées spécifiées.
```
{
"QueryPosition": [
12.49563,
41.90325
],
"Filter" : {
"IncludeBusinessChains": ["Starbucks"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
## Conseils aux développeurs
+ Vous pouvez l'utiliser `ExcludeBusinessChains` pour exclure certaines chaînes commerciales de vos résultats.
+ Vous pouvez exclure ou inclure plusieurs chaînes commerciales.
# Comment effectuer une recherche à proximité dans un pays
L' SearchNearby API vous permet de rechercher des lieux proches dans un pays spécifique. Pour utiliser l'API, vous devez fournir un QueryPosition, qui peut être :
+ Une position de l'appareil
+ Une position basée sur l'IP
+ Centre de la fenêtre d'affichage d'une carte
Les utilisateurs peuvent également fournir un nom de ville ou un lieu, et l'application peut biaiser les résultats en fonction des coordonnées géographiques de cet emplacement.
## Cas d'utilisation potentiels
+ Explorez les entreprises d'un pays
+ Trouvez des clients B2B à proximité dans un pays
+ Explorez les lieux touristiques d'un pays
## Exemples
### Rechercher des parcours de golf au Canada
L'exemple suivant montre comment rechercher des parcours de golf au Canada à proximité de coordonnées spécifiées.
------
#### [ Sample request ]
Cette demande recherche des terrains de golf situés au Canada à proximité de l'emplacement indiqué.
```
{
"QueryPosition": [
-122.741803,
49.002478
],
"Filter" : {
"IncludeCategories": ["golf_course"],
"IncludeCountries": ["CAN"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
# Comment effectuer une recherche à proximité à l'aide du contexte géospatial
L' SearchNearby API vous permet d'explorer les environs, tout en limitant les résultats dans un contexte géospatial (tel qu'un cercle ou un cadre de délimitation).
L' SearchNearby API vous permet de filtrer les résultats à l'aide de contextes géospatiaux tels que des cercles et des cadres de délimitation. En définissant ces limites géographiques, vous pouvez limiter les résultats de recherche à des zones spécifiques.
## Cas d'utilisation potentiels
+ Limiter les résultats de recherche à une zone géographique spécifique
+ Effectuez des recherches dans des limites définies sur mesure
+ Concentrez les résultats sur des quartiers ou districts ciblés
## Exemples
### Recherche à l'aide du rayon de requête
L'exemple suivant montre comment rechercher des écoles dans un rayon de 1 000 mètres autour des coordonnées spécifiées.
------
#### [ Sample request ]
Cette demande recherche des écoles dans un rayon de 1 000 mètres (1 kilomètre).
```
{
"QueryPosition": [
-122.741803,
49.002478
],
"QueryRadius":1000,
"Filter" : {
"IncludeCategories": ["school"]
}
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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"]}'
```
------
## Conseils aux développeurs
+ Vous pouvez également utiliser un filtre à cadre de délimitation.