KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

mapray-js

★ 155 Open GitHub ↗

JavaScript library for Interactive high quality 3D globes and maps in the browser

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[<p align="center"><img width="400" alt="Mapray" src="https://storage.googleapis.com/ino-sandbox.appspot.com/github/mainlogo.png"></p>](https://mapray.com/)

maprayJS is a JavaScript library for a high quality interactive 3D globes and digital twin on the web. It is based on WebGL.
[WebSite](https://mapray.com)

[<p align="center"><img src="https://resource.mapray.com/assets/www/img/github_cover.jpg" /></p>](https://mapray.com)

## Installation
### Script Tag
#### core packages
```html
  <script src="https://resource.mapray.com/mapray-js/v0.9.5/mapray.min.js"></script>
```
#### ui packages
```html
  <script src="https://resource.mapray.com/mapray-js/v0.9.5/maprayui.min.js"></script>
```

### NPM module
#### core packages
```bash
npm install --save @mapray/mapray-js
```

### ui packages
```bash
npm install --save @mapray/ui
```

## Usage
World Terrain data hosted by Mapray Cloud platform. Access Token is required to access to Mapray Cloud, it is under Beta Test and you can join beta test for free if you meet the our requirements. 
The service web site of Mapray Cloud is [here](https://cloud.mapray.com).
Mapray Cloud managed by [Sony Group Corporation.](https://www.sony.com/) If you have any questions about the access token of mapray cloud or the services of mapray cloud, please contact us from the [contact page](https://mapray.com/contact.html).
```html
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Hello Globe</title>
    <link rel="stylesheet" href="https://resource.mapray.com/styles/v1/mapray.css">
</head>
<style>
    html, body {
        height: 100%;
        margin: 0;
    }
    div#mapray-container {
        display: flex;
        height: 100%;
    }
</style>
<body>
    <div id="mapray-container"></div>
</body>
</html>
<script src="https://resource.mapray.com/mapray-js/v0.9.5/mapray.min.js"></script>
<script>
     // Set Access Token for mapray cloud
       var accessToken = "<your access token here>";

// For Image tiles
       var imageProvider = new mapray.StandardImageProvider( { url: "https://cyberjapandata.gsi.go.jp/xyz/seamlessphoto/", format: "jpg", min_level: 2, max_level: 18 } );

// Create viewer
       var viewer = new mapray.Viewer(
           "mapray-container", {
               image_provider: imageProvider,
               dem_provider: new mapray.CloudDemProvider(accessToken)
           }
       );
       viewer.attribution_controller.addAttribution({
           display: "国土地理院",
           link: "http://maps.gsi.go.jp/development/ichiran.html"
        });
       // Setting the position of camera
       var home_pos = { longitude: 138.247739, latitude: 35.677604, height: 3000 };

var home_view_geoPoint = new mapray.GeoPoint( home_pos.longitude, home_pos.latitude, home_pos.height );
       var home_view_to_gocs = home_view_geoPoint.getMlocsToGocsMatrix( mapray.GeoMath.createMatrix() );

var cam_pos = mapray.GeoMath.createVector3( [-3000, 2600, 1000] );
       var cam_end_pos    = mapray.GeoMath.createVector3( [0, 0, 0] );
       var cam_up         = mapray.GeoMath.createVector3( [0, 0, 1] );

var view_to_home = mapray.GeoMath.createMatrix();
       mapray.GeoMath.lookat_matrix(cam_pos, cam_end_pos, cam_up, view_to_home);

var view_to_gocs = viewer.camera.view_to_gocs;
       mapray.GeoMath.mul_AA( home_view_to_gocs, view_to_home, view_to_gocs );

viewer.camera.near = 30;
       viewer.camera.far = 500000;
</script>
```

## Next Steps
- [Examples](/examples)
- [Debug Apps](/debug)

[<p align="center"><img src="https://resource.mapray.com/assets/www/img/github.jpg" /></p>](/examples)

## Documentation
- [Mapray Document(Japanese)](https://mapray.com/documents/index.html)
- [API Reference](https://resource.mapray.com/doc/api/v0.9.5/index.html)
- [Contribution Guide (English)](/CONTRIBUTING.md)

**API documents**

Execute the following command in the root directory.
```bash
npm run doc
```

## License
maprayJS is licensed under the [Apache License Version 2.0](/LICENSE).
It also depends on open source software packages. For more information, see [LICENSES](third_party/LICENSES.md).

mapray-js

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README