Maps quickstart

Available in Classic and VPC

Note

Maps API service, which had been provided by NAVER Cloud Platform, has been upgraded and newly released. Use new Maps service with NAVER map content's customizing styling function added.

You can easily implement NAVER Maps using Maps APIs of NAVER Cloud Platform. You can view the detailed usage methods in Getting started with Maps and Using Maps, but we recommend taking a look at the entire usage quickstart of Maps first. For best usage of Maps, read the usage method after learning the usage quickstart. The entire process of using Maps and descriptions of each sequence are as follows:

1. Set usage permissions
2. Issue authentication key
3. Set project
4. Apply authentication key
5. Use APIs
6. View usage

1. Set usage permissions

If several users need to manage and share Maps, you can operate it by setting permissions for each user. You can configure the permissions as administrator and user through Sub Account in NAVER Cloud Platform, and roles can be defined for each permission.
Because setting usage permissions is not mandatory, you can set or unset it at any time when you need permissions while using Maps.

Note

Sub Account is a service provided free of charge upon subscription. For more information on Sub Account and its pricing plan, see Services > Management & Governance > Sub Account on the NAVER Cloud Platform portal.

You can see the following user guides:

2. Issue authentication key

To use Maps, you must first register an application on NAVER Cloud Platform console and get an authentication key. Maps belong to AI·NAVER API > Application Service. The Maps APIs that you can register include Web Dynamic Map, Mobile Dynamic Map, Static Map, Directions 5, Directions 15, Geocoding, and Reverse Geocoding. All APIs can be registered in 1 application, or each API can be registered as an individual application. Guides that you can see about application registration are as follows:

3. Set project

To use Maps API, you must load the Maps APIs resources provided by NAVER Cloud Platform into your development project file, or add dependencies to the resources and libraries. Because the way to set up a project differs for each development resource, see start guides for each resource. You can use Maps REST APIs without separate settings. Guides that you can see about project settings are as follows:

Note

Because the submodules of Web Dynamic Map are separate libraries from Web Dynamic Map core API, you must load the submodules using submodules URL parameters to use them. To load a submodule, Web Dynamic Map APIs must be loaded first. The following describes the submodules provided by Web Dynamic Map:

panorama: provides street view/aerial view
geocoder: provides transformation methods between coordinate systems and extended projection objects that support specific coordinate systems
drawing: provides drawing tools that can draw polygons, rectangles, polylines, circles, and markers on the map
visualization: provides heat maps and dot maps to easily understand data with geographical information

4. Apply authentication key

You must apply the authentication key (Client ID, Client Secret), issued through the application registration according to the 2. Subscribe to Maps procedure, to your development project. That is, you can use Maps APIs by applying the issued authentication key to the settings file of your development project. For Maps REST API, enter the authentication key in the header. Because the way to apply the authentication key differs for each development resource, see start guides for each resource. You can see the following guides:

Caution

Make sure the client ID and client secret are kept confidential. If you are concerned about security, reissue a new value. Check the procedure for reissuing the authentication key in Check application information.

5. Use APIs

You can implement NAVER Maps using the classes and libraries provided by NAVER Cloud Platform's Maps API. Start by creating a map object and reserving a place to display the map. For detailed instructions on how to implement, you must see development guides for each development resource. You can see the following development guides:

Caution

When implementing a service using Maps API, you cannot arbitrarily change the features and service names provided by NAVER Maps, and you must indicate the same as the names guided in this guide (street view, directions, navigation, satellite map, cadastral map, map search, public transportation, real-time traffic, and so on).
<Example>: if you use Web Dynamic Map to show "street view", it cannot be changed and indicated as "entrance view" or "road view".

6. View usage

View the usage of Maps APIs on NAVER Cloud Platform console. Since you are charged when exceeding a certain usage amount, you should manage the usage of Maps by setting a usage limit or by notifying when exceeding the limit. You can see the following user guides: