MENU
      Maps overview
        • PDF

        Maps overview

        • PDF

        Article summary

        Available in Classic and VPC

        Maps is a NAVER Cloud Platform software interface that enables you to create location-based services utilizing NAVER Maps content and data. It provides APIs for static map image generation, route navigation, address search, and address conversion features in RESTful form, and IAM authentication with API Gateway must be completed to call the APIs.

        Common Maps settings

        The following describes commonly used request and response formats in Maps APIs.

        Request

        The following describes the common request format.

        API URL

        The request API URL is as follows.

        Static Map: https://naveropenapi.apigw.ntruss.com/map-static/v2
        Directions 5: https://naveropenapi.apigw.ntruss.com/map-direction/v1
        Directions 15: https://naveropenapi.apigw.ntruss.com/map-direction-15/v1
        Geocoding: https://naveropenapi.apigw.ntruss.com/map-geocode/v2
        Reverse Geocoding: https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2
        HTTP

        Request headers

        The following describes the headers.

        FieldRequiredDescription
        x-ncp-apigw-api-key-idRequiredClient ID issued after application registration in NAVER Cloud Platform console
        x-ncp-apigw-api-keyRequiredClient secret issued after application registration in NAVER Cloud Platform console
        Note

        For information on how to register an application in the NAVER Cloud Platform console to obtain authentication information (client ID, client secret) required to use the API, see Maps User Guide.
        In the console, make sure that the API you want to use after registering the application is selected by clicking the [Edit] button. If it is not selected, you will receive a 429 (Quota Exceed) error.

        Response

        The following describes the common response format.

        Response status codes

        The following describes the response status codes.

        HTTP status codeCodeMessageDescription
        400100Bad Request ExceptionRequest syntax error
        401200Authentication FailedAuthentication failed
        401210Permission DeniedAccess unauthorized
        404300Not Found ExceptionNot found on server
        413430Request Entity Too LargeRequest size (10 MB) exceeded
        429400Quota ExceededRequest quota exceeded
        429410Throttle LimitedToo fast or frequent requests
        429420Rate LimitedToo many requests in a given time period
        503500Endpoint ErrorEndpoint error
        504510Endpoint TimeoutEndpoint timeout
        500900Unexpected ErrorUnknown error
        Note

        For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.

        Maps API

        The following describes the APIs provided by the Maps service.

        APIDescription
        Static MapCreate static map image
        Directions 5Navigate routes (up to 5 waypoints)
        Directions 15Navigate routes (up to 15 waypoints)
        GeocodingSearch address
        Reverse GeocodingConvert coordinates to address

        NAVER Cloud Platform provides a variety of related resources to help users better understand Maps APIs.


        Was this article helpful?

        What's Next
        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.