Google Maps Embed API中文帮助文档（社区版）

Alpha · 发表于 2014-3-26 10:06:14

本帖最后由 Alpha 于 2014-3-26 10:10 编辑

Google Maps Embed API

Google Maps Embed API使用一个简单的HTTP请求来生成一个动态可交互的地图。该地图可以很容易的嵌入到你的网页中，只需将Embed API URL做为一个iframe标签的src值。

属于你的地图

网站的每一个访问者都会看到一个专为他们量身定作的地图。如果他们已经用Google账号登陆了，所有他们已经保存过的地点，家庭和公司位置都会显示在这个地图上。这也意味着在这个地图上的标星号的地点，都会自动保存下来，在桌面或移动版的Google地图中很容易的查看。

这些属于特定用户的信息，其它人是看不到的，也就是说每个访问者都有只属于自己的地图。

没有使用限制

Maps Embed API没有使用限制，你可以将地图嵌入到大流量的网站中而不用担心触及使用上限或是每秒查询数量限制。

容易嵌入

Google Maps Embed API的地图很容易添加到你的网页中，只需将你准备好的URL做为一个iframe的src属性值。通过iframe的height和width属性值来控制地图的大小。不需要Java Script。

合成URL

Embed API请求的URL格式如下：

https://www.google.com/maps/embed/v1/MODE?key=API_KEY¶meters

其中：

{MODE}取place,directions,search或view中的一个，在文档的Modes部分有详细说明。
{API_KEY}表示免费的API key。
paramaters包括可选参数和特定模式中的参数。

API key

所有向Embed API发送的请求必须包含一个免费的API key,在key参数中指定。Key用来监测你的应用中Maps API的使用以及Google针对你的网站和应用在需要的时候联系你。

获取你的API key：

使用你的Google账号访问APIs控制台https://code.google.com/apis/console。
在左边的菜单中选择服务。
激活Google Maps Embed API服务。
点击左边的API Access。可以在API Access页面中的Simple API Access部分看你的API key了。 Maps API应用使用的是Key for browser apps。

默认情况下key可以在任意网站中使用下。我们强烈建你只在自己的网站中使用，以避免未授权的滥用。你也可以在Edit allowed referrers链接中来管理可以使用该key的域名。

你的API key看起来像这样：AIzaSyCwI3k7JC29_KzlX1S_bC8fARpocLX5bRY

模式

一共有4种内嵌地图模式可选。模式需在URL请求中指定。

地点模式

地点模式用于在地图中特定地点或地址显示一个标记，可以是地标，商家，地理特征或城镇。

https://www.google.com/maps/embed/v1/place
?key=API_KEY
&q=Fisht+Olympic+Stadium,Sochi+Russia

必须包含以下URL参数：

q定义了需显示在地图上的地点。可以是一个地点名称或是地址。字符串必须经过URL转义，像”City Hall, New York, NY“转换为City+Hall,New+York,NY。（Google Maps Embed API支持＋和%20两种转义空格。）

路线模式

路线模式用于在地图上显示特定两点或多点间的路线，也用于显示距离和所需时间。

https://www.google.com/maps/embed/v1/directions
  ?key=API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

必须包含以下URL参数：

origin，起点，定义了要显示路线的起始点。可以是一个地点名称或是地址。字符串必须经过URL转义，像”City Hall, New York, NY“转换为City+Hall,New+York,NY。（Google Maps Embed API支持＋和%20两种转义空格。）
destination，终点，定义了要显示路线的结束点。

可选的URL参数：

waypoints，路标，可以指定一个或多个在起点和中间间需要经过的路标。多个路标之间用｜分隔，如比（Berlin,Germany|Paris,France），最多可指定20个路标。
mode，定义了交通方式，包含driving, walking (人行道优先选择）), bicycling (优先选择自行车道或街道), transit, 或flying. 如何没有指定模式，Embed API将为该路线显示一个或多个相关模式。
avoid，排除，用于告诉Google地图在路线中尽量排除收费站，游轮或高速公路。多个值之间用｜隔开，比如( avoid=tolls|highways)。注意，该参数不会预先排除有包含这些设施的路线，而只是在结果中优先显示更喜欢的路线。
units，单位，指定了在显示路线的距离时要使用metric（公制）还是imperial（英制）。没有指定则默认使用起点国家采用的长度单位。

搜索模式

搜索模式，用于将搜索结果显示在地图的可见区域内。建议在搜索中指定位置，不论是在搜索条件中包括位置信息 (record+stores+in+Seattle) 或是在搜索中指定一个center（中心点）和 zoom（缩放级别）。

https://www.google.com/maps/embed/v1/search
?key=API_KEY
&q=record+stores+in+Seattle

必须包含以下URL参数：

q 用来指定搜索条件。可以包含区域限制，比如 in+Seattle 或者r near+98033.

查看模式

查看模式返回一个没有任何标记或路线的地图。

https://www.google.com/maps/embed/v1/view
  ?key=API_KEY
  ￠er=37.4218,-122.0840
  &zoom=18
  &maptype=satellite

必须包含以下URL参数：

center，中心点，定义了地图的中心位置，格式为以逗号分隔的一组经纬度(37.4218,-122.0840)。

可选参数

以下参数可用在上述所有的模式中。

center，中心点，定义了地图的中心位置，格式可以是以逗号分隔的一组经纬度(37.4218,-122.0840)，也可以是地点名称或地址 (例如Champ+de+Mars,Paris,France).
zoom，缩放级别，指定地图的初始缩放级别。取值范围是0（全球）至21（单独的建筑）。上限根据所选位置的不同而不同，取决于当地的地图数据。
maptype，地图类型，可以是 roadmap平面图 (默认)或satellite卫星图, 用来指定要加载的地图类型。
language，语言用来指定在地图图块的UI和标签中显示的语言。注意该参数只支持部分国家的图块；如果指定语言在图块中不支持，将使用图块集的默认语言。访问者在默认情况下都会看到自己语言的地图。
region，地域定义适当的边界和标签来显示，基于地缘政治敏感性。接受两个字符的ccTLD (顶级域名) 的国家代码值。

嵌入地图

要将地图嵌入到你的网页中，只需将合成好的URL赋给一个iframe的src属性。利用iframe的height和width来控制地图大小

提示: frameborder="0" 和 style="border:0" 用来去除地图周围的标准iframe边框。

可以调整地图大小来适应网站的布局和设计，但我们发现大的地图让用户更容易交互。需要注意的是，Embed地图不支持长和宽任意一边小于200px。