기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# SearchText 사용 방법
이 섹션에는 SearchText API 사용 방법을 안내하는 다양한 방법과 예제가 포함되어 있습니다.
**Topics**
+ [
# 이름을 사용하여 장소, POI 또는 회사를 검색하는 방법
](how-to-search-for-place-poi-business.md)
+ [
# 연락처 정보를 사용하여 장소를 검색하는 방법
](how-to-search-for-place-using-contact-info.md)
+ [
# 범주 이름 또는 음식 유형을 사용하여 검색하는 방법
](how-to-search-category-name.md)
+ [
# 주소를 검색하는 방법
](how-to-search-address.md)
+ [
# 국가 내에서 장소를 검색하는 방법
](how-to-search-place-in-country.md)
+ [
# 연락처 및 운영 시간을 검색하는 방법
](how-to-search-opening-hours.md)
+ [
# 쿼리 ID를 사용하여 장소를 검색하는 방법
](how-to-search-query-id.md)
+ [
# 특정 언어로 검색하는 방법
](how-to-search-specific-language.md)
# 이름을 사용하여 장소, 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
```
------
# 연락처 정보를 사용하여 장소를 검색하는 방법
SearchText API를 사용하면 사용자가 전화번호를 사용하여 장소를 검색할 수 있으며, 국제 형식과 현지 형식을 모두 지원합니다. 사용자는 디바이스 위치, IP 주소 또는 맵 뷰포트 중심을 기반으로 위치를 설정하거나 지리 좌표를 기반으로 결과를 구체화할 도시 또는 장소를 지정하여 결과를 편향시킬 수 있습니다.
## 가능한 사용 사례
+ **전화번호로 장소 찾기:** 연락처 번호로 주소를 검색하여 POI를 찾습니다.
## 예제
### 전화번호를 사용하여 검색
이 예제에서는 Vancouver, BC의 바이어스 위치에서 전화번호 "\$11 778-655-9554"를 사용하여 Vancouver Aquarium을 검색합니다.
------
#### [ Sample request ]
```
{
"QueryText": "+1 778-655-9554",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"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
```
------
# 범주 이름 또는 음식 유형을 사용하여 검색하는 방법
`SearchText` API를 사용하면 레스토랑, 학교 등과 같은 범주 이름을 기준으로 검색할 수 있습니다. 또한 음식 유형별로 검색할 수도 있습니다.
SearchText API를 사용하는 한 가지 방법은 최종 사용자가 이름(범주 및 음식 유형)과 애플리케이션 세트의 바이어스 위치를 기준으로 검색할 수 있도록 하는 것입니다. 이러한 바이어스 위치는 디바이스 위치, IP 위치 또는 맵의 뷰 포트 중심일 수 있습니다. 또한 최종 사용자는 도시 이름이나 장소를 제공할 수 있으며 애플리케이션은 지역 좌표에 따라 결과를 편향시킬 수 있습니다.
자세한 내용은 [카테고리 필터](places-filtering.md#place-categories) 및 [음식 종류 필터](places-filtering.md#food-type) 섹션을 참조하세요.
## 가능한 사용 사례
+ 주변 지역 탐색의 일환으로 특정 POI 또는 장소를 검색합니다.
+ 여행 계획을 위한 특정 여행지를 검색합니다.
+ 특정 음식을 제공하는 레스토랑을 검색합니다.
## 예제
### 범주 검색
------
#### [ Sample request ]
```
{
"QueryText": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
],
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Diamond Geriatrics Inc",
"Address": {
"Label": "Diamond Geriatrics Inc, 288 W 8th Ave, Vancouver, BC V5Y 1N5, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Mt Pleasant",
"PostalCode": "V5Y 1N5",
"Street": "W 8th Ave",
"StreetComponents": [
{
"BaseName": "8th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "288"
},
"Position": [
-123.11061,
49.2636
],
"Distance": 410,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "social_service",
"Name": "Social Service",
"LocalizedName": "Social Services",
"Primary": false
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Para Med Home Health Care",
"Address": {
"Label": "Para Med Home Health Care, 601 W Broadway, Vancouver, BC V5Z 4C2, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Fairview",
"PostalCode": "V5Z 4C2",
"Street": "W Broadway",
"StreetComponents": [
{
"BaseName": "Broadway",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "601"
},
"Position": [
-123.11772,
49.26343
],
"Distance": 464,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "hospital_or_health_care_facility",
"Name": "Hospital or Health Care Facility",
"LocalizedName": "Hospital or Health Care Facility",
"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": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Nursing Home" --bias-position -123.11336 49.26038
```
------
### 음식 유형 검색
`QueryText`에 음식 유형을 지정하여 음식 유형별로 레스토랑을 선택합니다. 음식 유형별로 필터링하면 음식 유형에 따라 레스토랑을 인덱싱, 쿼리 및 표시할 수 있습니다.
------
#### [ Sample request ]
```
{
"QueryText": "Sushi",
"BiasPosition": [
-123.11336,
49.26038
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Sushi Tomy",
"Address": {
"Label": "Sushi Tomy, 555 W 12th Ave, Vancouver, BC V5Z 3X7, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Fairview",
"PostalCode": "V5Z 3X7",
"Street": "W 12th Ave",
"StreetComponents": [
{
"BaseName": "12th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "555"
},
"Position": [
-123.11629,
49.26086
],
"Distance": 219,
"Categories": [
{
"Id": "deli",
"Name": "Deli",
"LocalizedName": "Deli",
"Primary": true
},
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": false
},
{
"Id": "casual_dining",
"Name": "Casual Dining",
"LocalizedName": "Casual Dining",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Japanese - Sushi",
"Id": "japanese-sushi",
"Primary": true
},
{
"LocalizedName": "Canadian",
"Id": "canadian",
"Primary": false
},
{
"LocalizedName": "Japanese",
"Id": "japanese",
"Primary": false
}
]
},
{
"PlaceId": ""
"PlaceType": "PointOfInterest",
"Title": "Shiro Japanese Restaurant",
"Address": {
"Label": "Shiro Japanese Restaurant, 3096 Cambie St, Vancouver, BC V5Z 2V9, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Mt Pleasant",
"PostalCode": "V5Z 2V9",
"Street": "Cambie St",
"StreetComponents": [
{
"BaseName": "Cambie",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "3096"
},
"Position": [
-123.11461,
49.25797
],
"Distance": 283,
"Categories": [
{
"Id": "casual_dining",
"Name": "Casual Dining",
"LocalizedName": "Casual Dining",
"Primary": true
},
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Japanese - Sushi",
"Id": "japanese-sushi",
"Primary": true
},
{
"LocalizedName": "Asian",
"Id": "asian",
"Primary": false
},
{
"LocalizedName": "Japanese",
"Id": "japanese",
"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": "Sushi",
"BiasPosition": [
-123.11336,
49.26038
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Sushi" --bias-position -123.11336 49.26038
```
------
# 주소를 검색하는 방법
`SearchText` API를 사용하면 주소를 검색할 수 있습니다.
SearchText API를 사용하는 한 가지 방법은 최종 사용자가 주소와 애플리케이션 세트의 바이어스 위치를 검색할 수 있도록 하는 것입니다. 이러한 바이어스 위치는 디바이스 위치, IP 위치 또는 맵의 뷰 포트 중심일 수 있습니다. 또한 최종 사용자는 도시 이름이나 장소를 제공할 수 있으며 애플리케이션은 지역 좌표에 따라 결과를 편향시킬 수 있습니다.
## 잠재적 사용 사례
+ 바이어스 위치를 기반으로 주소를 검색합니다.
+ 특정 주소를 포함하거나 제거하도록 결과를 필터링합니다.
## 예제
### 주소 검색
------
#### [ Sample request ]
```
{
"QueryText":"1368 E 8 Ave Vancouver",
"BiasPosition":[
-123.18544,
49.24643
],
"MaxResults":1
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointAddress",
"Title": "1368 E 8th Ave, Vancouver, BC V5N 1T2, Canada",
"Address": {
"Label": "1368 E 8th Ave, Vancouver, BC V5N 1T2, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Grandview-Woodland",
"PostalCode": "V5N 1T2",
"Street": "E 8th Ave",
"StreetComponents": [
{
"BaseName": "8th",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Prefix": "E",
"Language": "en"
}
],
"AddressNumber": "1368"
},
"Position": [
-123.07612,
49.26306
],
"Distance": 8147,
"MapView": [
-123.07752,
49.26299,
-123.05661,
49.26334
]
}
]
}
```
------
#### [ 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": "1368 E 8 Ave Vancouver",
"BiasPosition": [
-123.18544,
49.24643
],
"MaxResults": 1
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "1368 E 8 Ave Vancouver" --bias-position -123.18544 49.24643 --max-results 1
```
------
# 국가 내에서 장소를 검색하는 방법
`SearchText` API를 사용하면 검색 결과를 하나 이상의 국가로 제한할 수 있습니다. 이 기능은 경계 영역 또는 서로 인접한 작은 국가에서 검색하는 데 유용합니다.
SearchText API를 사용하는 한 가지 방법은 최종 사용자가 자유 텍스트 검색과 애플리케이션 세트의 바이어스 위치를 수행하도록 하는 것입니다. 이러한 바이어스 위치는 디바이스 위치, IP 위치 또는 맵의 뷰 포트 중심일 수 있습니다. 또한 최종 사용자는 도시 이름이나 장소를 제공할 수 있으며 애플리케이션은 지역 좌표에 따라 결과를 편향시킬 수 있습니다.
## 잠재적 사용 사례
+ 가까운 국경이 있는 지역의 경우 검색 결과를 국가 내로 제한합니다.
+ 여러 국가 내에서 결과를 필터링합니다.
## 예제
### 국가 내에서 검색
이 예제에서 바이어스 위치는 미국 및 캐나다 경계 근처에 있습니다. `IncludeCountries": ["CAN"]`을 지정하지 않으면 API는 캐나다와 미국의 결과를 모두 반환합니다.
------
#### [ Sample request ]
```
{
"QueryText": "Starbucks",
"BiasPosition": [
-122.741803,
49.002478
]
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "STARBUCKS",
"Address": {
"Label": "STARBUCKS, 16010 24 Ave, Surrey, BC V3Z 0R5, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Surrey",
"District": "South Surrey",
"PostalCode": "V3Z 0R5",
"Street": "24 Ave",
"StreetComponents": [
{
"BaseName": "24",
"Type": "Ave",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "16010"
},
"Position": [
-122.77867,
49.04482
],
"Distance": 5422,
"Categories": [
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Coffee Shop",
"Primary": true
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "STARBUCKS",
"Address": {
"Label": "STARBUCKS, 1730 152 St, Surrey, BC V4A 4N4, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Surrey",
"District": "South Surrey",
"PostalCode": "V4A 4N4",
"Street": "152 St",
"StreetComponents": [
{
"BaseName": "152",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "1730"
},
"Position": [
-122.80096,
49.03341
],
"Distance": 5517,
"Categories": [
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Coffee Shop",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Starbucks",
"Id": "Starbucks"
}
]
},
...
...
]
}
```
------
#### [ 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": "Starbucks",
"BiasPosition": [
-122.741803,
49.002478
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Starbucks" --bias-position -122.741803 49.002478
```
------
# 연락처 및 운영 시간을 검색하는 방법
`SearchText` API를 사용하면 POI(관심 지점)의 연락처 및 운영 시간을 검색할 수 있습니다.
SearchText API를 사용하는 한 가지 방법은 비즈니스 이름 및 바이어스 위치로 검색하여 위치(전화번호, 웹 사이트, 이메일) 및 운영 시간에 대한 연락처 정보를 가져오는 것입니다. 이러한 바이어스 위치는 디바이스 위치, IP 위치, 맵의 뷰 포트 중심일 수 있습니다. 또 다른 방법은 최종 사용자가 도시 이름 또는 장소 이름을 제공하도록 하는 것이며 애플리케이션은 지리 좌표에 따라 결과를 편향시킬 수 있습니다.
자세한 내용은 [연락처 및 운영 시간](contacts-opening-hours.md) 단원을 참조하십시오.
## 잠재적 사용 사례
`SearchText` API를 사용하여 연락처 및 운영 시간을 필터링할 수 있습니다.
## 예제
### 범주 이름으로 검색
------
#### [ Sample request ]
```
{
"QueryText": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
],
"AdditionalFeatures":["Contact"]
}
```
------
#### [ Sample response ]
```
{
"PricingBucket": "Advanced",
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Para Med Home Health Care",
"Address": {
"Label": "Para Med Home Health Care, 601 W Broadway, Vancouver, BC V5Z 4C2, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Fairview",
"PostalCode": "V5Z 4C2",
"Street": "W Broadway",
"StreetComponents": [
{
"BaseName": "Broadway",
"Prefix": "W",
"Language": "en"
}
],
"AddressNumber": "601"
},
"Position": [
-123.11771,
49.26341
],
"Distance": 462,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "hospital_or_health_care_facility",
"Name": "Hospital or Health Care Facility",
"LocalizedName": "Hospital or Health Care Facility",
"Primary": false
}
],
"Contacts": {
"Phones": [
{
"Value": "+16045634663"
},
{
"Value": "+16047311594",
"Categories": [
{
"Id": "hospital_or_health_care_facility",
"Name": "Hospital or Health Care Facility"
}
]
}
],
"Websites": [
{
"Value": "http://www.rightathomecanada.com/vancouver",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "https://www.facebook.com/507123162974954",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
}
]
}
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Yaletown House",
"Address": {
"Label": "Yaletown House, 1099 Cambie St, Vancouver, BC V6B 5A8, Canada",
"Country": {
"Code2": "CA",
"Code3": "CAN",
"Name": "Canada"
},
"Region": {
"Code": "BC",
"Name": "British Columbia"
},
"SubRegion": {
"Name": "Metro Vancouver"
},
"Locality": "Vancouver",
"District": "Yaletown",
"PostalCode": "V6B 5A8",
"Street": "Cambie St",
"StreetComponents": [
{
"BaseName": "Cambie",
"Type": "St",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "1099"
},
"Position": [
-123.11949,
49.27533
],
"Distance": 1721,
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home",
"LocalizedName": "Nursing Home",
"Primary": true
},
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": false
},
{
"Id": "clothing_and_accessories",
"Name": "Clothing and Accessories",
"LocalizedName": "Clothing & Accessories",
"Primary": false
},
{
"Id": "market",
"Name": "Market",
"LocalizedName": "Market",
"Primary": false
},
{
"Id": "jeweler",
"Name": "Jeweler",
"LocalizedName": "Jeweler",
"Primary": false
},
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research",
"LocalizedName": "Advertising/Marketing, PR & Market Research",
"Primary": false
},
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services",
"LocalizedName": "Management and Consulting Services",
"Primary": false
},
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies",
"LocalizedName": "Organizations and Societies",
"Primary": false
},
{
"Id": "finance_and_insurance",
"Name": "Finance and Insurance",
"LocalizedName": "Finance and Insurance",
"Primary": false
},
{
"Id": "consumer_services",
"Name": "Consumer Services",
"LocalizedName": "Consumer Services",
"Primary": false
},
{
"Id": "attorney",
"Name": "Attorney",
"LocalizedName": "Attorney",
"Primary": false
},
{
"Id": "social_service",
"Name": "Social Service",
"LocalizedName": "Social Services",
"Primary": false
}
],
"Contacts": {
"Phones": [
{
"Value": "+16045584546",
"Categories": [
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services"
},
{
"Id": "consumer_services",
"Name": "Consumer Services"
}
]
},
{
"Value": "+16046464065",
"Categories": [
{
"Id": "finance_and_insurance",
"Name": "Finance and Insurance"
}
]
},
{
"Value": "+16046699800",
"Categories": [
{
"Id": "clothing_and_accessories",
"Name": "Clothing and Accessories"
},
{
"Id": "jeweler",
"Name": "Jeweler"
}
]
},
{
"Value": "+16046838109",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Value": "+16046841838",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
},
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services"
}
]
},
{
"Value": "+16046848898",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Value": "+16046890022"
},
{
"Value": "+16046999120",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "+16046999121",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "+16048016446",
"Categories": [
{
"Id": "management_and_consulting_services",
"Name": "Management and Consulting Services"
}
]
}
],
"Faxes": [
{
"Value": "+16046464068",
"Categories": [
{
"Id": "finance_and_insurance",
"Name": "Finance and Insurance"
}
]
},
{
"Value": "+16046627954",
"Categories": [
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies"
}
]
},
{
"Value": "+16046841801",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
}
]
},
{
"Value": "+16046848608",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
}
],
"Websites": [
{
"Value": "http://www.yaletown.org",
"Categories": [
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies"
},
{
"Id": "social_service",
"Name": "Social Service"
},
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
},
{
"Value": "http://www.yaletownhq.com",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
}
]
},
{
"Value": "http://www.yaletownlaw.ca",
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Value": "https://www.facebook.com/1509112252725564",
"Categories": [
{
"Id": "nursing_home",
"Name": "Nursing Home"
}
]
}
],
"Emails": [
{
"Value": "nina@yaletownhq.com",
"Categories": [
{
"Id": "advertising-marketing,_pr_and_market_research",
"Name": "Advertising-Marketing, PR and Market Research"
}
]
}
]
},
"OpeningHours": [
{
"Display": [
"Mon-Fri: 08:30 - 16:00"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T083000",
"OpenDuration": "PT07H30M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR"
}
],
"Categories": [
{
"Id": "organizations_and_societies",
"Name": "Organizations and Societies"
}
]
},
{
"Display": [
"Mon-Fri: 09:00 - 17:00"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T090000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH,FR"
}
],
"Categories": [
{
"Id": "attorney",
"Name": "Attorney"
}
]
},
{
"Display": [
"Tue: 10:00 - 16:30",
"Wed-Sat: 09:30 - 16:30"
],
"OpenNow": true,
"Components": [
{
"OpenTime": "T100000",
"OpenDuration": "PT06H30M",
"Recurrence": "FREQ:DAILY;BYDAY:TU"
},
{
"OpenTime": "T093000",
"OpenDuration": "PT07H00M",
"Recurrence": "FREQ:DAILY;BYDAY:WE,TH,FR,SA"
}
],
"Categories": [
{
"Id": "clothing_and_accessories",
"Name": "Clothing and Accessories"
},
{
"Id": "jeweler",
"Name": "Jeweler"
}
]
}
]
},
]
}
```
------
#### [ 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": "Nursing Home",
"BiasPosition": [
-123.11336,
49.26038
],
"AdditionalFeatures":["Contact"]
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Nursing Home" \
--bias-position -123.11336 49.26038 \
--additional-features "Contact"
```
------
# 쿼리 ID를 사용하여 장소를 검색하는 방법
`SearchText` API를 사용하면 [SuggestSuggest 사용 방법](suggest.md)에서 반환한 쿼리 결과의 세부 정보를 가져올 수 있습니다.
## 잠재적 사용 사례
`Suggestion` API에서 반환되는 쿼리 ID에 대한 검색 결과를 가져옵니다.
## 예제
### 쿼리 ID를 사용하여 검색
------
#### [ Sample request ]
```
{
"QueryId": ""
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Restore",
"Address": {
"Label": "Restore, 400 Urban Plz, Kirkland, WA 98033, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "King"
},
"Locality": "Kirkland",
"District": "Moss Bay",
"PostalCode": "98033",
"Street": "Urban Plz",
"StreetComponents": [
{
"BaseName": "Urban",
"Type": "Plz",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Language": "en"
}
],
"AddressNumber": "400"
},
"Position": [
-122.19958,
47.67822
],
"Distance": 190670,
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services",
"LocalizedName": "Wellness Center & Services",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Restore",
"Id": "Restore"
}
],
"Contacts": {
"Phones": [
{
"Value": "+14258352271"
},
{
"Value": "+14254205116"
}
],
"Websites": [
{
"Value": "https://restore.com"
},
{
"Value": "https://restore.com/locations"
},
{
"Value": "https://www.facebook.com/rhwkirkland"
},
{
"Value": "https://www.restore.com/locations/wa-kirkland-wa001?utm_source=extnet&utm_medium=Yext&y_source=1_MzE2Mjk5NTgtNTY2LWxvY2F0aW9uLndlYnNpdGU%3D"
},
{
"Value": "https://www.restore.com/sitemap.xml"
}
],
"Emails": [
{
"Value": "kirkland@restore.com"
}
]
},
"OpeningHours": [
{
"Display": [
"Mon-Thu: 10:00 - 19:00",
"Fri: 10:00 - 17:00",
"Sat: 09:00 - 17:00",
"Sun: 10:00 - 16:00"
],
"OpenNow": false,
"Components": [
{
"OpenTime": "T100000",
"OpenDuration": "PT09H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH"
},
{
"OpenTime": "T100000",
"OpenDuration": "PT07H00M",
"Recurrence": "FREQ:DAILY;BYDAY:FR"
},
{
"OpenTime": "T090000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:SA"
},
{
"OpenTime": "T100000",
"OpenDuration": "PT06H00M",
"Recurrence": "FREQ:DAILY;BYDAY:SU"
}
]
}
],
"AccessPoints": [
{
"Position": [
-122.19944,
47.67801
]
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Restore",
"Address": {
"Label": "Restore, 1520 Highlands Dr NE, Issaquah, WA 98029, United States",
"Country": {
"Code2": "US",
"Code3": "USA",
"Name": "United States"
},
"Region": {
"Code": "WA",
"Name": "Washington"
},
"SubRegion": {
"Name": "King"
},
"Locality": "Issaquah",
"District": "Issaquah Highlands",
"PostalCode": "98029",
"Street": "Highlands Dr NE",
"StreetComponents": [
{
"BaseName": "Highlands",
"Type": "Dr",
"TypePlacement": "AfterBaseName",
"TypeSeparator": " ",
"Suffix": "NE",
"Language": "en"
}
],
"AddressNumber": "1520"
},
"Position": [
-122.01868,
47.54262
],
"Distance": 209665,
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services",
"LocalizedName": "Wellness Center & Services",
"Primary": true
}
],
"BusinessChains": [
{
"Name": "Restore",
"Id": "Restore"
}
],
"Contacts": {
"Phones": [
{
"Value": "+14256518137"
}
],
"Websites": [
{
"Value": "https://restore.com",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.facebook.com/rhwissaquah",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.restore.com/locations",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.restore.com/locations/wa-issaquah-wa002?utm_source=extnet&utm_medium=Yext&y_source=1_MzE2Mjk5NTktNTY2LWxvY2F0aW9uLndlYnNpdGU%3D",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
},
{
"Value": "https://www.restore.com/sitemap.xml",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
}
],
"Emails": [
{
"Value": "issaquah@restore.com",
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
}
]
},
"OpeningHours": [
{
"Display": [
"Mon-Thu: 10:00 - 18:00",
"Fri: 10:00 - 17:00",
"Sat: 09:00 - 17:00"
],
"OpenNow": false,
"Components": [
{
"OpenTime": "T100000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:MO,TU,WE,TH"
},
{
"OpenTime": "T100000",
"OpenDuration": "PT07H00M",
"Recurrence": "FREQ:DAILY;BYDAY:FR"
},
{
"OpenTime": "T090000",
"OpenDuration": "PT08H00M",
"Recurrence": "FREQ:DAILY;BYDAY:SA"
}
],
"Categories": [
{
"Id": "wellness_center_and_services",
"Name": "Wellness Center and Services"
}
]
}
],
"AccessPoints": [
{
"Position": [
-122.01894,
47.54262
]
}
]
}
]
}
```
------
#### [ 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 '{
"QueryId": ""
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-id ""
```
------
# 특정 언어로 검색하는 방법
이 기능을 사용하면 BCP47-compliant 코드에서 선호하는 응답 언어를 선택할 수 있습니다. 이름 변형을 기반으로 쿼리 언어를 감지하고 일치하지 않는 토큰 및 모호한 사례에 선호 언어를 사용합니다. 요청된 언어가 없는 경우 **Places** API는 공식 국가 언어로 결과를 제공하지만 다른 리전에서 리전 언어의 우선 순위를 지정합니다. 요청된 언어로 주소 요소를 사용할 수 없는 경우 대체 전략으로 **Places** API가 기본 언어로 주소를 반환합니다.
## 가능한 사용 사례
한 가지 잠재적 사용 사례는 쿼리 및/또는 결과를 현지화하는 것입니다.
## 예제
### 특정 언어로 결과 가져오기
요청에 `"Language": "EN"` 줄이 없으면 결과가 히브리어로 반환됩니다.
------
#### [ Sample request ]
```
{
"QueryText": "Vegan",
"BiasPosition":[
34.78953,
32.08556
],
"Language": "EN"
}
```
------
#### [ Sample response ]
```
{
"ResultItems": [
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Rainbow",
"Address": {
"Label": "Rainbow, Ibn Gabirol 88, 6404612 Tel Aviv-Yafo, Israel",
"Country": {
"Code2": "IL",
"Code3": "ISR",
"Name": "Israel"
},
"Region": {
"Code": "TA",
"Name": "TA"
},
"SubRegion": {
"Name": "Tel Aviv"
},
"Locality": "Tel Aviv-Yafo",
"District": "The New North-Southern Area",
"PostalCode": "6404612",
"Street": "Ibn Gabirol",
"StreetComponents": [
{
"BaseName": "Ibn Gabirol",
"Language": "he-Latn"
}
],
"AddressNumber": "88"
},
"Position": [
34.78149,
32.08252
],
"Distance": 829,
"Categories": [
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": true
},
{
"Id": "fast_food",
"Name": "Fast Food",
"LocalizedName": "Fast Food",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Vegan",
"Id": "vegan",
"Primary": true
},
{
"LocalizedName": "Fast Food",
"Id": "fast_food",
"Primary": false
},
{
"LocalizedName": "Burgers",
"Id": "burgers",
"Primary": false
},
{
"LocalizedName": "Jewish/Kosher",
"Id": "jewish/kosher",
"Primary": false
}
]
},
{
"PlaceId": "",
"PlaceType": "PointOfInterest",
"Title": "Alegria",
"Address": {
"Label": "Alegria, Ibn Gabirol 165, 6203305 Tel Aviv-Yafo, Israel",
"Country": {
"Code2": "IL",
"Code3": "ISR",
"Name": "Israel"
},
"Region": {
"Code": "TA",
"Name": "TA"
},
"SubRegion": {
"Name": "Tel Aviv"
},
"Locality": "Tel Aviv-Yafo",
"District": "The Old North-Northern Area",
"PostalCode": "6203305",
"Street": "Ibn Gabirol",
"StreetComponents": [
{
"BaseName": "Ibn Gabirol",
"Language": "he-Latn"
}
],
"AddressNumber": "165"
},
"Position": [
34.78295,
32.0923
],
"Distance": 973,
"Categories": [
{
"Id": "restaurant",
"Name": "Restaurant",
"LocalizedName": "Restaurant",
"Primary": true
},
{
"Id": "coffee_shop",
"Name": "Coffee Shop",
"LocalizedName": "Coffee Shop",
"Primary": false
},
{
"Id": "specialty_food_store",
"Name": "Specialty Food Store",
"LocalizedName": "Specialty Food Store",
"Primary": false
},
{
"Id": "bakery_and_baked_goods_store",
"Name": "Bakery and Baked Goods Store",
"LocalizedName": "Bakery & Baked Goods Store",
"Primary": false
}
],
"FoodTypes": [
{
"LocalizedName": "Vegan",
"Id": "vegan",
"Primary": true
}
]
}
]
}
```
------
#### [ 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": "Vegan",
"BiasPosition":[
34.78953,
32.08556
],
"Language": "EN"
}'
```
------
#### [ AWS CLI ]
```
aws geo-places search-text --key ${YourKey} --query-text "Vegan" \
--bias-position 34.78953 32.08556 \
--language "EN"
```
------