如何通过 API 使用 Twilio 地点搜索

Question

我正在使用 Twilio API 搜索可用电话号码。通常我使用

nearNumber

来查找地理位置靠近现有电话号码的号码，但有时地理数据不可用，所以我想回退到城市搜索。

在 Twilio 网页上，我可以输入城市“圣克拉拉”，然后获得圣克拉拉或其附近的结果。但从 API 来看，这不会返回任何结果。

numbers = await this.client.availablePhoneNumbers('US').local.list({
        inLocality: 'Santa Clara',
        smsEnabled: true,
        voiceEnabled: true,
      });

过去我认为我应该使用

City, State

语法，但这也没有返回任何内容。

如何使用

inLocality

过滤器？

文档：https://www.twilio.com/docs/phone-numbers/api/availablephonenumberlocal-resource

InLocality

参数说明：

将结果限制在特定地点或城市。给定电话号码，在与该号码相同的区域内进行搜索。

Answer 1

虽然文档中没有以任何方式明确说明，但通过测试我发现

inLocality

与城市名称一起使用时是一个子过滤器，并且应在

inRegion

中包含州名称。

numbers = await this.client.availablePhoneNumbers('US').local.list({
        inLocality: 'Santa Clara',
        inRegion: 'CA',
        smsEnabled: true,
        voiceEnabled: true,
      });

当在单独的字段中提供城市/州时，它就可以工作。