[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-05 (世界標準時間)。"],[[["\u003cp\u003eThe 3D Storytelling solution empowers journalists, travelers, and enthusiasts to craft immersive narratives integrated with geographic landscapes using Google Maps Platform photorealistic 3D Tiles.\u003c/p\u003e\n"],["\u003cp\u003eThis solution enhances storytelling by offering interactive chapters, dynamic camera control, and a configurable JSON structure for customization.\u003c/p\u003e\n"],["\u003cp\u003eUsers can access a hosted demo or download the code from GitHub to begin creating their own 3D storytelling experiences.\u003c/p\u003e\n"],["\u003cp\u003eThe application consists of an Admin app for customization and a Demo app for the final user-facing experience.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Maps Platform services, such as the 3D Tiles API and Places API, are utilized, and users should be aware of potential API usage costs.\u003c/p\u003e\n"]]],[],null,["Introduction\n\nThe Storytelling Solution is a versatile tool for journalists, travelers, and\nenthusiasts to weave narratives into geographic landscapes. It offers an\nengaging platform where stories come to life using [Google Maps Platform\nphotorealistic 3D\nTiles](https://developers.google.com/maps/documentation/tile/3d-tiles). Whether\nyou're a journalist conveying a narrative with geographic context or a traveler\ndocumenting your adventures, this solution provides a user-friendly interface to\nbring your stories forward.\n\nPurpose\n\nThe 3D Storytelling solution aims to enhance communication of stories by\nintegrating geographic information. It's a digital storytelling tool that\nenables creators to craft immersive and interactive narratives using Google Maps\nPlatform photorealistic 3D Tiles. Its purpose is to bridge the gap between\nstorytelling and geography, enabling captivating experiences for users.\n\nTarget Use Cases\n\n1. Journalism:\n\nJournalists can use the 3D Storytelling solution to enhance their stories\nwith location-based context. Embedding narratives within specific geographical\nsettings adds depth and authenticity to news articles, making them more\nimpactful and engaging.\n\n2. Travel Documentation:\n\nTravelers can chronicle their journeys in a visually stunning way. By\nincorporating geo-tagged chapters, users can create an interactive travelog\nthat not only shares experiences but also provides a spatial perspective of\ntheir adventures.\n\n3. Educational Storytelling:\n\nEducators can use the platform to create immersive learning experiences.\nBy narrating historical events, scientific phenomena, or cultural stories\nwithin a geographical context, educators can enhance understanding and\nengagement.\n\nGetting started: **Use the hosted** [3D Storytelling Admin app](https://js-3d-storytelling-admin-t6a6o7lkja-uc.a.run.app/)\n|\n| Or\n| [Get an API Key](https://console.cloud.google.com/google/maps-apis/credentials?utm_source=3d_solutions_storytelling). and **download** the code from [GitHub](https://github.com/googlemaps-samples/js-3d-storytelling).\n\n**Enable**\n\n- [Photorealistic 3D tiles API](https://console.cloud.google.com/marketplace/product/google/tile.googleapis.com?utm_source=3d_area_explorer)\n- [Places API](https://console.cloud.google.com/marketplace/product/google/places-backend.googleapis.com?utm_source=3d_area_explorer)\n\nKey Features\n\n- **Configurability**: The solution offers a configurable JSON structure,\n enabling users to tailor their storytelling experiences. Whether using the\n intuitive UI in the Admin app or directly editing the JSON, customization is\n at your fingertips.\n\n- **Interactive chapters**: Dive into the details with individual story\n chapters, each offering a unique blend of text content, media elements\n (images, gifs, or videos), and geographic coordinates.\n\n- **Dynamic camera control**: Take control of the narrative flow with dynamic\n camera options. Position, pitch, and roll settings allow creators to frame\n scenes precisely, providing an immersive viewing experience.\n\n- **Hosted demo**: Explore the capabilities without local installation. The\n hosted demo offers a glimpse into the storytelling potential of this\n solution.\n\nUse the app\n\nOnce you launch the application, the story panel on the right side becomes your\nguide. This is your hub for an exploring a particular story. Here's how to\nnavigate:\n\n**Start your story:** Start your interactive experience with the bold \"Begin\nInteractive Story\" button.\n\n**Automated slideshow mode:** The play button unlocks the slideshow mode,\nseamlessly guiding you through each chapter of the story.\n\n**Navigate between chapters:** Use the navigation arrows to explore the story at\nyour own pace, moving back and forth between chapters.\n\n**Jump to a chapter:** The story cards offer shortcuts -- click a card to\ninstantly load its chapter.\n\n**Rich Multimedia:** Discover chapters filled with captivating images, engaging\nGIFs, and embedded YouTube videos. Click the play button within a video to watch\nit directly in your story panel.\n\nKey components\n\nThe application is divided into two different apps, namely:\n\n- Admin app\n- Demo app\n\nThis diagram gives an overview of the differences and correlation between\nthe two applications:\n\nDemo app:\n\nThis is the final, user-facing application that loads the configuration you\ncreated in the Admin app. In this immersive, 3D environment, users will be able\nto explore the selected areas and discover the POIs that you have highlighted.\n\nOnce you have customized your look and feel using the Admin app, you can\ndownload the configuration and run your custom application from the source code.\n\nAdmin app:\n\nThis application provides a user-friendly interface that lets you to customize\nthe 3D experience:\nLearn more about how to create and customize your story using the Admin app\n[here](https://developers.google.com/maps/architecture/3d-storytelling-customizations)\n\nPrerequisites\n\nGoogle API Key: You must use a Google Could API key that's enabled for the\nfollowing APIs:\n\n- [Maps Tiles API](https://developers.google.com/maps/documentation/tile)\n- [Maps JavaScript API](https://developers.google.com/maps/documentation/javascript/overview)\n- [Places API](https://developers.google.com/maps/documentation/places/web-service/overview)\n\nWeb server: You can host the application from either:\n\n- A local web server (e.g., using Node.js, http-server)\n- A web hosting service (The application comes with a Dockerfile)\n\nDeployment\n\nYou can deploy the app as a simple node application or a docker in any\ncontainer environment like [GKE](https://cloud.google.com/kubernetes-engine) or\n[GAE](https://cloud.google.com/appengine). For the hosted demo we are are using\nthe following architecture:\n\nBilling Information\n\nThe Storytelling Solution uses Google Maps Platform services to provide an\nimmersive, dynamic experience. Some APIs may incur charges. Here's an overview\nof the APIs and links to pricing.\n\nGoogle Maps Platform - 3D Tiles API:\n\nThe Storytelling Solution utilizes the 3D Tiles API to enhance the visual\nexperience with geospatial data. For pricing details related to the 3D Tiles\nAPI, refer to the Google Maps Platform -[3D Tiles API\nPricing](https://developers.google.com/maps/documentation/tile/usage-and-billing).\n\nGoogle Places API: The Places API is employed for location-based data, adding rich information to\n\u003e the storytelling experience. To understand the costs associated with the\n\u003e Google Places API, visit Google Maps Platform - [Places API\n\u003e Pricing](https://developers.google.com/maps/documentation/places/web-service/usage-and-billing).\n\nGoogle Maps Autocomplete API: Autocomplete feature enhances user interaction. For pricing details\n\u003e regarding the Google Maps Autocomplete API, kindly visit Google Maps Platform\n\u003e - [Places Autocomplete\n\u003e Pricing](https://developers.google.com/maps/documentation/places/web-service/usage-and-billing).\n\nCesiumJS: CesiumJS is used for the 3D globe visualization. While CesiumJS itself is\n\u003e open-source, additional features or services may have their own associated\n\u003e costs. Refer to the CesiumJS Documentation for any premium offerings.\n\nIt is crucial to review the pricing details for each respective API, as charges\nare determined individually based on usage. Note that Google Maps Platform\noffers a free tier with a certain amount of usage at no cost, and pricing\nspecifics may vary based on factors such as the number of requests and usage\nregion.\n\nAlways refer to the official pricing pages for the most accurate and up-to-date\ninformation on Google Maps Platform and CesiumJS usage costs. Ensure compliance\nwith the terms and conditions outlined by these services to manage and\nunderstand any associated expenses effectively.\n\nConclusion\n\nThe 3D Storytelling solution is a powerful tool that enables the creation of\nimmersive and captivating narratives by seamlessly integrating storytelling with\ngeographic context. Whether used for journalism, travel documentation, or\neducational purposes, this solution empowers creators to engage their audience\nin a uniquely captivating way.\n\nWith its user-friendly interface, customizable features, and dynamic camera\ncontrol, the 3D Storytelling solution offers a seamless storytelling experience.\nExplore the potential of this innovative tool and unleash your creativity to\nbring stories to life in a whole new dimension."]]