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 un lieu, un POI ou une entreprise à l'aide d'un nom
L' SearchText API permet aux utilisateurs de rechercher un lieu, un POI ou une entreprise par son nom, en utilisant la saisie de texte libre. Les résultats peuvent être affinés en définissant une position de biais, qui peut être basée sur l'emplacement de l'appareil, la position IP ou le centre de la fenêtre d'affichage de la carte. Les utilisateurs peuvent également indiquer une ville ou un lieu spécifique, les résultats étant biaisés en fonction des coordonnées géographiques fournies.
Cas d'utilisation potentiels
-
Localiser un lieu par son nom : recherchez des emplacements en fonction des noms de lieux, tels que « Gas Town ».
-
Trouver des points d'intérêt (POIs) : recherchez des lieux d'intérêt par leur nom, comme « Stanley Park ».
-
Recherche par nom d'entreprise : localisez les entreprises par leur nom, par exemple « Starbucks ».
Exemples
- Sample request
-
{
"QueryText": "Gas Town",
"BiasPosition": [
-123.11336,
49.26038
]
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "District",
"Title": "Gastown, Vancouver, BC, Canada",
"Address": {
"Label": "Gastown, Vancouver, BC, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Gastown",
"PostalCode": "V6B"
},
"Position": [
-123.10647,
49.28363
],
"Distance": 2633,
"MapView": [
-123.11193,
49.28141,
-123.10217,
49.28648
]
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "Gas Town",
"BiasPosition": [
-123.11336,
49.26038
]
}'
- AWS CLI
-
aws geo-places search-text --key ${YourKey} --query-text "Gas Town" --bias-position -123.11336 49.26038
- Sample request
-
{
"QueryText": "Stanley Park",
"BiasPosition": [
-123.11336,
49.26038
]
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Title": "Stanley Park",
"Address": {
"Label": "Stanley Park, Stanley Park Dr, Vancouver, BC V6G, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Stanley Park",
"PostalCode": "V6G",
"Street": "Stanley Park Dr",
"StreetComponents": [
{
"BaseName": "Stanley Park",
"Type": "Dr",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
]
},
"Position": [
-123.13593,
49.29716
],
"Distance": 4405,
"Categories": [
{
"Id": "park-recreation_area",
"Name": "Park-Recreation Area",
"LocalizedName": "Park-Recreation Area",
"Primary": true
},
{
"Id": "tourist_attraction",
"Name": "Tourist Attraction",
"LocalizedName": "Tourist Attraction",
"Primary": false
}
]
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "Stanley Park",
"BiasPosition": [
-123.11336,
49.26038
]
}'
- AWS CLI
-
aws geo-places search-text --key ${YourKey} --query-text "Stanley Park" --bias-position -123.11336 49.26038
- Sample request
-
{
"QueryText": "Amazon YVR11",
"BiasPosition": [
-123.11336,
49.26038
]
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Title": "Amazon YVR11",
"Address": {
"Label": "Amazon YVR11, 510 W Georgia St, Vancouver, BC V6B 0M3, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Downtown Vancouver",
"PostalCode": "V6B 0M3",
"Street": "W Georgia St",
"StreetComponents": [
{
"BaseName": "Georgia",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "510"
},
"Position": [
-123.11694,
49.28126
],
"Distance": 2336,
"Categories": [
{
"Id": "business_facility",
"Name": "Business Facility",
"LocalizedName": "Business Facility",
"Primary": true
}
],
"AccessPoints": [
{
"Position": [
-123.11656,
49.28151
]
}
]
}
]
}
- cURL
-
curl --request POST \
--url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \
--header 'Content-Type: application/json' \
--data '{
"QueryText": "Amazon YVR11",
"BiasPosition": [
-123.11336,
49.26038
]
}'
- AWS CLI
-
aws geo-places search-text --key ${YourKey} --query-text "Amazon YVR11" --bias-position -123.11336 49.26038
