谷歌地图地标对象的权威参考答案

【问题标题】：Definitive reference for Google Maps Placemark object谷歌地图地标对象的权威参考
【发布时间】：2009-07-10 11:33:03
【问题描述】：

我正在使用以下方法对 google maps latlng 进行反向地理编码：

[GClientGeocoder.getLocations(address:String, callback:function)][1]

其中规定如下：

由于此方法需要调用 Google 服务器，因此您还必须传递回调方法来处理响应。此响应将包含一个状态代码，如果成功，则包含一个或多个 Placemark 对象。

任何人都可以向我指出什么是 Placemark 对象的明确参考，因为它似乎为不同的位置返回不同的属性。例如有时我会得到一个 ThoroughfareName，而其他人会得到一个 AddressLine。我想了解我是否总是会得到其中的一个，以及它们是否可以互换。

【问题讨论】：

标签： javascript google-maps geocoding

【解决方案1】：

This page 来自 Google Maps API 文档，其中包含对 Placemark 对象是什么的非常简单的解释。

但是，您可能要关注的部分是它说明 Google 对 Placemark 中的 AddressDetails 对象使用的格式，即 xAL (可扩展地址语言）。那里有一个规范的链接，它指向一个可下载的模式（xsd 文件），它基本上定义了整个格式。一个警告：规范相当广泛，但您可能不需要为您的项目担心太多。

编辑：
很抱歉不允许为您添加相关页面的链接。

【讨论】：

谢谢，这或多或少是我想要的。我正在查看 API 参考，并希望从那里得到一个链接。 xAL 似乎非常灵活，答案是 google 填充它的方式，这可能在任何地方都不可用。我可能会保持简单，并假设通道名称和地址线是可互换的。

【解决方案2】：

您必须寻找它，但 Google 确实隐藏了 some documentation about Placemarks。

【讨论】：

【解决方案3】：

地标对象的内容会因可用数据而异。我发现找出我得到的结果的最佳方法是到use JSON.stringify 来检查响应（用于调试）：

function onGeocode (resp)
{
    document.getElementById("cd_output").innerHTML = JSON.stringify (resp);
}

当我对澳大利亚悉尼的地址进行地理编码时，这给了我以下结果：

Placemark
{
    id, address, 
    AddressDetails
    {
        Country, CountryNameCode, CountryName, 
        AdministrativeArea
        {
            AdministrativeAreaName, 
            Locality
            {
                LocalityName
                Thoroughfare { ThoroughfareName }
                PostalCode { PostalCodeNumber }
            }
        }
    }
    Accuracy,
    ExtendedData
    {
        LatLonBox { north,south,east,west }
        Point { coordinates }
    }
}

【讨论】：

谢谢，我发现使用 firebug 也是一种查看结果的好方法。