通过用户输入城市名称检索邮政编码的最佳API(仅限美国）

Best API to retrieve zip code by user input city name (US only)?

本文关键字：API 最佳 美国 邮政编码 输入 用户 城市 检索      更新时间：2023-09-26

我有一个从中获取值的城市名称字段（即随机格式化），例如"NEW YORK"、"NEW YORK"或"NEW YORK"或"ny"。

有了该字段的值，我需要以以下格式向用户提供一个名称中有该值的城市列表：
NY–纽约市–10001
MN–纽约米尔斯–56567

效率和性能很重要。我可以使用JavaScript或PHP来检索这些数据。

到目前为止，我已经尝试使用Freebase API。下面是我使用过的一个示例查询：http://tinyurl.com/3ogpf7k

下面是我正在使用的JavaScript代码：

// App.q contains city name field's value
var query = {
    extended : 1,
    query : [{
        search : App.q,
        type : '/location/citytown',
        id : null,
        name : null,
        postal_codes : [],
        "/location/location/containedby" : [{
            "type" : "/location/us_state",
            "name": null,
            // two letters abbreviation of state
            "/common/topic/alias" : []
        }]
    }]
},
url = 'http://www.freebase.com/api/service/mqlread?callback=?&query=' + 
      encodeURIComponent(JSON.stringify(query));
$.getJSON(url, function( data ) {
    var cities, i, len, name, aliases, j, abbr, postal_code, HTML = [];
    for ( i = 0, len = data.result.length; i < len; i += 1 ) {
        // cities with names matching user's input
        if ( data.result[ i ].name.toLowerCase().indexOf( App.q ) === -1 ) continue;
        // cities that have postal_codes data available
        if ( data.result[ i ].postal_codes.length === 0 ) continue;
        name = data.result[ i ].name;
        aliases = data.result[ i ]["/location/location/containedby"][0]["/common/topic/alias"];
        postal_code = data.result[ i ].postal_codes[0];
        // find two-letters alias
        for ( j = aliases.length - 1; j >= 0; j -= 1 ) {
            if ( aliases[j].length === 2 && aliases[j] === aliases[j].toUpperCase() ) {
                 abbr = aliases[j];
            }
        }
        HTML.push( D.renderHTML( liTemplate, {
            name : name,
            abbr : abbr,
            postal_code : postal_code
        }) );
    }
    console.log( HTML.join('') );
});

然而，查询"纽约"似乎并没有返回"纽约市"。

有更好的API可以满足我的需求吗？我是否对Freebase API做了错误的事情？

UPD。另一个有用的API允许做同样的事情（尽管如此，它仍然不能满足我的需求——太多的结果，没有办法对它们进行分页）：
文档：http://www.geonames.org/export/web-services.html
示例：http://api.geonames.org/postalCodeSearch?placename=los%20angeles&username=demo&maxRows=500

谢谢！

对之前的误导性回答感到抱歉。我没有注意到您使用的是MQL扩展"search"而不是"name"属性。

主要问题是，默认的排序不是根据搜索分数（不确定原因，但事实就是这样）。这样修改你的查询应该可以解决问题：

"search":       {"query":"New York","score":null,"type_strict":"all"},
"sort":"-search.score",
"type":"/location/citytown",

sort参数按"search"子查询返回的"score"值降序排序。您还可以使用mql_filter参数进行搜索，使其甚至不考虑不符合您的约束的事情（效率稍高）。

这里记录了搜索扩展，使用的底层搜索服务的文档在这里

相关文章：