Полная ссылка для объекта Google Maps Placemark

Question

Я использую следующий метод для обратного геокодирования карт Google:

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

Что гласит:

Поскольку этот метод требует вызова сервера Google, вы также должны передать метод обратного вызова для обработки ответа. Этот ответ будет содержать код состояния и, в случае успеха, один или несколько объектов меток.

Может ли кто-нибудь указать мне на определенную ссылку на то, что такое объект метки, поскольку он, кажется, возвращает разные атрибуты для разных мест. например иногда я получаю ThoroughfareName, а другие - AddressLine. Я хотел бы понять, буду ли я всегда получать тот или иной из них и являются ли они взаимозаменяемыми.

Answer 1

Эта страница взята из документации API Карт Google и содержит довольно простое объяснение того, что представляет собой объект Placemark .

Тем не менее, часть, на которой вы, вероятно, хотите сосредоточиться, - это то, где указывается, какой формат Google использует для объекта AddressDetails в метке , которая является xAL (расширяемый адрес Язык) . Там есть ссылка на спецификацию, которая приводит к загружаемой схеме (файл xsd), которая по существу определяет весь формат. Предупреждение: спецификация довольно обширная, но вам, возможно, не придется беспокоиться о ее значении для вашего проекта.

EDIT:
Извиняюсь за то, что не позволил вам добавить ссылки на соответствующие страницы.

Answer 2

Содержимое объекта Placemark зависит от доступных данных. Я нашел лучший способ выяснить, что я получаю, это использовать 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 }
    }
}

Answer 3

Вы должны охотиться за ним, но у Google действительно есть некоторая документация о метках , скрытая.