Definitive ссылка на объект Google Maps Placemark

Question

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

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

которая гласит следующее:

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

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

Answer 1

This page от документации по Google Maps API, и содержит довольно простое объяснение, что такое Placemark объект.

Однако часть, которую вы, вероятно, хотите, чтобы сосредоточить внимание на то, где он утверждает, что формат использует Google для AddressDetails объекта в Placemark, который Xal (расширяемый Адрес Language). Существует ссылка на спецификацию, которая приводит к загружаемой схеме (xsd-файл), которая по существу определяет весь формат. Слово предупреждения: спецификация довольно обширна, но вам может не потребоваться многого для ее проекта.

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

Answer 2

Вам нужно охотиться за ним, но у Google есть some documentation about Placemarks спрятанные.

Answer 3

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