기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SearchText API를 사용하면 사용자가 전화번호를 사용하여 장소를 검색할 수 있으며, 국제 형식과 현지 형식을 모두 지원합니다. 사용자는 디바이스 위치, IP 주소 또는 맵 뷰포트 센터를 기반으로 위치를 설정하거나 지리 좌표를 기반으로 결과를 구체화할 도시 또는 위치를 지정하여 결과를 편향시킬 수 있습니다.
잠재적 사용 사례
이 예제에서는 BC주 밴쿠버의 바이어스 위치에서 전화번호 "+1 778-655-9554"을 사용하여 밴쿠버 수족관이 검색됩니다.
- Sample request
-
{
"QueryText": "+1 778-655-9554",
"BiasPosition": [
-123.11336,
49.26038
]
}
- Sample response
-
{
"ResultItems": [
{
"PlaceId": "<Redacted>",
"PlaceType": "PointOfInterest",
"Title": "Vancouver Aquarium",
"Address": {
"Label": "Vancouver Aquarium, 834 Avison Way, 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": "Avison Way",
"StreetComponents": [
{
"BaseName": "Avison",
"Type": "Way",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "834"
},
"Position": [
-123.13049,
49.30013
],
"Distance": 4591,
"Categories": [
{
"Id": "aquarium",
"Name": "Aquarium",
"LocalizedName": "Aquarium",
"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": "+1 778-655-9554",
"BiasPosition": [
-123.11336,
49.26038
]
}'
- AWS CLI
-
aws geo-places search-text --key ${YourKey} --query-text "+1 778-655-9554" --bias-position -123.11336 49.26038