Google 地图 API V3 针对移动设备进行开发

针对移动设备进行开发

Google Maps API v3 旨在实现快速加载,并可在移动设备上稳定运行。尤其是,我们已专注于针对 Android 和 iOS 手机等先进的移动设备进行开发。与桌面计算机上的传统浏览器相比,移动设备的屏幕较小。而且,移动设备通常具备独有的特定行为(例如“双指张合缩放”)。如果您想让自己的应用在移动设备上稳定运行,建议您执行以下操作:

    • 将包含您地图的 <div> 的宽度属性和高度属性都设为 100%。不过请注意,在一些旧版的桌面浏览器上使用这些值无法获得良好的显示效果。
    • 您可通过检查 DOM 中的 navigator.userAgent 属性来检测 iPhone 和 Android 设备:
      function detectBrowser() {
        var useragent = navigator.userAgent;
        var mapdiv = document.getElementById("map_canvas");  
      
        if (useragent.indexOf(‘iPhone‘) != -1 || useragent.indexOf(‘Android‘) != -1 ) {
          mapdiv.style.width = ‘100%‘;
          mapdiv.style.height = ‘100%‘;
        } else {
          mapdiv.style.width = ‘600px‘;
          mapdiv.style.height = ‘800px‘;
        }
      }  

      这样,您就可以更改特定设备的布局了,就像我们在此处更改各设备的屏幕实际使用面积一样。

    • Android 和 iOS 设备会应用以下 <meta> 标记:

      <meta name="viewport" content="initial-scale=1.0, user-scalable=no" />

      • 此设置用于指定地图应以全屏模式显示,且用户不得调整地图的大小。请注意,您需要在网页的 <head> 元素中添加此 <meta> 标记,才能使用 iPhone 的 Safari 浏览器。

      有关针对 iPhone 进行开发的详情,请参阅 Apple 的开发者文档。有关针对 Android 设备进行开发的详情,请参阅 Android 文档

      本地化

      您可以通过更改默认语言设置和设置应用的区域代码来本地化您的 Google Maps API 应用,从而根据给定的国家或地区改变应用的运行方式。

      语言本地化

      Google Maps API 在显示文本信息(如控件名称、版权声明、行车路线和地图上的标签)时,使用浏览器的首选语言设置。大多数情况下,这是首选的做法;通常您不应覆盖用户的首选语言设置。不过,如果您想要更改 Maps API 以忽略浏览器的语言设置,并使浏览器用特定语言显示信息,可以在加入 Maps API JavaScript 代码时将可选的language 参数添加到 <script> 标记,以指定要使用的语言。

      例如,要用日语显示 Maps API 应用,可以将 &language=ja 添加到 <script> 标记,如下所示:

      <script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=false&language=ja">

      注意:按照上述方式加载 API 后,不论用户的偏好设置如何,系统都会对所有用户显示日语。在设置此选项之前,请确定您确实希望这么做。
      Maps JavaScript API 还支持双向 (Bidi) 文本,即本身同时包含从左到右 (LTR) 和从右到左 (RTL) 语言字符的文本。RTL 语言的示例包括阿拉伯语、希伯来语和波斯语。通常,您应当将 dir=‘rtl‘ 添加到网页的 <html> 元素中,以指定要正确呈现的 RTL 语言网页。

      区域本地化

      默认情况下,Maps API 会根据加载 API 的主域所在的国家/地区,提供地图图块并偏向应用行为。如果您想要更改应用以提供不同的地图图块或偏向应用(例如,偏向地理编码结果使其靠近某区域),可以在加入 Maps API JavaScript 代码时将 region 参数添加到 <script> 标记中,以覆盖该默认行为。

      作为 Maps API 应用的开发者,您有责任确保针对应用托管所在的国家/地区进行正确的区域本地化,从而确保您的应用符合当地法律。

      region 参数接受 Unicode 区域子标记标识符,该标识符通常与国家/地区代码顶级域名 (ccTLD) 一对一映射。除某些明显不同之外,大多数 Unicode 区域标识符与 ISO 3166-1 代码是相同的。例如,英国的 ccTLD 为“uk”(与其域名 .co.uk 相对应),而其区域标识符则为“GB”。

      例如,要使用本地化到英国的 Maps API 应用,可将 &region=GB 添加到 <script> 标记中,如下所示:

      <script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=false?ion=GB">

      版本控制

      Google Maps API 小组会定期更新此 JavaScript API,即增加新地图项、修复错误和改进性能。所有的 API 更改均向后兼容,以确保您启动应用时使用的是当前记录的界面,且应用可在 API 更新后继续运行,而无需进行相关修改。(注意实验性 API 参考中记录的实验性地图项并不在此担保范围内。实验性地图项将在 API 文档中明确标出。)

      版本类型

      您只需使用 Maps JavaScript API 引导程序请求的 v 参数指定 API 版本,即可指明要在您应用中加载该版本。目前,系统支持以下两个选项:

      • 发行版本,可使用 v=3 或省略 v 参数来指定。
      • 实验版本,可使用 v=3.exp 来指定。该版本是以主干版本为基础的当前版本,其中包含公开发布的所有错误修复和新增地图项。
      • 编号版本,用 v=3.number 表示,指定了 API 的地图项集。

      下面的引导程序请求演示了如何请求具体版本的 Maps JavaScript API:

      http://maps.googleapis.com/maps/api/js?v=3.9&sensor=true_or_false

      每个季度,我们都会构建新的编号版本(“发行版本”),并进行发布以供公众使用。在整个季度期间,在确保地图项集保持稳定的同时,我们还会继续向此发行版本中添加错误修复,Maps JavaScript API 更改日志将会对此进行记录。

      当我们发行新的编号版本时,将会“冻结”之前的发行版本,这表示我们不再对其进行任何代码更改更新(包括错误修复),以确保其充分的稳定性。每次我们以此方式推出新的冻结版本时,都会停用现有的冻结版本。也就是说,在任何指定的时间段内,我们只会提供一个冻结版本。请求已停用的编号版本的应用将会自动收到当前的冻结版本。

      选择 API 版本

      在为您的 Maps API V3 应用选择合适的 API 版本时,可参考以下指南:

      • 生产应用应指定发行版本 (v=3) 或冻结版本。指定已停用的版本(如 v=3.0)总是会返回当前的冻结版本。
      • Maps API for Business SLA 不适用于当前的实验版本。Maps API for Business 应用必须使用当前的发行版本(当前为 3.9)或较早版本,以便适用 SLA。
      • 开发新款 Maps API v3 应用时,建议您根据版本号(例如 3.10)选择使用最新的实验版本,直到您需要添加较新版本中所提供的其他地图项时再改用该新版本。这样,您使用的版本会随着应用的开发而日趋成熟,并会在一段时间后变为发行版本,最终成为冻结版本。
      • 请求当前冻结版本或较早版本的生产应用应在每季度对最新的发行版本进行测试,以便在该版本冻结前识别有关向后兼容性方面的任何问题。

      版本文档

      文档将始终反映实验版本。不过,我们会针对每个版本提供一份单独进行维护的参考。

      问题排查

      如果您的代码不起作用,可以参考以下一些方法来解决您遇到的问题:

      Last updated 二月 1, 2013.

