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 um lugar usando informações de contato
<a name="how-to-search-for-place-using-contact-info"></a>

A SearchText API permite que os usuários pesquisem um local usando um número de telefone, suportando formatos internacionais e locais. Os usuários podem desviar os resultados definindo uma posição com base na localização do dispositivo, no endereço IP ou no centro da janela do mapa, ou especificando uma cidade ou local para refinar os resultados com base nas coordenadas geográficas.

## Casos de uso possíveis
<a name="potential-use"></a>
+ **Localizar um local com um número de telefone:** encontre um POI usando seu número de contato para recuperar seu endereço.

## Exemplos
<a name="search-by-contact-examples"></a>

### Pesquisar usando número de telefone
<a name="search-by-phone-number"></a>

Neste exemplo, o Aquário de Vancouver é pesquisado usando seu número de telefone, “\$11 778-655-9554”, a partir de uma posição de desvio em Vancouver, BC.

------
#### [ 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
```

------