As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Como pesquisar contatos e horários de funcionamento
A API `SearchText` permite pesquisar contatos e horários de funcionamento de um POI (ponto de interesse).
Uma forma de usar a SearchText API é obter as informações de contato de um local (número de telefone, site, e-mail) e horário de funcionamento pesquisando com o nome da empresa e a posição tendenciosa. Essas posições de desvio podem ser a posição do dispositivo, posição de IP, centro da janela do mapa. Outra forma é permitir que os usuários finais informem o nome da cidade ou do local, e a aplicação pode desviar os resultados com base nas coordenadas geográficas.
Para obter mais informações, consulte [Contatos e horários de funcionamento](contacts-opening-hours.md).
## Casos de uso possíveis
Você pode usar a API `SearchText` para filtrar contatos e horários de funcionamento.
## Exemplos
### Pesquisar por nome da categoria
------
#### [ 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"
```
------