时间: 2024-10-10 07:31:26

Google 地图 API V3 针对移动设备进行开发的相关文章

Google 地图 API V3 之事件

概述 浏览器中的 JavaScript 是由事件驱动的,这表示 JavaScript 会通过生成事件来响应交互,并期望程序监听感兴趣的事件.Google Maps API V3 的事件模型与 Google Maps API V2 中所使用的事件模型尽管在内在机制上有很大的不同,但两者是十分相似的.有两种类型的事件: 用户事件(如“点击”鼠标事件)是从 DOM 传播到 Google Maps API 中的.这些事件是独立的,并且与标准 DOM 事件不同. MVC 状态更改通知反映了 Maps AP

Google 地图 API V3 使用入门

鉴于google被屏蔽,复制过来,供参考. Hello, World 要开始了解 Google Maps API,最简单的方法就是查看简单的示例.以下网页显示了一张以澳大利亚新南威尔士的悉尼为中心的地图: <!DOCTYPE html> <html> <head> <meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> <sty

Google 地图 API V3 之控件

控件概述 通过 Google Maps API 显示的地图包含用户界面元素,以便用户与地图进行交互.这些元素称为“控件”.您可以在 Google Maps API 应用中添加这些控件的多种组合.或者,您也可以不进行任何操作,让 Google Maps API 处理所有控件行为. Maps API 带有一部分可在地图中使用的内置控件: 缩放控件,显示滑块(针对大地图)或“+/-”小按钮(针对小地图),用于控制地图的缩放等级.在非触摸的设备上,该控件默认显示在地图的左上角,而在触摸设备上则显示在左下

