Googlemapv3中文文档及一些示例

地址解析请求 Google Maps API 需要调用外部服务器，因此，对地址解析服务的访问是异步的。为此，您需要传递一个回调方法，以在请求完成后执行。此回调方法将会对结果进行处理。请注意，地址解析器可能返回多个结果。 您可以通过在代码中使用 google.maps.Geocoder 对象，访问 Google Maps API 地址解析服务。Geocoder.geocode() 方法发起地址解析服务请求，方法是向地址解析服务传递 GeocodeRequest 对象常量，其中包含输入内容和一个回调方法，该回调方法将会在收到响应后执行。 GeocodeRequest 对象常量包含下列字段： { address: string, latLng: LatLng, bounds: LatLngBounds, language: string, region: string, }下面对这些字段进行了说明。 ?address（必填）- 您要进行地址解析的地址。* ?latLng（必填*）— 您希望获取的距离最近的人类可读地址的 LatLng 。?bounds（可选）— 要在其中更显著地偏移地址解析结果的 LatLngBounds。（有关详细信息，请参见下文的可视区域偏向。） ?language（可选）- 传回结果时所使用的语言。?region（可选）- 指定为 IANA 语言 region 子标记的区域代码。在大多数情况下，这些标记直接映射到熟悉的 ccTLD（“顶级域”）双字符值。（有关详细信息，请参见下文的区域代码偏向。） * 请注意：您可以传递 address 或 latLng 进行查找。（如果传递 latLng，则地址解析器执行反向地址解析。有关详细信息，请参阅反向地址解析。） bounds 和 region 参数只会影响地址解析器返回的结果，但不能对其进行完全限制。 地址解析响应 地址解析服务要求一个回调方法，以在检索到地址解析器返回的结果后执行。此回调应依次传递两个参数，以分别存放 results 和 status 代码。地址解析器可能返回多个条目，因此，GeocoderResults 对象常量是一个数组。 地址解析结果 GeocoderResults 对象常量表示一个地址解析结果，并且是采用以下形式的对象： results[]: { types[]: string, formatted_address: string, address_components[]: { short_name: string, long_name: string, types[]: string }, geometry: { location: LatLng, location_type: GeocoderLocationType viewport: LatLngBounds, bounds: LatLngBounds } }下面对这些字段进行了说明： ?types[] 是一个数组，表示返回结果的类型。此数组包含一个或多个标签，这些标签标识结果中返回的特征的类型。例如，对“Chicago”的地址解析返回“locality”，表示“Chicago”是一个城市；同时返回“political”，表示它是一个政治实体。 ?formatted_address 是一个字符串，包含此位置的人类可读地址。通常该地址相当于“邮政地址”，有时会因不同国家/地区而存在差异。（请注意，部分国家/地区会有许可限制，禁止发布真实的邮政地址，如英国。）此地址通常由一个或多个地址部分组成。例如，地址“111 8th Avenue, New York, NY”包含三个地址组成部分，即“111 8th Avenue”（街道地址）、“New York”（城市）和“NY”（美国的一个州）。下面对各地址组成部分进行了说明。（有关类型的详细信息，请参阅下面的类型。） ?address_component[] 是一个包含多个地址组成部分（如上文所述）的数组。 ?geometry 包含以下信息： ?location 包含地址解析生成的纬度值和经度值。请注意，我们以 LatLng 对象的形式返回此位置，而不是以某种格式的字符串形式返回。 ?location_type 存储有关指定位置的附加数据。当前支持以下值： ■google.maps.GeocoderLocationType.ROOFTOP 表示地址解析返回了精确的结果。 ■google.maps.GeocoderLocationType.RANGE_INTERPOLATED 表示返回的结果是一个近似值（通常表示某条道路上的地址），该地址处于两个精确点（如十字路口）之间。当无法对街道地址进行精确的地址解析时，通常会返回近似结果。 ■google.maps.GeocoderLocationType.GEOMETRIC_CENTER 表示返回的结果是折线（如街道）或多边形（区域）等内容的几何中心。 ■google.maps.GeocoderLocationType.APPROXIMATE 表示返回的结果是一个近似值。 ?viewport 存储建议的视口（用于返回的结果）。 ?bounds（可选择返回）存储可完全包含返回结果的 LatLngBounds。请注意，这些范围可能与建议的视口不相符。（例如，旧金山包含费拉隆岛。该岛实际上是旧金山市的一部分，但不应该在视口内返回。）