이 튜토리얼에서는 Maps JavaScript에서 실사 3D 지도를 사용하여 첫 번째 JavaScript 애플리케이션을 만드는 과정을 안내합니다. 이 기본 창은 Marin Headlands를 배경으로 골든게이트교의 오버헤드 뷰를 표시하는 기본 창입니다.
튜토리얼을 완료하면 개발 환경에 다음 맵이 표시됩니다.
환경 설정
코드 작성을 시작하기 전에 JavaScript를 실행하는 환경을 설정해야 합니다. 이 튜토리얼에서는 웹브라우저를 환경으로 사용합니다. 모든 최신 웹브라우저에는 JavaScript 지원 기능이 내장되어 있으므로 추가 소프트웨어를 설치할 필요가 없습니다.
원하는 텍스트 편집기를 엽니다.
새 파일을 만들고 .html 확장자 (예: hello-p3djs.html))를 제공합니다.
HTML 페이지 작성
먼저 기본 HTML 구조로 웹페이지를 만들어 보겠습니다.
<!DOCTYPE html>
<html>
<head>
<title>Hello Photorealistic 3D Maps in Maps JavaScript</title>
</head>
<body>
<!-- Your JavaScript code will go here -->
</body>
</html>
JavaScript 추가
다음으로 맞춤 HTML 요소를 추가하여 지도를 로드합니다. 코드에는 다음 두 가지 요소가 포함되어 있습니다.
gmp-map-3d에는 시작 카메라 위치와 뷰를 초기화하는 데 사용되는 매개변수가 포함됩니다.
[null,null,["최종 업데이트: 2025-04-29(UTC)"],[],[],null,["\u003cbr /\u003e\n\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\n\u003cbr /\u003e\n\nSelect platform: [Android](/maps/documentation/maps-3d/android-sdk/add-a-3d-map \"View this page for the Android platform docs.\") [iOS](/maps/documentation/maps-3d/ios-sdk/add-a-3d-map \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/3d/get-started \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nIn this tutorial, you'll guide yourself through creating your first JavaScript\napplication using Photorealistic 3D Maps in Maps JavaScript: a basic window that displays\nan overhead view of the Golden Gate Bridge with the Marin Headlands in the\nbackground.\n\nUpon completing the tutorial, you should see the following map in your\ndevelopment environment:\n\nSet up your environment\n\nBefore you begin writing code, you must set up an environment that runs\nJavaScript. For this tutorial, you'll use a web browser as your environment. All\nmodern web browsers have built-in support for JavaScript, so you don't need to\ninstall any additional software.\n\n1. Open a text editor of your choosing.\n2. Create a new file and save it with an `.html` extension (e.g., `hello-p3djs.html`).\n\nWrite an HTML page\n\nTo start, you'll create a web page with a basic HTML structure: \n\n \u003c!DOCTYPE html\u003e\n \u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eHello Photorealistic 3D Maps in Maps JavaScript\u003c/title\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003c!-- Your JavaScript code will go here --\u003e\n \u003c/body\u003e\n \u003c/html\u003e\n\nAdd JavaScript\n\nNext, you'll add a custom HTML element to load the map. The code contains two\nelements:\n\n- `gmp-map-3d` contains the parameters used for initializing the starting camera position and view.\n- `script` contains the call to load the Maps JavaScript API. Be sure to replace `YOUR_KEY` with your API key.\n\n \u003c!DOCTYPE html\u003e\n \u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eHello Photorealistic 3D Maps in Maps JavaScript\u003c/title\u003e\n\n \u003cstyle\u003e\n html,\n body {\n height:100%;\n margin: 0;\n padding: 0;\n }\n \u003c/style\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003cgmp-map-3d mode=\"hybrid\" center=\"37.841157, -122.551679\" range=\"2000\" tilt=\"75\" heading=\"330\"\u003e\u003c/gmp-map-3d\u003e\n \u003cscript async src=\"https://maps.googleapis.com/maps/api/js?key=\u003cYOUR_KEY\u003e&v=beta&libraries=maps3d\"\u003e\u003c/script\u003e\n \u003c/body\u003e\n \u003c/html\u003e\n\nRun the application\n\nTo run the application and see the output, follow these steps:\n\n1. Save the HTML file you created.\n2. Open the file in a web browser (you can double-click the file, drag it into a browser window, or right-click and use \"Open with\").\n3. You should see the map in your browser window.\n\nCongratulations! You've just written an application using Google's\nPhotorealistic 3D Maps in Maps JavaScript API.\n\nNext steps\n\n- Build more complicated 3D map experiences using Google's existing [samples](/maps/documentation/javascript/examples/3d/simple-map).\n- Discover the full potential of the Photorealistic 3D Maps in Maps JavaScript API by reading the [reference documentation](/maps/documentation/javascript/reference/3d-map)."]]