기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 이름을 사용하여 장소, POI 또는 회사를 검색하는 방법
SearchText API를 사용하면 사용자가 자유 텍스트 입력을 사용하여 이름별로 장소, POI 또는 회사를 검색할 수 있습니다. 디바이스 위치, IP 위치 또는 맵 뷰포트 중심을 기반으로 바이어스 위치를 설정하여 결과를 구체화할 수 있습니다. 또는 사용자가 특정 도시 또는 장소를 제공할 수 있으며, 결과는 제공된 지역 좌표에 따라 편향됩니다.
## 가능한 사용 사례
+ **이름으로 장소 찾기:** "Gas Town"과 같은 장소 이름을 기준으로 위치를 검색합니다.
+ **관심 지점(POI) 찾기:** "Stanley Park"와 같이 이름으로 관심 장소를 검색합니다.
+ **회사 이름으로 검색:** "Starbucks"와 같은 이름으로 회사를 찾습니다.
## 예제
### 장소 이름으로 검색
------
#### [ Sample request ]
```
{
"QueryText": "Gas Town",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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
```
------
### POI 이름으로 검색
------
#### [ Sample request ]
```
{
"QueryText": "Stanley Park",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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": "",
"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
```
------