Move GoogleTilesRenderer into core (#361)

* Add google tiles renderer to core

* Update demos

* README update

README.md

@@ -677,6 +677,36 @@ schedulingCallback = requestAnimationFrame : ( cb : Function ) => void
 
 A function used for scheduling when to run jobs next so more work doesn't happen in a single frame than there is time for -- defaults to the next frame. This should be overriden in scenarios where requestAnimationFrame is not reliable, such as when running in WebXR. See the VR demo for one example on how to handle this with WebXR.
 
+## GoogleTilesRenderer
+
+_extends [TilesRenderer](#TilesRenderer)_
+
+Variant of the TilesRenderer designed to easily support [Google's Photorealistic 3D Tiles API](https://cloud.google.com/blog/products/maps-platform/create-immersive-3d-map-experiences-photorealistic-3d-tiles). Handles adding api key to all requests, reading tile credits, and initializes tile set traversal options to reasonable defaults for the globe.
+
+### constructor
+
+```js
+constructor( apiKey: String )
+```
+
+Takes the Google Photorealistic Tiles API Key.
+
+### .getCreditsString
+
+```js
+getCreditsString(): String;
+```
+
+Returns a string of unique credits for all the tiles currently displayed.
+
+### .setLatLonToYUp
+
+```js
+setLatLonToYUp( lat: Number, lon: Number ): void;
+```
+
+Rotates and positions the local transformation of the tile group object so the surface of the globe ellipsoid at the specified latitude and longitude faces Y+.
+
 ## LRUCache
 
 Utility class for the TilesRenderer to keep track of currently used items so rendered items will not be unloaded.

example/googleMapsAerial.js

@@ -1,5 +1,4 @@
-import { GeoUtils, WGS84_ELLIPSOID } from '../src/index.js';
-import { DebugGoogleTilesRenderer as GoogleTilesRenderer } from './src/GoogleTilesRenderer.js';
+import { GeoUtils, WGS84_ELLIPSOID, GoogleTilesRenderer } from '../src/index.js';
 import {
 	Scene,
 	WebGLRenderer,

example/googleMapsExample.js

@@ -1,5 +1,4 @@
-import { GeoUtils, WGS84_ELLIPSOID, WGS84_RADIUS } from '../src/index.js';
-import { DebugGoogleTilesRenderer as GoogleTilesRenderer } from './src/GoogleTilesRenderer.js';
+import { GeoUtils, WGS84_ELLIPSOID, WGS84_RADIUS, DebugGoogleTilesRenderer as GoogleTilesRenderer } from '../src/index.js';
 import {
 	Scene,
 	WebGLRenderer,

src/index.d.ts

@@ -23,6 +23,7 @@ export { Ellipsoid } from './three/math/Ellipsoid';
 export { EllipsoidRegion } from './three/math/EllipsoidRegion';
 export * as GeoUtils from './three/math/GeoUtils';
 export * from './three/math/GeoConstants';
+export * from './three/renderers/GoogleTilesRenderer';
 
 export { TilesRendererBase } from './base/TilesRendererBase';
 export { Tile } from './base/Tile';

src/index.js

@@ -25,6 +25,7 @@ export { Ellipsoid } from './three/math/Ellipsoid.js';
 export { EllipsoidRegion } from './three/math/EllipsoidRegion.js';
 export * as GeoUtils from './three/math/GeoUtils.js';
 export * from './three/math/GeoConstants.js';
+export * from './three/renderers/GoogleTilesRenderer.js';
 
 export { TilesRendererBase } from './base/TilesRendererBase.js';
 export { LoaderBase } from './base/LoaderBase.js';

example/src/MapsTilesCredits.js → src/three/renderers/GoogleMapsTilesCredits.js

@@ -1,4 +1,4 @@
-export class MapsTilesCredits {
+export class GoogleMapsTilesCredits {
 
 	constructor() {
 

src/three/renderers/GoogleTilesRenderer.d.ts

@@ -0,0 +1,23 @@
+import { TilesRenderer } from '../TilesRenderer';
+import { DebugTilesRenderer } from '../DebugTilesRenderer';
+import { Ellipsoid } from '../math/Ellipsoid';
+
+export class GoogleTilesRenderer extends TilesRenderer {
+
+	ellipsoid: Ellipsoid;
+
+	constructor( apiKey: String );
+	getCreditsString(): String;
+	setLatLonToYUp( lat: Number, lon: Number ): void;
+
+}
+
+export class DebugGoogleTilesRenderer extends DebugTilesRenderer {
+
+	ellipsoid: Ellipsoid;
+
+	constructor( apiKey: String );
+	getCreditsString(): String;
+	setLatLonToYUp( lat: Number, lon: Number ): void;
+
+}

example/src/GoogleTilesRenderer.js → src/three/renderers/GoogleTilesRenderer.js

@@ -1,6 +1,8 @@
 import { Matrix4 } from 'three';
-import { TilesRenderer, DebugTilesRenderer, WGS84_ELLIPSOID } from '../../src/index.js';
-import { MapsTilesCredits } from './MapsTilesCredits.js';
+import { TilesRenderer } from '../TilesRenderer.js';
+import { DebugTilesRenderer } from '../DebugTilesRenderer.js';
+import { WGS84_ELLIPSOID } from '../math/GeoConstants.js';
+import { GoogleMapsTilesCredits } from './GoogleMapsTilesCredits.js';
 
 const API_ORIGIN = 'https://tile.googleapis.com';
 const TILE_URL = `${ API_ORIGIN }/v1/3dtiles/root.json`;
@@ -17,7 +19,7 @@ const GoogleTilesRendererMixin = base => class extends base {
 
 		super( new URL( `${ baseUrl }?key=${ apiKey }` ).toString() );
 
-		this._credits = new MapsTilesCredits();
+		this._credits = new GoogleMapsTilesCredits();
 
 		this.fetchOptions.mode = 'cors';
 		this.parseQueue.maxJobs = 7;