如何将 BingMaps 与 Aurelia 结合使用
我正在为我的应用使用 aurelia 骨架 typescript webpack 模板。 我想将 BingMaps 添加到页面并能够添加图钉等。 到目前为止,我已经完成了以下操作:
index.html - I added a script tag that loads the map from CDN
<head>
...
<script type='text/javascript' src='http://www.bing.com/api/maps/mapcontrol'></script>
</head>
然后我添加了一个这样的模板:
map.html
<template>
<div id='mainMap' style='width: 100vw; height: 100vh;'></div>
</template>
然后我有地图控制器:
map.ts
export class Map {
private map: Microsoft.Map.Map;
attached() {
this.map = new Microsoft.Maps.Map('mainMap', { credentials:'mycredentials - omitted'});
...
}
}
现在,如果我启动应用程序,则会显示欢迎屏幕(来自骨架)。然后我单击“地图”菜单链接,地图页面就会显示,地图已完全加载。 但是,如果我在浏览器中单击刷新(F5 或 Ctrl+F5),地图将不再显示,控制台中将显示错误:
bluebird.js:1546 Unhandled rejection TypeError: Cannot read property 'prototype' of null at k ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:7096 ) at h ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:6285 ) at e ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:1106 ) at t.l [as instance] ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:161 ) at h ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:6042 ) at e ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:1106 ) at t.l [as instance] ( https://www.bing.com/mapspreview/sdk/mapcontrol:11:161 ) at new Microsoft.Maps.Map ( https://www.bing.com/mapspreview/sdk/mapcontrol:13:4304 ) at Map.attached ( http://localhost:9000/app.bundle.js:31267:20 ) at Controller.attached ( http://localhost:9000/aurelia.bundle.js:6438:22 ) at View.attached ( http://localhost:9000/aurelia.bundle.js:4524:23 ) at ViewSlot.attached ( http://localhost:9000/aurelia.bundle.js:4883:13 ) at View.attached ( http://localhost:9000/aurelia.bundle.js:4534:19 ) at ViewSlot.attached ( http://localhost:9000/aurelia.bundle.js:4883:13 ) at http://localhost:9000/aurelia.bundle.js:14717:28
当尝试在地图控制器的 Attached 事件中实例化 Map 对象时,会引发此错误。
为什么会发生这种情况?我该如何解决? 请帮忙
谢谢
解决此问题的关键是使用 API 允许我们在脚本 URL 中指定的
callback
参数。我创建了一个自定义元素来执行此操作。脚本在模块首次加载时加载。自定义元素的任何实例都将等待回调函数被调用。我最初使用的是带有
MutationObserver
和数据属性的复杂设置,但在与 Jeremy Danyow 交谈后,他指出“承诺”回调将更简单地解决问题。这个更简单的解决方案如下所示。
除了获取地图的当前中心点之外,自定义元素目前不提供任何用于与地图交互的 API,但它是一个很好的起点来帮助您。
bing-map.ts
import { bindable, bindingMode, inlineView } from 'aurelia-framework';
const controlUrl = '//www.bing.com/api/maps/mapcontrol?callback=bingMapsLoaded';
const ready = new Promise(resolve => window['bingMapsLoaded'] = resolve);
let scriptTag: HTMLScriptElement = document.createElement('script');
scriptTag.async = true;
scriptTag.defer = true;
scriptTag.src = controlUrl;
document.head.appendChild(scriptTag);
@inlineView('<template><div ref="container" css="width: ${width}; height: ${height};"></div></template>')
export class BingMapCustomElement {
private container: HTMLElement;
private map: Microsoft.Maps.Map;
private viewChangeHandler: Microsoft.Maps.IHandlerId;
@bindable apiKey = '';
@bindable height = '600px';
@bindable width = '400px';
@bindable({ defaultBindingMode: bindingMode.twoWay }) location: Microsoft.Maps.Location | string;
attached() {
return ready.then(() => {
this.map = new Microsoft.Maps.Map(this.container as HTMLElement, {
credentials: this.apiKey
});
this.location = this.map.getCenter();
this.viewChangeHandler = Microsoft.Maps.Events.addHandler(this.map, 'viewchange', e => {
this.location = this.map.getCenter();
});
});
}
detached() {
if (this.viewChangeHandler) {
Microsoft.Maps.Events.removeHandler(this.viewChangeHandler);
}
if (this.map) {
this.map.dispose();
this.map = null;
}
}
}
用法
<bing-map api-key.bind="mapsApiKey" width="100px" height="100px"></bing-map>
这是因为您尝试在外部脚本完全加载之前实例化地图。它在您的第一个场景中有效,但在您直接刷新时无效。
这里发布了一个很好的解决方案:
回调解决方案的问题在于您正在 index.html 中加载外部脚本,而这与您当前是否想要显示地图无关。因此,第二种解决方案更合适。但是,我认为该解决方案是为 ESNext 代码编写的,并且您正在使用 TypeScript,这意味着 typeof 属性永远不会未定义。以下 ma​​p.ts 代码在您的环境中效果会更好(您可能需要进行一些调试,因为我无法对其进行测试):
export class Map
{
map:Microsoft.Maps.Map;
attached() {
this.loadMap();
}
loadMap() {
if ((Microsoft == null) || (Microsoft.Maps == null)) {
// not yet available, keep trying (dirty checking)
setTimeout(this.loadMap, 100);
} else {
// Map API available; proceed to render the map
this.map = new Microsoft.Maps.Map('#mainMap', {credentials: myKey});
this.map.setView({center: new Microsoft.Maps.Location(45.093,14.114), zoom:15});
}
}
}
请注意
if ((Microsoft == null) || (Microsoft.Maps == null))
测试,而不是
undefined
测试。
另一个很棒的解决方案(由 Jason Sobell 提供)
http://www.sobell.net/calling-external-javascript-from-within-aurelia-templates/
第三个很棒的解决方案(经过一些回调研究)
您可以在
不使用
外部脚本链接的情况下实现此解决方案
index.html
,因为这应该动态提供加载机制。
export class Map
{
private map: any;
attached() {
this.loadScript("//www.bing.com/api/maps/mapcontrol?onload=callback");
}
loadScript(sScriptSrc) {
var oHead = document.getElementsByTagName("head")[0];
var oScript = document.createElement('script');
oScript.type = 'text/javascript';
oScript.src = sScriptSrc;
oHead.appendChild(oScript);
oScript.onload = this.loadMap();
}
loadMap() {
// Map API available; proceed to render the map
this.map = new Microsoft.Maps.Map('#mainMap', {credentials: myKey});
this.map.setView({center: new Microsoft.Maps.Location(45.093,14.114), zoom:15});
}
}