mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-20 18:22:25 +00:00
Cesium switches the map stacks through its globe port, as any renderer does, rather than through a map engine of its own. Every route keeps its behaviour: - Google 3D turned off is kept hidden, and shown again without loading it anew; the key route's tiles take clamped marks, as the token routes' do. - Esri goes to its deepest level (23); its "Map data not yet available" picture is a missing tile, so the parent's imagery stays. - Cesium ion's world imagery is Bing over HTTPS on any page, with ion's credits; a token ion refuses refuses the switch, as before. - Keyless terrain that does not answer is the flat ellipsoid, tried again behind it; world terrain asks ion first, as before. - window.__godsEyeView.tileset is the Cesium photoreal tileset.
125 lines
4.5 KiB
JavaScript
125 lines
4.5 KiB
JavaScript
/**
|
|
* @module render/cesium/google3d
|
|
* @description Google Photorealistic 3D Tiles for the Cesium renderer, by
|
|
* the routes `selectMapStartupRoute` (`src/maps/startupRoute.js`) names.
|
|
*/
|
|
export { selectMapStartupRoute } from '../../maps/startupRoute.js';
|
|
|
|
const clean = (value) => String(value || '').trim();
|
|
|
|
/**
|
|
* Load Google Photorealistic 3D Tiles through direct Google access when
|
|
* configured, otherwise through Cesium ion's hosted Google asset. Direct
|
|
* access uses a browser key, or else short-lived tokens from the app's
|
|
* server (see googleTokens.js). If direct access fails and an ion token is
|
|
* available, ion is the recovery path.
|
|
*
|
|
* @param {object} Cesium
|
|
* @param {{googleApiKey?: string, cesiumToken?: string, googleTokens?: {token: Function}|null}} credentials
|
|
* @returns {Promise<{tileset: object|null, route: 'google-direct'|'google-token'|'google-ion'|'osm', errors: Error[]}>}
|
|
*/
|
|
export async function loadPhotorealisticTileset(
|
|
Cesium,
|
|
{ googleApiKey = '', cesiumToken = '', googleTokens = null } = {},
|
|
) {
|
|
const googleKey = clean(googleApiKey);
|
|
const ionToken = clean(cesiumToken);
|
|
const errors = [];
|
|
|
|
const attempts = [];
|
|
if (googleKey)
|
|
attempts.push({
|
|
route: 'google-direct',
|
|
create: () => createGoogleDirectTileset(Cesium, googleKey),
|
|
});
|
|
else if (googleTokens)
|
|
attempts.push({
|
|
route: 'google-token',
|
|
create: () => createGoogleTokenTileset(Cesium, googleTokens),
|
|
});
|
|
if (ionToken)
|
|
attempts.push({
|
|
route: 'google-ion',
|
|
create: () => createGoogleIonTileset(Cesium, ionToken),
|
|
});
|
|
|
|
for (const attempt of attempts) {
|
|
try {
|
|
const tileset = await attempt.create();
|
|
return { tileset, route: attempt.route, errors };
|
|
} catch (error) {
|
|
errors.push(error instanceof Error ? error : new Error(String(error)));
|
|
}
|
|
}
|
|
|
|
return { tileset: null, route: 'osm', errors };
|
|
}
|
|
|
|
/** Pass credentials to the source instead of changing SDK-wide defaults. */
|
|
export function createGoogleDirectTileset(Cesium, key) {
|
|
key = clean(key);
|
|
if (!key) throw new Error('Google 3D requires an explicit browser key');
|
|
// Tiles keep drawing their own texture while draped weather loads, and
|
|
// clamped marks land on them, as on the token routes' tiles.
|
|
return Cesium.createGooglePhotorealistic3DTileset(
|
|
{ key, onlyUsingWithGoogleGeocoder: true },
|
|
{ asynchronouslyLoadImagery: true, enableCollision: true },
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Google 3D with short-lived tokens instead of a key. Every tile request
|
|
* carries the token as a header; a tile refused for an expired token gets
|
|
* the renewed one and is tried once more.
|
|
*/
|
|
export async function createGoogleTokenTileset(Cesium, tokens) {
|
|
const token = await tokens.token();
|
|
if (!token) throw new Error('Google 3D tokens are not offered');
|
|
const credit = Cesium.GoogleMaps.getDefaultCredit?.();
|
|
const resource = new Cesium.Resource({
|
|
url: `${Cesium.GoogleMaps.mapTilesApiEndpoint}v1/3dtiles/root.json`,
|
|
headers: { Authorization: `Bearer ${token}` },
|
|
credits: credit ? [credit] : undefined,
|
|
retryAttempts: 1,
|
|
async retryCallback(failed, error) {
|
|
if (![401, 403].includes(error?.statusCode)) return false;
|
|
const used = failed.headers.Authorization?.replace(/^Bearer /, '');
|
|
const renewed = await tokens.token({ replacing: used });
|
|
if (!renewed || renewed === used) return false;
|
|
failed.headers.Authorization = `Bearer ${renewed}`;
|
|
return true;
|
|
},
|
|
});
|
|
// The settings Cesium's Google helper applies to the key route.
|
|
return Cesium.Cesium3DTileset.fromUrl(resource, {
|
|
cacheBytes: 1536 * 1024 * 1024,
|
|
maximumCacheOverflowBytes: 1024 * 1024 * 1024,
|
|
enableCollision: true,
|
|
// Tiles keep drawing their own texture while draped weather loads.
|
|
asynchronouslyLoadImagery: true,
|
|
});
|
|
}
|
|
|
|
export async function createGoogleIonTileset(
|
|
Cesium,
|
|
accessToken,
|
|
{ signal } = {},
|
|
) {
|
|
accessToken = clean(accessToken);
|
|
if (!accessToken)
|
|
throw new Error('Google 3D through ion requires an explicit token');
|
|
signal?.throwIfAborted();
|
|
const resource = await Cesium.IonResource.fromAssetId(2275207, {
|
|
accessToken,
|
|
});
|
|
signal?.throwIfAborted();
|
|
// Match the installed SDK's Google helper rendering/cache defaults.
|
|
return Cesium.Cesium3DTileset.fromUrl(resource, {
|
|
cacheBytes: 1536 * 1024 * 1024,
|
|
maximumCacheOverflowBytes: 1024 * 1024 * 1024,
|
|
enableCollision: true,
|
|
// Tiles keep drawing their own texture while draped weather loads.
|
|
asynchronouslyLoadImagery: true,
|
|
});
|
|
}
|