Maps quickstart

Available in VPC

You can easily implement NAVER Maps using Maps APIs of NAVER Cloud Platform. You can view how to use it in detail in Getting started with Maps and Using Maps, but we recommend that you first go through the full quickstart document. Reading the guide after learning the quickstart document will allow you to use Maps more efficiently.

Maps service has the following order in general to use the service and step by step explanations:

1. Set usage permissions
2. Subscribe for service
3. Issue authentication key
4. Project settings
5. Apply authentication key
6. Use APIs
7. Map Style Editor component styling
8. View usage

1. Set usage permissions

When Maps is needed to manage and share with multiple users, you can assign permissions per user and operate the service. 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. Subscribe for service

To use the Maps service, you must complete your subscription on the NAVER Cloud Platform console. These terms of service include provisions regarding the storage and use of data generated by the Maps service, the consignment of personal information, the company's obligations, and the customer's responsibilities. Be sure to review these terms before planning your service.

You can see the following user guides:

Maps subscription management

3. Issuing authentication key

To use the Maps service, you must first register an application on the NAVER Cloud Platform console to obtain an authentication key. 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:

VPC > Using Maps > Application > Register application

4. 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.

You can see the following guides:

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

5. Apply authentication key

You must apply the authentication key (Client ID, Client Secret), issued through the application registration according to the 2. Subscribe for service 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.

6. 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".

7. Map Style Editor component styling

Style the map content called by your service into a form that suits your service. You can create your own map by styling the colors and text of each map editing component or by directly editing icons.

You can see the following user guides:

8. 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:

VPC > Using Maps > Usage