Google 地图 API V3 之 叠加层

叠加层概述 叠加层是地图上与纬度/经度坐标绑定的对象,会随您拖动或缩放地图而移动.叠加层表示的是“添加”到地图中以标明点.线.区域或对象集合的对象. Maps API 包含以下几种叠加层: 地图上的单个位置是使用标记显示的.标记有时可显示自定义的图标图片,这种情况下标记通常被称为“图标”.标记和图标是 Marker 类型的对象.(有关详情,请参阅下面的标记和图标.) 地图上的线是使用折线(表示一系列按顺序排列的位置)显示的.线是 Polyline 类型的对象.(有关详情,请参阅折线.) 地图上的

Google 地图 API for Android

原文:Introduction to Google Maps API for Android 作者:Eunice Obugyei 译者:kmyhy 从健康类 app Runkeeper 到游戏 app 精灵宝可梦,位置服务对现代 app 来说越来越重要. 在本文中,我们将创建一个 app,名字就叫做 City Guide.这个 app 允许用户搜索一个地点,使用 Google 地图显示这个地点的位置并监听用户的位置改变. 我们将学习如何使用 Google 地图 API for Android,G

google map api v3

<!DOCTYPE html> <html> <head> <script type="text/javascript"> function killerrors() { return true; } window.onerror = killerrors; </script> <meta name="viewport" content="initial-scale=1.0, user-sc

Google Map API V3开发(2)

3 Google Map API 简介 Google 地图 API 免费提供给用户并且适用于所有网站.Google 地图 API 使您能够使用 JavaScript 将 Google地图嵌入自己的网页中.API 提供了大量实用工具用以处理地图(正如 http://ditu.google.com 网页上的地图),并通过各种服务向地图添加内容,从而使您能够在您的网站上创建功能强大的地图应用程序. 4 帮助资源 ?Google Maps JavaScript API v3 ?中文页面:https://

Google Map API V3开发(6) 代码

<html xmlns="http://www.w3.org/1999/xhtml"> <head runat="server"> <title>Google Maps API V3 Demo</title> <script type="text/javascript" src='http://maps.googleapis.com/maps/api/js?v=3&sensor=tru

Google地图API

使用谷歌地图API V3创建交互式地图,分两个步骤来说明,第一是准备工作,第二是如何调用接口进行Google地图的展示. 1. 准备工作 如果想调用Google地图的接口,首先需要拥有一个免费的 Google 地图 API key.想要拥有一个免费的API Key,首先得拥有一个Google账号.想要申请Google的账号,首先得能访问Google的网站注册Gmail.目前在大陆已经很难访问Google的网站了,怎么访问Google的网站不是这里的重点,假设你已经能够访问Google的网站,并且