Login
      Contents x
      Maps overview
        • Print
        • PDF
        Contents

        Maps overview

          • Print
          • 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

          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
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          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.
          Logout