- HOME
- API 개요
- API 개요
- API 호출 및 인증
- API 데이터 타입
- VPC
- Compute
- BlockStorageVolumeType
- BlockStorageVolumeTypeList
- HypervisorTypeList
- ServerSpec
- ServerSpecList
- BlockStorageMapping
- ServerImage
- ServerImageList
- AccessControlGroup
- AccessControlGroupList
- AccessControlGroupNoList
- AccessControlGroupRule
- AccessControlGroupRuleList
- ActivityLog
- ActivityLogList
- AdjustmentType
- AdjustmentTypeList
- AutoScalingGroup
- AutoScalingGroupList
- CommonCode
- CommonResponse
- FlowLogConfiguration
- FlowLogConfigurationList
- InAutoScalingGroupServerInstance
- KeyName
- LaunchConfiguration
- LoginKey
- LoginKeyList
- MemberServerImage
- MemberServerImageInstance
- MemberServerImageInstanceList
- PlacementGroup
- PlacementGroupList
- PrivateKey
- PublicIpInstance
- PublicIpInstanceList
- LaunchConfigurationList
- Raid
- RaidList
- RootPassword
- RootPasswordServerInstance
- RootPasswordServerInstanceList
- ScalingPolicy
- ScalingPolicyList
- ScheduledUpdateGroupAction
- ScheduledUpdateGroupActionList
- SecondaryIpList
- ServerInstance
- ServerInstanceNoList
- ServerInstanceList
- SharedLoginIdList
- SuspendedProcess
- Zone
- ZoneList
- BlockDevicePartition
- BlockStorageInstance
- BlockStorageInstanceList
- BlockStorageSnapshotInstance
- BlockStorageSnapshotInstanceList
- InitScript
- InitScriptList
- NetworkInterface
- NetworkInterfaceList
- Process
- ProcessList
- ProtocolType
- Product
- ProductList
- Region
- RegionList
- Storage
- Networking
- CipherSuiteList
- HostHeaderList
- HostHeaderCondition
- IDResponse
- IpList
- LoadBalancerInstance
- LoadBalancerInstanceList
- LoadBalancerIpList
- LoadBalancerSubnet
- LoadBalancerListener
- LoadBalancerListenerList
- LoadBalancerRule
- LoadBalancerRuleAction
- LoadBalancerRuleCondition
- LoadBalancerRuleList
- LoadBalancerRuleNoList
- LoadBalancerListenerNoList
- NetworkAcl
- NatGatewayInstance
- NetworkAclDenyAllowGroup
- NetworkAclDenyAllowGroupList
- NetworkAclList
- NetworkAclRule
- NetworkAclRuleList
- NetworkInterfaceNoList
- PathPatternCondition
- PathPatternList
- PolicyDetailResponse
- PolicyRequest
- PolicyListResponse
- ProfileDetailResponse
- ProfileListResponse
- ProfileRequest
- RedirectionAction
- Route
- RouteList
- RouteTable
- RouteTableList
- Subnet
- SubnetList
- SubnetNoList
- Target
- TargetGroup
- TargetGroupAction
- TargetGroupList
- TargetGroupNoList
- TargetGroupWeight
- TargetList
- TargetNoList
- TargetSubnet
- TargetVpc
- Vpc
- VpcList
- VpcPeeringInstance
- VpcPeeringInstanceList
- NatGatewayInstanceList
- Database
- CloudMongoDbBucketList
- CloudMongoDbBucket
- CloudMssqlBucket
- CloudMssqlBucketList
- CloudMssqlFolder
- CloudMssqlFolderList
- CloudMssqlLogFile
- CloudMssqlLogFileList
- CloudDbProduct
- CloudDbProductList
- CloudMysqlBackup
- CloudMysqlBackupDetail
- CloudMysqlBackupDetailList
- CloudMysqlBackupList
- CloudMysqlDbServerLog
- CloudMysqlInstanceList
- CloudMysqlUser
- CloudMysqlEventHistory
- CloudMysqlEventHistoryList
- CloudRedisBackup
- CloudRedisBackupDetail
- CloudRedisBackupDetailList
- CloudRedisBackupList
- CloudMongoDbBackup
- CloudRedisConfigGroup
- CloudRedisConfigGroupList
- CloudRedisInstance
- CloudRedisInstanceList
- CloudRedisServerInstance
- CloudRedisUser
- CloudRedisUserList
- CloudMssqlBackup
- CloudMssqlBackupDetail
- CloudMssqlBackupDetailList
- CloudMssqlBackupList
- CloudMssqlLogBackupFile
- CloudMssqlLogBackupFileList
- CloudMssqlCharacterSet
- CloudMssqlCharacterSetList
- CloudMssqlConfigGroup
- CloudMssqlConfigGroupList
- CloudMssqlInstance
- CloudMssqlInstanceList
- CloudMssqlServerInstance
- CloudHadoopAddOn
- CloudMongoDbBackupDetail
- CloudMongoDbBackupDetailList
- CloudMongoDbBackupList
- CloudMongoDbInstance
- CloudMongoDbInstanceList
- CloudMongoDbServerInstance
- CloudHadoopNotebookInstance
- CloudHadoopVersion
- CloudHadoopInstanceList
- CloudPostgresqlConfigList
- CloudPostgresqlDatabase
- CloudPostgresqlDatabaseList
- CloudPostgresqlInstance
- CloudPostgresqlInstanceList
- CloudPostgresqlUser
- CloudPostgresqlUserList
- CloudPostgresqlBackupDetail
- CloudPostgresqlServerInstance
- CloudPostgresqlBucketList
- CloudMysqlInstanceForHiveMetaStore
- CloudRedisBucket
- CloudMysqlInstanceListForHiveMetaStore
- CloudMysqlUserForHiveMetaStore
- CloudMysqlUserListForHiveMetaStore
- CloudHadoopObject
- CloudHadoopObjectList
- CloudPostgresqlBackup
- CloudPostgresqlBackupList
- CloudPostgresqlBucket
- CloudPostgresqlDbServerLog
- CloudPostgresqlDbServerLogList
- CloudRedisConfigGroupVersionList
- CloudRedisConfigGroupVersion
- CloudRedisBucketList
- CloudMongoDbUserList
- CloudMongoDbUser
- CloudPostgresqlBackupDetailList
- CloudMysqlUserList
- CloudMysqlDatabase
- CloudMysqlDbServerLogList
- CloudMysqlDatabaseList
- CloudMysqlServerInstance
- CloudMysqlInstance
- CloudMysqlConfigList
- CloudMysqlRecoveryTime
- TargetSubnetList
- TargetVpcList
- AI·NAVER API
- Application Services
- Big Data & Analytics
- CloudHadoopAddOnList
- CloudHadoopBucket
- CloudHadoopClusterType
- CloudHadoopClusterTypeList
- CloudHadoopNotebookServerInstance
- CloudHadoopLoginKey
- CloudHadoopNotebookInstanceList
- CloudHadoopBucketList
- CloudHadoopNotebookBucket
- CloudHadoopInstance
- CloudHadoopLoginKeyList
- CloudHadoopNotebookBucketList
- CloudHadoopNotebookComponentList
- CloudHadoopNotebookComponent
- CloudHadoopNotebookVersion
- CloudHadoopServerInstance
- Compute
- Classic
- Platform
- Account
- AppliedCreditHistory
- AppliedProductDiscountHistory
- Coin
- CoinHistory
- CoinHistoryList
- CoinUseHistory
- Contract
- ContractDemandCost
- ContractDemandCostList 되지 않는
- ContractDemandCostList
- ContractList
- ContractSummary
- ContractProduct
- ContractUsageByDaily
- ContractUsageList
- ContractUsageListByDaily
- CostRelationCode
- CostRelationCodeList
- Credit
- CreditHistory
- CreditHistoryList
- CreditUseHistory
- CountryPeriodUnit
- CountryUnit
- DemandCost
- DemandCostList
- DiscountList
- Discount
- PackageUnit
- PeriodUnit
- Price
- PriceList
- Product
- ProductCategoryList
- ProductDemandCost
- ProductDemandCostByDiscount
- ProductDemandCostList
- ProductDemandType
- ProductDiscount
- ProductDiscountHistory
- ProductDiscountUseHistory
- Product(For Billing)
- ProductDemandCostByDiscountList
- ProductDiscountHistoryList
- ProductPrice
- ProductPriceList
- SectionPriceList
- SectionPrice
- Usage
- UseDate
- Region(For Billing)
- RegionList(For Billing)
- ProductList(For Billing)
- ShareCoinSnapshot
- Compute
- AccessControlGroup
- AccessControlGroupList
- AccessControlRule
- AccessControlRuleList
- ActivityLogList
- AsgPolicy
- AutoScalingGroupList
- AutoScalingGroup
- CommonResponse
- ConfigurationLog
- ConfigurationLogList
- InAutoScalingGroupServerInstance
- InitScriptList
- InstanceTag
- InstanceTagList
- LoginKey
- LoginKeyList
- MemberServerImage
- MemberServerImageList
- PortForwardingRule
- PublicIpInstance
- PublicIpInstanceList
- PortForwardingConfiguration
- PortForwardingConfigurationList
- PortForwardingRuleList
- PrivateKey
- Raid
- RaidList
- RootPassword
- RootPasswordServerInstance
- RootPasswordServerInstanceList
- ScalingPolicy
- ScalingPolicyList
- ScheduledUpdateGroupAction
- ScheduledUpdateGroupActionList
- ServerInstance
- ServerInstanceList
- ServerInstanceNoList
- SharedLoginIdList
- SuspendedProcess
- Zone
- ZoneList
- ProductList
- Region
- RegionList
- BlockStorageInstance
- BlockStorageInstanceList
- BlockStorageSnapshotInstance
- BlockStorageSnapshotInstanceList
- LaunchConfiguration
- LaunchConfigurationList
- Process
- ProcessList
- CommonCode
- Storage
- Networking
- DomainCreateRequest
- DomainDetailResponse
- DomainResponse
- DomainUsage
- DomainQueryResponse
- LbRecordResponse
- LoadBalancerInstance
- LoadBalancerInstanceList
- LoadBalancerInstanceSummary
- LoadBalancerRule
- LoadBalancedServerInstance
- RecordCreateRequest
- RecordUpdateRequest
- RecordResponse
- ServerHealthCheckStatus
- SslCertificate
- SslCertificateList
- Application Services
- AddressBookRequest
- AddressBookResponse
- AttachFile
- Category
- CountByStatus
- EmailRecipientType
- EmailReservationStatus
- EmailStatus
- HistoryActionType
- MailListResponse
- NesDateTime
- Recipient
- RequesterType
- RequestListResponse
- RecipientForRequest
- Sort
- TemplateBackupStatus
- TemplateExportRequestResponse
- TemplateStructureResponse
- UnsubscribersListResponse
- Management & Governance
- ChartDataWidgetDto
- CreateOrUpdateMetricsGrpDto
- CreateOrUpdateRuleGroupDto
- DataQueryRequest
- DataQueryRequestMetricInfo
- DeleteRuleGroupItemDto
- DimensionsSelected
- DimensionDto
- DirectRuleGroupCreateDto
- EventSearchRequest
- EventSearchRequestById
- FieldDto
- MetricListRequest
- MetricsGroupItem
- MonitorGrpDto
- MonitorGroupItem
- PersonalRecipientNotification
- PMCreateUpdateDto
- RecipientNotification
- RecipientGroupFilter
- RuleGroupItemDto
- SendBlockHistoryResponse
- SuspendRuleItemDto
- TypeGroupRelatedRuleDto
- WidgetMetricInfoDto
- Big Data & Analytics
- Platform
- VPC
- Platform
- Compute
- Server (VPC)
- Server (VPC) 개요
- Server
- Login Key
- Placement Group
- getServerInstanceList
- getServerInstanceDetail
- createServerInstances
- startServerInstances
- stopServerInstances
- rebootServerInstances
- terminateServerInstances
- changeServerInstanceSpec
- getRootPassword
- getRootPasswordServerInstanceList
- setProtectServerTermination
- interruptServerInstance
- Server Image
- getServerImageList
- getServerImageDetail
- deleteServerImage
- createserverimage
- createServerImageFromSnapshot
- getMemberServerImageInstanceList
- getMemberServerImageInstanceDetail
- createMemberServerImageInstance
- deleteMemberServerImageInstances
- setMemberServerImageSharingPermission
- addMemberServerImageSharingPermission
- removeMemberServerImageSharingPermission
- removeServerImageSharingPermission
- addServerImageSharingPermission
- Storage
- Snapshot
- Public IP
- Init Script
- Network Interface
- disableFlowLog
- enableFlowLog
- getFlowLogConfigurationList
- getNetworkInterfaceList
- getNetworkInterfaceDetail
- createNetworkInterface
- deleteNetworkInterface
- attachNetworkInterface
- detachNetworkInterface
- addNetworkInterfaceAccessControlGroup
- removeNetworkInterfaceAccessControlGroup
- assignSecondaryIps
- unassignSecondaryIps
- ACG
- Common
- Server (VPC) 지표
- Server
- Server 개요
- getServerProductList
- getServerImageProductList
- getRaidList
- getZoneList
- getRegionList
- getInitScriptList
- getLoginKeyList
- createLoginKey
- deleteLoginKey
- importLoginKey
- getAccessControlGroupList
- getAccessControlGroupServerInstanceList
- getAccessControlRuleList
- getServerInstanceList
- createServerInstances
- recreateServerInstance
- terminateServerInstances
- changeServerInstanceSpec
- rebootServerInstances
- startServerInstances
- stopServerInstances
- getRootPassword
- getRootPasswordServerInstanceList
- getMemberServerImageList
- createMemberServerImage
- deleteMemberServerImages
- getBlockStorageInstanceList
- createBlockStorageInstance
- deleteBlockStorageInstances
- changeBlockStorageVolumeSize
- createBlockStorageSnapshotInstance
- deleteBlockStorageSnapshotInstances
- getBlockStorageSnapshotInstanceList
- getPublicIpInstanceList
- getPublicIpTargetServerInstanceList
- createPublicIpInstance
- associatePublicIpWithServerInstance
- disassociatePublicIpFromServerInstance
- deletePublicIpInstances
- getPortForwardingRuleList
- addPortForwardingRules
- deletePortForwardingRules
- createInstanceTags
- deleteInstanceTags
- getInstanceTagList
- getPortForwardingConfigurationList
- setMemberServerImageSharingPermission
- addMemberServerImageSharingPermission
- removeMemberServerImageSharingPermission
- attachBlockStorageInstance
- detachblockstorageinstances
- setProtectServerTermination
- interruptServerInstance
- Server 지표
- Auto Scaling (VPC)
- Auto Scaling (VPC) 개요
- Launch Configuration
- Auto Scaling Group
- getAutoScalingGroupList
- getAutoScalingGroupDetail
- createAutoScalingGroup
- updateAutoScalingGroup
- deleteAutoScalingGroup
- setDesiredCapacity
- getScheduledActionList
- putScheduledUpdateGroupAction
- deleteScheduledUpdateGroupAction
- getScalingProcessTypeList
- suspendProcesses
- resumeProcesses
- getAutoScalingActivityLogList
- getAutoScalingPolicyList
- getAdjustmentTypeList
- putScalingPolicy
- deleteScalingPolicy
- executePolicy
- Auto Scaling (VPC) 지표
- Auto Scaling
- Auto Scaling 개요
- getLaunchConfigurationList
- createLaunchConfiguration
- deleteAutoScalingLaunchConfiguration
- getAutoScalingGroupList
- createAutoScalingGroup
- updateAutoScalingGroup
- deleteAutoScalingGroup
- setDesiredCapacity
- terminateServerInstanceInAutoScalingGroup
- setServerInstanceHealth
- getScheduledActionList
- putScheduledUpdateGroupAction
- deleteScheduledAction
- suspendProcesses
- resumeProcesses
- getScalingProcessTypeList
- getAutoScalingActivityLogList
- getAutoScalingConfigurationLogList
- getAutoScalingPolicyList
- putScalingPolicy
- deletePolicy
- executePolicy
- getAdjustmentTypeList
- Auto Scaling 지표
- Cloud Functions
- Cloud Functions 개요
- Get Package List
- Get Package
- Put Package
- Delete Package
- Get Action List
- Get Action
- Put Action
- Post Action
- Delete Action
- Get Action's Activation List
- Get Action's Activation Detail
- Get Trigger List
- Get Trigger
- Put Trigger
- Post Trigger
- Delete Trigger
- Post Trigger Link Action
- Delete Trigger Link Action
- Get Trigger's Activation List
- Get Trigger's Activation Detail
- Get Activation List
- Post Trigger External Link
- Post Action External Link
- Metadata (VPC)
- Server (VPC)
- Containers
- Ncloud Kubernetes Service
- Ncloud Kubernetes Service 개요
- Cluster 목록 조회
- Cluster 조회
- Cluster 생성
- Cluster 버전 업그레이드
- Cluster Audit Log 설정
- Cluster Subnet 추가
- Cluster OIDC 설정
- Cluster OIDC 조회
- Cluster IP ACL 설정
- Cluster IP ACL 조회
- Cluster LB Subnet 수정
- Cluster 반납 보호 설정
- Cluster 시크릿 암호화 설정
- Cluster 인증 모드 설정
- Cluster IAM 액세스 목록 조회
- Cluster IAM 액세스 조회
- Cluster IAM 액세스 생성
- Cluster IAM 액세스 수정
- Cluster IAM 액세스 삭제
- Cluster 삭제
- WorkerNode 조회
- WorkerNode 삭제
- NodePool 조회
- NodePool 생성
- NodePool 수정
- NodePool Subnet 수정
- NodePool Label 수정
- NodePool Taint 수정
- NodePool 업그레이드
- NodePool 삭제
- Kubeconfig 조회
- k8s 지원 버전 조회
- 서버 이미지 조회
- 서버 스펙 조회
- Ncloud Kubernetes Service 지표
- Container Registry
- Ncloud Kubernetes Service
- Storage
- Object Storage
- Object Storage 개요
- ListBuckets
- PutBucket
- ListObjects
- ListObjectsV2
- HeadBucket
- DeleteBucket
- PutBucketACL
- GetBucketACL
- PutBucketCORS
- GetBucketCORS
- DeleteBucketCORS
- ListMultipartUploads
- PutObject
- PutObject (Copy)
- GetObject
- HeadObject
- DeleteObject
- DeleteMultipleObjects
- PutObjectACL
- GetObjectACL
- OptionsObjectCORS
- InitiateMultipartUpload
- UploadPart
- ListParts
- CompleteMultipartUpload
- AbortMultipartUpload
- Object Storage 지표
- Archive Storage
- NAS (VPC)
- NAS
- Object Storage
- Networking
- VPC
- VPC 개요
- VPC Management
- Subnet Management
- Network ACL
- getNetworkAclList
- getNetworkAclDetail
- createNetworkAcl
- deleteNetworkAcl
- setSubnetNetworkAcl
- getNetworkAclRuleList
- addNetworkAclInboundRule
- addNetworkAclOutboundRule
- removeNetworkAclInboundRule
- removeNetworkAclOutboundRule
- setNetworkAclDescription
- getNetworkAclDenyAllowGroupList
- getNetworkAclDenyAllowGroupDetail
- createNetworkAclDenyAllowGroup
- deleteNetworkAclDenyAllowGroup
- setNetworkAclDenyAllowGroupIpList
- setNetworkAclDenyAllowGroupDescription
- NAT Gateway
- VPC Peering
- Route Table
- Load Balancer (VPC)
- Load Balancer 개요
- Load Balancer
- getLoadBalancerInstanceList
- getLoadBalancerInstanceDetail
- createLoadBalancerInstance
- deleteLoadBalancerInstances
- changeLoadBalancerInstanceConfiguration
- setLoadBalancerInstanceSubnet
- setLoadBalancerDescription
- getLoadBalancerListenerList
- createLoadBalancerListener
- deleteLoadBalancerListeners
- changeLoadBalancerListenerConfiguration
- getLoadBalancerRuleList
- Target Group
- Load Balancer (VPC) 지표
- Load Balancer
- Load Balancer 개요
- getLoadBalancerInstanceList
- getLoadBalancerTargetServerInstanceList
- createLoadBalancerInstance
- changeLoadBalancerInstanceConfiguration
- getLoadBalancedServerInstanceList
- changeLoadBalancedServerInstances
- deleteLoadBalancerInstances
- getLoadBalancerSslCertificateList
- addLoadBalancerSslCertificate
- deleteLoadBalancerSslCertificate
- Load Balancer 지표
- Global DNS
- Global Traffic Manager
- VPC
- Database
- Cloud DB for MySQL (Classic)
- Cloud DB for MySQL (VPC)
- Cloud DB for MySQL (VPC) 개요
- addCloudMysqlDatabaseList
- addCloudMysqlUserList
- changeCloudMysqlServerSpec
- changeCloudMysqlUserList
- createCloudMysqlInstance
- createCloudMysqlRecoveryInstance
- createCloudMysqlSlaveInstance
- deleteCloudMysqlDatabaseList
- deleteCloudMysqlInstance
- deleteCloudMysqlServerInstance
- deleteCloudMysqlUserList
- exportBackupToObjectStorage
- exportDbServerLogToObjectStorage
- getCloudMysqlBackupDetailList
- getCloudMysqlBackupList
- getCloudMysqlDatabaseList
- getCloudMysqlEventHistoryList
- getCloudMysqlImageProductList
- getCloudMysqlInstanceDetail
- getCloudMysqlInstanceList
- getCloudMysqlProductList
- getCloudMysqlRecoveryTime
- getCloudMysqlTargetSubnetList
- getCloudMysqlTargetVpcList
- getCloudMysqlUserList
- getDbServerLogList
- rebootCloudMysqlServerInstance
- Cloud DB for MySQL (VPC) 지표
- Cloud DB for Redis(VPC)
- Cloud DB for Redis(VPC) 개요
- addCloudRedisUserList
- changeCloudRedisUserList
- createCloudRedisConfigGroup
- createCloudRedisInstance
- deleteCloudRedisConfigGroup
- deleteCloudRedisInstance
- deleteCloudRedisUserList
- getCloudRedisBackupDetailList
- getCloudRedisBackupList
- getCloudRedisConfigGroupList
- getCloudRedisImageProductList
- getCloudRedisInstanceDetail
- getCloudRedisInstanceList
- getCloudRedisProductList
- getCloudRedisUserList
- Cloud DB for Redis (VPC) 지표
- rebootCloudRedisServerInstance
- flushAllCloudRedisServerInstance
- getCloudRedisTargetVpcList
- getCloudRedisTargetSubnetList
- createCloudRedisManualBackup
- deleteCloudRedisManualBackup
- getCloudRedisManualBackupList
- getCloudRedisManualBackupDetailList
- getCloudRedisBucketList
- exportBackupToObjectStorage
- getCloudRedisConfigGroupVersionList
- Cloud DB for MSSQL (VPC)
- Cloud DB for MSSQL (on VPC) 개요
- createCloudMssqlInstance
- createCloudMssqlSlaveInstance
- deleteCloudMssqlInstance
- deleteCloudMssqlServerInstance
- exportDbServerLogsToObjectStorage
- exportBackupToObjectStorage
- getCloudMssqlLogBackupFileList
- getCloudMssqlBackupDetailList
- getCloudMssqlBackupList
- getCloudMssqlCharacterSetList
- getCloudMssqlConfigGroupList
- getCloudMssqlImageProductList
- getCloudMssqlInstanceDetail
- getCloudMssqlInstanceList
- getCloudMssqlProductList
- getCloudMssqlTargetSubnetList
- getCloudMssqlTargetVpcList
- getCloudMssqlLogFileList
- getCloudMssqlFolderList
- getCloudMssqlBucketList
- rebootCloudMssqlServerInstance
- Cloud DB for MSSQL (VPC) 지표
- Cloud DB for MongoDB (VPC)
- Cloud DB for MongoDB (on VPC) 개요
- addCloudMongoDbUserList
- changeCloudMongoDbConfigCount
- changeCloudMongoDbMongosCount
- changeCloudMongoDbSecondaryCount
- changeCloudMongoDbShardCount
- changeCloudMongoDbUserList
- createCloudMongoDbInstance
- deleteCloudMongoDbInstance
- deleteCloudMongoDbUserList
- getCloudMongoDbBucketList
- exportBackupToObjectStorage
- getCloudMongoDbBackupDetailList
- getCloudMongoDbBackupList
- getCloudMongoDbImageProductList
- getCloudMongoDbInstanceDetail
- getCloudMongoDbInstanceList
- getCloudMongoDbProductList
- getCloudMongoDbTargetSubnetList
- getCloudMongoDbTargetVpcList
- getCloudMongoDbUserList
- rebootCloudMongoDbServerInstance
- getDbServerLogList
- exportDbServerLogToObjectStorage
- Cloud DB for MongoDB (VPC) 지표
- Cloud DB for PostgreSQL(VPC)
- Cloud DB for PostgreSQL 개요
- addCloudPostgresqlDatabaseList
- addCloudPostgresqlUserList
- changeCloudPostgresqlUserList
- createCloudPostgresqlInstance
- createCloudPostgresqlReadReplicaInstance
- deleteCloudPostgresqlDatabaseList
- deleteCloudPostgresqlInstance
- deleteCloudPostgresqlReadReplicaInstance
- deleteCloudPostgresqlUserList
- exportBackupToObjectStorage
- exportDbServerLogToObjectStorage
- getCloudPostgresqlBackupDetailList
- getCloudPostgresqlBackupList
- getCloudPostgresqlBucketList
- getCloudPostgresqlDatabaseList
- getCloudPostgresqlImageProductList
- getCloudPostgresqlInstanceDetail
- getCloudPostgresqlInstanceList
- getCloudPostgresqlProductList
- getCloudPostgresqlTargetSubnetList
- getCloudPostgresqlTargetVpcList
- getCloudPostgresqlUserList
- getDbServerLogList
- rebootCloudPostgresqlServerInstance
- Cloud DB for PostgreSQL (VPC) 지표
- Security
- Secure Zone
- Secure Zone 개요
- setDefaultDenyEventLogStatus
- getIpsecAddress
- getDefaultDenyEventLogStatus
- getAddressGroup
- updateAddressGroup
- rearrangePolicy
- updatePolicy
- getHourlyTrafficUsageList
- getTrafficLog
- getAddressGroupList
- getPolicyList
- deleteAddressGroup
- addPolicy
- getPolicy
- getMemberInfo
- getTrafficUsage
- checkPolicyNameDuplicated
- addAddressGroup
- deletePolicy
- checkAddressGroupNameDuplicated
- getMemberActionLog
- File Safer
- Security Monitoring
- Web Security Checker
- Key Management Service
- Webshell Behavior Detector
- Private CA
- PrivateCA 개요
- Activate Sub CA
- Add CA User
- Create CA
- Create OCSP
- Delete CA
- Delete CA User
- Delete OCSP
- Get CA
- Get CA Chain
- Get CA CRL
- Get CA List
- Get CA User List
- Get CRL Config
- Get End Cert
- Get End Cert List
- Get Sub CSR
- Issue End Cert
- Revoke End Cert
- Rotate CRL
- Sign End CSR
- Sign Sub CSR
- Trim CA
- Update CA
- Update CRL Config
- Certificate Manager
- Secure Zone
- AI Services
- Application Services
- GeoLocation (deprecated)
- Simple & Easy Notification Service
- Cloud Outbound Mailer
- Cloud Outbound Mailer 개요
- deleteFile
- getFile
- createConfig
- deleteUnsubscribers
- getConfig
- deleteCategory
- registerUnsubscribers
- createCategory
- createTemplate
- updateTemplateLocationOrName
- createAddressBook
- createTemplateExportRequest
- deleteRecipientGroup
- updateCategory
- getTemplateStructure
- deleteAddressBook
- createFile
- updateTemplate
- deleteAddress
- getMailRequestStatus
- exportTemplate
- restoreTemplate
- getAddressBook
- getMailRequestList
- deleteRecipientGroupRelation
- getMail
- getTemplateExportRequestList
- getUnsubscribersList
- importTemplate
- getMailList
- deleteRecipientGroupRelationEmpty
- getSendBlockList
- getTemplate
- deleteTemplate
- createMailRequest
- API Gateway
- API Gateway 개요
- API
- API Key
- Authorizer
- Canary Test
- Dashboard API Key
- Dashboard Event
- Dashboard Product
- Document
- Export
- Gateway Response
- Gateway Response Header
- Gateway Response Template
- Method
- Method Request Body
- Method Request Parameter
- Method Response
- Method Response Body
- Method Response Header
- Model
- Product
- Published Product
- Resource
- Stage
- Stage Deployment
- Stage Resource
- Usage Plan
- AI·NAVER API
- Big Data & Analytics
- Cloud Hadoop (VPC)
- Cloud Hadoop (VPC) 개요
- backupClusterConfiguration
- changeCloudHadoopNodeCount
- changeCloudHadoopNodeSpec
- createCloudHadoopInstance
- createCloudHadoopNotebookInstance
- deleteCloudHadoopInstance
- deleteCloudHadoopNotebookInstance
- getCloudHadoopAddOnList
- getCloudHadoopBucketList
- getCloudHadoopClusterTypeList
- getCloudHadoopImageProductList
- getCloudHadoopInstanceDetail
- getCloudHadoopInstanceList
- getCloudHadoopLoginKeyList
- getCloudHadoopMysqlInstanceList
- getCloudHadoopMysqlUserList
- getCloudHadoopNotebookBucketList
- getCloudHadoopNotebookComponentList
- getCloudHadoopNotebookImageProductList
- getCloudHadoopNotebookInstanceDetail
- getCloudHadoopNotebookInstanceList
- getCloudHadoopNotebookProductList
- getCloudHadoopObjectList
- getCloudHadoopProductList
- getCloudHadoopTargetSubnetList
- getCloudHadoopTargetVpcList
- saveExternalHiveMetaStore
- testConnectExternalHiveMetaStore
- Cloud Hadoop (VPC) 지표
- Cloud Hadoop
- Cloud Search
- Cloud Search 개요
- Domain 목록 조회
- Domain 삭제
- Domain 생성
- Domain 수정
- Domain 조회
- Domain 중복 확인
- Ranking default 변경
- Ranking 목록 조회
- Ranking 삭제
- Ranking 생성
- Ranking 조회
- 동의어 사전 중복 확인
- 임시 Domain 목록 조회
- 임시 Domain 삭제
- 임시 Domain 생성
- 임시 Domain 수정
- 임시 Domain 조회
- Schema 검증
- Schema 수정
- Schema 이력 조회
- Schema 조회
- Document 검색
- Document 관리
- Object Storage Document 관리
- Query Analysis Count
- Query Analysis Group By Count
- Query Analysis Time Series
- DB Connection 확인 (VPC)
- DB Table 매핑 (VPC)
- DB Table 조회 (VPC)
- DB upload 실행 (VPC)
- 자동 완성 검색
- 자동 완성 설정 및 수정
- 자동 완성 설정 이력 조회
- 자동 완성 설정 조회
- Container 개수 변경
- Container 목록 조회
- Container 타입 변경
- Monitoring data 조회
- 불용어 정책 목록 조회
- 불용어 정책 삭제
- 불용어 정책 설정
- 불용어 정책 조회
- 형태소 분석 가능한 언어 조회
- 형태소 분석 옵션 조회 - 가능한 언어 목록
- 형태소 분석기 조회 - 특정 언어
- 동의어 사전 목록 조회
- 동의어 사전 버전 조회
- 동의어 사전 삭제
- 동의어 사전 설정
- 동의어 사전 수정
- 동의어 사전 이름 조회
- 동의어 사전 조회
- 사용량 제한 변경
- 사용량 제한 조회
- Cloud Search 지표
- Search Engine Service (VPC)
- Search Engine Service 개요
- Cluster
- Search Engine Cluster 생성 (VPC)
- Search Engine Version 조회(VPC)
- OS Product 조회
- Node Product 조회
- VPC 목록 조회
- Subnet 목록 조회
- Search Engine Cluster 삭제
- Search Engine Cluster 노드 추가
- Search Engine Cluster 재시작
- Search Engine User 패스워드 초기화
- Search Engine Cluster 목록 조회
- Search Engine Cluster Data 노드 조회
- Search Engine Cluster ACG 조회
- Search Engine Cluster 노드 그룹별 스펙 조회
- Search Engine Cluster 노드 그룹별 변경 가능 스펙 조회
- Search Engine Cluster 노드 스펙 변경
- Search Engine Cluster 노드 타입 변경
- 인증키 목록 조회
- Rolling Upgrade Pre Check
- Rolling Upgrade Cluster
- Rolling Upgrade 진행 상태 조회
- Dashboard
- Monitoring
- Snapshot
- Import
- Search Engine Service 지표
- Cloud Data Streaming Service (VPC)
- Cloud Data Streaming Service 개요
- Cluster
- Cluster Rolling 재시작 진행 상태 조회
- Cluster Rolling 재시작 요청
- Cluster Rolling 재시작 사전 체크
- Rolling UpGrade 진행 상태 조회
- Rolling UpGrade 요청
- Rolling UpGrade 사전 체크
- Cloud Data Streaming Service Cluster 생성 (VPC)
- Cloud Data Streaming Service Cluster 생성 (Return ID)
- Cloud Data Streaming Service Version 조회
- OS Product 조회
- Node Product 조회
- VPC 목록 조회
- Subnet 목록 조회
- Cloud Data Streaming Service Cluster 삭제
- Cloud Data Streaming Service Cluster 노드 추가
- 전체 서비스 재시작
- CMAK 재시작
- Kafka 재시작
- 노드별 Kafka 재시작
- CMAK 접속 패스워드 초기화
- Cloud Data Streaming Service Cluster 목록 조회
- Cloud Data Streaming Service Cluster 단건 조회
- 클러스터 상태 확인
- Cloud Data Streaming Service Cluster 노드 조회
- 브로커 노드 정보 확인
- Cloud Data Streaming Service Cluster ACG 조회
- 인증서 다운로드
- Public Domain 활성화
- Public Domain 비활성화
- 로드밸런서 목록 조회
- Broker 노드 Public Endpoint 활성화
- Broker 노드 Public Endpoint 비활성화
- 노드 그룹별 스펙 조회
- 노드 그룹별 변경 가능 스펙 조회
- 노드 스펙 변경
- Monitoring
- ConfigGroup
- Cloud Data Streaming Service 지표
- Cloud Hadoop (VPC)
- Business Applications
- Developer Tools
- SourceCommit
- SourceBuild
- SourceDeploy
- SourceDeploy 개요
- 프로젝트 목록
- 프로젝트 생성
- 프로젝트 삭제
- 스테이지 목록
- 스테이지 상세
- 스테이지 생성
- 스테이지 수정
- 스테이지 삭제
- 시나리오 목록
- 시나리오 상세
- 시나리오 생성
- 시나리오 수정
- 시나리오 삭제
- 배포 시작
- 배포 취소
- 배포 승인 요청
- 배포 승인
- 배포 거절
- Canary 배포 승인(VPC)
- Canary 배포 거절 (VPC)
- 배포 이력 목록
- 배포 이력 상세
- Canary 분석 단계 목록 조회(VPC)
- Canary 분석 리포트 (VPC)
- Server 목록
- AutoScalingGroup 목록 조회
- KubernetesService 클러스터 목록(VPC)
- targetGroup 목록(VPC)
- SourceCommit 리파지토리 목록(VPC)
- SourceCommit 브랜치 목록(VPC)
- SourceBuild 목록
- ObjectStorage 버킷 목록
- ObjectStorage 오브젝트 목록
- SourcePipeline
- Content Delivery
- Management & Governance
- Cloud Log Analytics
- Cloud Log Analytics 개요
- 서버 목록 조회
- Classic 서버 목록 조회
- Classic CDB-MySQL 서버 목록 조회
- Classic Baremetal 서버 목록 조회
- VPC 서버 목록 조회
- VPC CDB-MySQL서버 목록 조회
- VPC CDB-MSSQL 서버 목록 조회
- VPC CDB-MongoDB 서버 목록 조회
- VPC CDB-PostgreSQL 서버 목록 조회
- VPC Baremetal 서버 목록 조회
- VPC Search Engine Service 서버 목록 조회
- VPC Cloud Data Streaming Service 서버 목록 조회
- VPC Ncloud Kubernetes Service 서버 목록 조회
- 서버 로그 수집 설정
- 서버 로그 수집 해제
- 로그 수 조회
- 로그 검색
- 로그 내보내기
- 사용량 조회
- Sub Account
- Sub Account 개요
- 서브 계정
- 서브계정 목록 조회
- 서브계정 조회
- 서브계정 수정
- 서브계정 생성
- 서브계정 삭제
- Access Key 조회
- Access Key 생성
- Access Key 삭제
- Access Key 상태 설정
- 로그인 접속키 조회
- 로그인 접속키 설정
- 로그인 아이디 체크
- 로그인 비밀번호 체크
- 유휴 세션 만료 시간 조회
- 유휴 세션 만료 시간 설정
- 로그인 비밀번호 만료일 조회
- 로그인 비밀번호 만료일 설정
- 로그인 비밀번호 재설정
- 정책 할당
- 정책 삭제
- 그룹 추가
- 그룹 삭제
- 콘솔 접근 규칙 조회
- 콘솔 접근 규칙 수정
- API 접근 규칙 조회
- API 접근 규칙 수정
- 2차 인증 정보 조회
- 태그 조회
- 태그 추가
- 태그 삭제
- 사용자 정보 조회
- 사용자 아이디 조회
- 그룹
- 정책
- 역할
- External Access
- Trust Anchor 목록 조회
- Trust Anchor 조회
- Trust Anchor 생성
- Trust Anchor 수정
- Trust Anchor 활성화
- Trust Anchor 비활성화
- Trust Anchor 삭제
- Profile 목록 조회
- Profile 조회
- Profile 생성
- Profile 수정
- Profile 활성화
- Profile 비활성화
- Proflie 삭제
- Subject 목록 조회
- Subject 조회
- Subject Activity 목록 조회
- CRL 목록 조회
- CRL 단건 조회
- CRL 생성
- CRL 수정
- CRL 활성화
- CRL 비활성화
- CRL 삭제
- Web service Monitoring System
- Resource Manager
- Cloud Activity Tracer
- Cloud Insight
- Cloud Insight 개요
- Dashboard
- Event
- Event Rule
- CopyRuleGroup
- CreateMetricsGrp
- CreateMonitorGrp
- CreateRuleDirectly
- CreateRuleGroup
- DeleteMetricGroupForce
- DeleteMetricsGrp
- DeleteMetricsGrpByProdKeyAndId
- DeleteMonitorGroupForce
- DeleteMonitorGrp
- DeleteRuleGroup
- DeleteRuleGroupByProdKeyAndId
- GetAllMonitorGrp
- GetMetricsGroup
- GetMetricsGroupList
- GetMonitorGrp
- GetNotificationRecipientList
- GetRuleGroup
- GetRuleGroupByMetricGroupIds
- GetRuleGroupByMonitorGroupIds
- GetRuleGroupList
- RemoveResourceFromRules
- SearchMetricList
- UpdateMetricsGroup
- UpdateMonitorGrp
- UpdateRuleGroup
- Schema
- Custom Resource
- Planned Maintenance
- Plugin
- Server
- Data
- Integration
- Cloud Insight 지표
- Secure Token Service
- Ncloud Single Sign-On
- Ncloud Single Sign-On 개요
- 계정에 사용자 정의 정책 존재 여부 확인
- Application 목록 조회
- Application 단건 조회
- Application 생성
- Application 수정
- Application 삭제
- Tenant 조회
- Tenant 생성
- Tenant 수정
- Tenant 삭제
- [Oauth2] Client Secret 재생성
- External IDP 등록
- External IDP 조회
- External IDP 삭제
- External IDP 수정
- Attribute Mapper 수정
- Attribute Mapper 조회
- External IDP 메타데이터 파싱
- Ncloud Single Sign-On 메타데이터 조회
- Ncloud Single Sign-On URL데이터 조회
- External IDP 로그인 설정
- Organization 연동
- User 로그인 아이디 유효성 검사
- User 생성
- User 대량 생성
- User 수정
- User 삭제
- User 목록 삭제
- User 목록 조회
- User 단건 조회
- User Access Rules 조회
- User Access Rules 수정
- User Profile 조회
- User를 Group에 추가
- User를 포함하는 Group 목록 조회
- User를 포함하는 Group 단건 조회
- User를 Group에서 제거
- User 상태 변경
- User Session 조회
- User Session 만료
- User가 속한 Assignment 목록 조회
- User를 Assignment에서 제거
- Group 이름 유효성 검사
- Group 생성
- Group 목록 조회
- Group 단건 조회
- Group 수정
- Group 삭제
- Group 목록 삭제
- Group을 User에 추가
- Group에 속한 User 목록 조회
- Group이 속한 Assignment 목록 조회
- Group을 User에서 제거
- Group을 Assignment에서 제거
- Permission Set 목록 조회
- Permission Set 단건 조회
- Permission Set 생성
- Permission Set 수정
- Permission Set 삭제
- Permission Set 다건 삭제
- Permission Set에 할당할 수 있는 Policy 목록 조회
- Permission Set 내 Policy 존재 여부 확인
- Permission Set 내 Policy 삭제
- Permission Set 이름 유효성 검사
- Assignment 생성
- Assignment 목록 조회
- Assignment 단건 조회
- Assignment 수정
- Assignment 상태 변경
- Assignment 삭제
- Assignment Target 조회
- Assignment Target 추가
- Assignment Target 삭제
- Assignment에 IP ACL 추가
- Assignment에 속한 IP ACL 목록 조회
- Assignment에 속한 IP ACL 삭제
- Account 목록 조회
- IP ACL 이름 유효성 검사
- IP ACL 생성
- IP ACL 수정
- IP ACL 목록 삭제
- IP ACL 단건 삭제
- IP ACL 목록 조회
- IP ACL 단건 조회
- IP ACL에 Assignment 추가
- IP ACL이 포함된 Assignment 조회
- IP ACL에 할당된 Assignment 제거
- Cloud Log Analytics
- Media
- Hybrid & Private Cloud
개요
길찾기 API는 지도 앱 메인 화면에서 주요 지역까지의 소요 시간과 거리, 예상 유류비, 통행 요금 정보를 제공합니다.
그리고 경로상 분기점에서 안내가 필요한 경우 해당 지점에서의 guide code를 제공합니다.
요청
curl "https://naveropenapi.apigw.gov-ntruss.com/map-direction/v1/driving?start={출발지}&goal={목적지}&option={탐색옵션}" \
-H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}" \
-H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v
요청 파라미터
길찾기 API의 쿼리 스트링 파라미터에 공통으로 해당되는 내용입니다.
- 별도의 정보가 없으면 거리의 단위는 meter, 시간의 단위는 milisecond(1/1000초)를 사용합니다.
- 문자열 인코딩은 UTF-8을 사용합니다.
파라미터 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
start | request position format | Y | 출발지 |
goal | multiple request position format | Y | - 목적지 하나 이상의 목적지 정보를 전달할 수 있으며, 복수 개의 목적지를 입력할 때는 : 로 연결입력한 목적지 정보 중 가장 적은 비용으로 도달할 수 있는 목적지로 경로가 생성됨 목적지의 최대 개수는 10개이며, 최초의 최적 목적지 좌표를 기준으로 직선거리 3km 이내의 좌표만 유효하게 판정 |
waypoints | multiple request position format list | N | - 경유지 최대 5개를 입력할 수 있으며 서로 다른 경유지의 구분자로 |(pipe char)를 사용 |
option | option code | N | - 탐색 옵션 옵션은 최대 3개까지 동시에 요청할 수 있으며, 여러 옵션은 ‘:'로 연결 기본값은 traoptimal |
cartype | cartype code | N | - 톨게이트 요금 계산용 차종 정보 기본값은 1이며 차종을 바탕으로 차량의 중량 또는 크기를 판단하지는 않음 3, 4, 5종은 option에서 traavoidtoll이 적용되지 않았더라도 하이패스 전용 톨게이트를 회피해서 탐색함 일반적인 승용차는 모두 1종 |
fueltype | fueltype code | N | 유류비 계산용 유종 (기본값은 gasoline) |
mileage | double | N | - 설정된 유류에 해당하는 연비 사용하는 차량의 연비를 사용자가 직접 입력하고자 할 때 사용하는 파라미터 기본값은 14 |
lang | lang string code | N | 언어 종류 (기본값은 ko) |
Request Position Format
- 필수 항목(경도, 위도)과 옵션 항목(이름, 지점 ID)을
,
문자로 연결한 문자열입니다. - 옵션 항목은 항목에 맞는 prefix가 필요합니다.
- 옵션 항목값은
,
,:
또는|
문자를 포함할 수 없습니다. - 숫자가 아닌 문자는 URL 인코딩이 필요합니다.
- 옵션 항목 간의 순서는 상관 없습니다.
다음은 request position format의 사용 예입니다.
- 기본 예:
127.12345,37.12345
- 이름 옵션 항목을 추가한 예:
127.12345,37.12345,name=출발지이름
Multiple Request Position Format
request position format 여러 개를 :
문자로 연결한 문자열입니다.
waypoints
의 각 항목은 독립적인 경유지이므로 name을 사용한 여러 개의 request position format을 사용할 수 있습니다.waypoints
예 1:127.12345,37.12345:128.12345,38.12345
waypoints
예 2:127.12345,37.12345:128.12345,38.12345,name=장소이름1
waypoints
예 3:127.12345,37.12345,name=장소이름1:128.12345,38.12345,name=장소이름2
Multiple Request Position Format list
multiple request position format 여러 개를 |
문자로 연결한 리스트 문자열입니다. 경유지 파라미터인 waypoints
가 이 형식을 사용합니다.
- 경유지가 두 개이고 각 경유지에 좌표가 두 개씩 있는 경우의 예:
127.12345,37.12345:127.23456,37.23456|128.12345,38.12345:128.23456,38.23456
Cartype Code
톨게이트 요금 계산용 차종 정보를 나타내는 코드입니다.
코드 | 설명 |
---|---|
1 | 1종(소형차) 2축 차량. 윤폭 279.4mm 이하 승용차, 소형승합차, 소형화물차 |
2 | 2종(중형차) 2축 차량. 윤폭 279.4mm 초과, 윤거 1,800mm 이하 중형승합차, 중형화물차 |
3 | 3종(대형차) 2축 차량. 윤폭 279.4mm 초과, 윤거 1,800mm 초과 대형승합차, 2축 대형화물차 |
4 | 4종(대형화물차) 3축 대형화물차 |
5 | 5종(특수화물차) 4축 이상 특수화물차 |
6 | 1종(경형자동차) 배기량 1000cc 미만으로 길이 3.6m, 너비 1.6m, 높이 2.0m 이하 |
Fueltype Code
유류비 계산용 유종을 나타내는 코드입니다.
스트링 코드 | 설명 |
---|---|
gasoline | 휘발유. 유류비 계산 시 사용 |
highgradegasoline | 고급 휘발유. 유류비 계산 시 사용 |
diesel | 경유. 유류비 계산 시 사용 |
lpg | LPG. 유류비 계산 시 사용 |
Option Code
탐색 옵션을 나타내는 코드입니다.(모든 경로는 교통정보를 반영하므로 출발지, 목적지, 옵션이 같더라도 같은 경로가 보장되지 않습니다.)
스트링 코드 | 탐색 종류 |
---|---|
trafast | 실시간 빠른길 |
tracomfort | 실시간 편한길 |
traoptimal | 실시간 최적 |
traavoidtoll | 무료 우선 |
traavoidcaronly | 자동차 전용도로 회피 우선 |
Language Code
지원되는 언어 종류를 나타내는 코드입니다.
스트링 코드 | 설명 |
---|---|
ko | 한국어 |
en | 영어 |
ja | 일본어 |
zh | 중국어 간체 |
요청 헤더
헤더 명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client ID X-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client Secret X-NCP-APIGW-API-KEY:{Client Secret} |
요청 바디
- 해당 API 는 요청 바디를 필요로 하지 않습니다.
응답
응답 바디
하위 구조체는 Object로 표현하며, route 내 각 항목의 속성은 일반적인 key-value 쌍("key": "value"
)으로 표현합니다.
속성 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
code | result code | Y | 응답 결과 코드 |
messge | string | Y | 응답 결과 문자열 |
currentDateTime | string | Y | 탐색 시점 시간 정보. ISO datetime format 사용 |
route | key: option code value: route unit ent array | Y | 응답결과 |
Route Unit Ent
경로 안내를 위한 속성들의 대분류를 나타냅니다.
속성 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
summary | summary | Y | 요약 정보 |
path | lng-lat position format array | Y | - 경로를 구성하는 모든 좌표열 해당 좌표들에는 0번부터 시작되는 index가 있으며, 이 index는 경로 정보를 표현하기 위한 pointIndex라는 명칭으로 활용됨 |
section | section unit | N | 해당 경로를 구성하는 주요 도로에 관한 정보열(모든 경로를 포함하는 정보는 아님) |
guide | guide unit for ent array | N | 안내 정보열 |
Summary
탐색된 경로의 요약 정보를 나타냅니다.
속성 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
start | response position format | Y | 출발지 |
goal | response position format | Y | 목적지 |
waypoints | response position format array | N | 경유지(경유하는 순서대로 array에 기록) |
distance | int | Y | 전체 경로 거리(meters) |
duration | int | Y | 전체 경로 소요 시간(milisecond(1/1000초)) |
bbox | lenth 2인 lng-lat position array | Y | 전체 경로 경계 영역. left bottom point와 right top point 두 개의 point array로 제공 |
tollFare | int | Y | 통행 요금(톨게이트) |
taxiFare | int | Y | 택시 요금(지자체별, 심야, 시경계, 복합, 콜비 감안) |
fuelPrice | int | Y | 해당 시점의 전국 평균 유류비와 연비를 감안한 유류비 |
Section Unit
탐색된 경로 중 주요 도로의 정보를 나타냅니다. 도로명을 기준으로 주행 길이가 긴 경로의 정보입니다.
속성 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
pointIndex | int | Y | 경로를 구성하는 좌표의 인덱스 |
pointCount | int | Y | 형상점 수 |
distance | int | Y | 거리(meters) |
name | string | Y | 도로명 |
congestion | congestion code | N | 구간 혼잡도 |
speed | int | N | 평균 속도 |
Guide Unit for Ent
회전 안내가 필요한 지점과 회전 안내까지의 거리 정보를 제공합니다.
속성 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
pointIndex | int | Y | 경로를 구성하는 좌표의 인덱스 |
type | guide code | Y | 안내 종류 |
instructions | string | N | 안내 문구 |
distance | int | Y | 이전 guide unit의 경로 구성 좌표 인덱스로부터 해당 guide unit의 경로 구성 좌표 인덱스까지의 거리(meters) |
duration | int | Y | 이전 guide unit의 경로 구성 좌표 인덱스로부터 해당 guide unit의 경로 구성 좌표 인덱스까지의 소요 시간(milisecond(1/1000초)) |
Result Code
ResultCode가 0이 아니면 탐색 실패입니다.
HttpStatusCode | ResultCode | ResultMessage | 설명 |
---|---|---|---|
200 | 0 | - | 길찾기 성공 |
200 | 1 | - | 출발지와 도착지가 동일 |
200 | 2 | - | 출발지 또는 도착지가 도로 주변이 아닌 경우 |
200 | 3 | - | 자동차 길찾기 결과 제공 불가 |
200 | 4 | - | 경유지가 도로 주변이 아닌 경우 |
200 | 5 | - | 요청 경로가 매우 긴 경우(경유지를 포함한 직선거리의 합이 1500km이상인 경우) |
lng-lat Position Format
경도, 위도로 된 좌표 정보를 나타냅니다. Length 2인 1차원 배열로, 경도, 위도 순서로 제공합니다(lng, lat).
예: [127.001122, 37.001122]
Response Position Format
출발지, 도착지, 경유지의 좌표 정보를 제공합니다.
속성 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
location | lng-lat position | Y | 지점 |
dir | view direction code | N | 경로상에서 location 좌표를 바라보는 방향. 경유지와 목적지에 대해서만 존재 가능 |
View Direction Code
경로상의 도착지/경유지에서 실제 도착지/경유지로 지정한 지점의 방향을 나타냅니다. 경로상 진행 방향 중심으로 방향을 지정합니다.
코드 | 설명 |
---|---|
0 | 전방 |
1 | 왼쪽 |
2 | 오른쪽 |
Guide Code
경로상 회전이 발생하거나 추가 안내가 필요한 지점에서 어떻게 진행할지 안내합니다.
코드 | 설명 |
---|---|
1 | 직진 방향 |
2 | 좌회전 |
3 | 우회전 |
4 | 왼쪽 방향 |
5 | 오른쪽 방향 |
6 | U턴 |
8 | 비보호 좌회전 |
11 | 왼쪽 8시 방향 |
12 | 왼쪽 9시 방향 |
13 | 왼쪽 11시 방향 |
14 | 오른쪽 1시 방향 |
15 | 오른쪽 3시 방향 |
16 | 오른쪽 4시 방향 |
21 | 로터리에서 직진 방향 |
22 | 로터리에서 U턴 |
23 | 로터리에서 왼쪽 7시 방향 |
24 | 로터리에서 왼쪽 8시 방향 |
25 | 로터리에서 왼쪽 9시 방향 |
26 | 로터리에서 왼쪽 10시 방향 |
27 | 로터리에서 왼쪽 11시 방향 |
28 | 로터리에서 12시 방향 |
29 | 로터리에서 오른쪽 1시 방향 |
30 | 로터리에서 오른쪽 2시 방향 |
31 | 로터리에서 오른쪽 3시 방향 |
32 | 로터리에서 오른쪽 4시 방향 |
33 | 로터리에서 오른쪽 5시 방향 |
34 | 로터리에서 6시 방향 |
41 | 왼쪽 도로로 진입 |
42 | 오른쪽 도로로 진입 |
47 | 휴게소로 진입 |
48 | 페리항로 진입 |
49 | 페리항로 진출 |
50 | 전방에 고속도로 진입 |
51 | 전방에 고속도로 진출 |
54 | 전방에 분기도로 진입 |
55 | 전방에 고가차로 진입 |
56 | 전방에 지하차도 진입 |
57 | 왼쪽에 고속도로 진입 |
58 | 왼쪽에 고속도로 진출 |
62 | 왼쪽에 고가차도 진입 |
63 | 왼쪽에 고가차도 옆길 |
64 | 왼쪽에 지하차도 진입 |
65 | 왼쪽에 지하차도 옆길 |
66 | 오른쪽에 고속도로 진입 |
67 | 오른쪽에 고속도로 진출 |
71 | 오른쪽에 고가차로 진입 |
72 | 오른쪽에 고가차도 옆길 |
73 | 오른쪽에 지하차도 진입 |
74 | 오른쪽에 지하차도 옆길 |
81 | 왼쪽에 본선으로 합류 |
82 | 오른쪽에 본선으로 합류 |
87 | 경유지 |
88 | 도착지 |
91 | 회전교차로에서 직진 방향 |
92 | 회전교차로에서 U턴 |
93 | 회전교차로에서 왼쪽 7시 방향 |
94 | 회전교차로에서 왼쪽 8시 방향 |
95 | 회전교차로에서 왼쪽 9시 방향 |
96 | 회전교차로에서 왼쪽 10시 방향 |
97 | 회전교차로에서 왼쪽 11시 방향 |
98 | 회전교차로에서 12시 방향 |
99 | 회전교차로에서 오른쪽 1시 방향 |
100 | 회전교차로에서 오른쪽 2시 방향 |
101 | 회전교차로에서 오른쪽 3시 방향 |
102 | 회전교차로에서 오른쪽 4시 방향 |
103 | 회전교차로에서 오른쪽 5시 방향 |
104 | 회전교차로에서 6시 방향 |
121 | 톨게이트 |
122 | 하이패스전용 톨게이트 |
123 | 원톨링 톨게이트 |
Congestion code
도로의 종별 및 실제 통행 속도 정보를 이용해 추정한 혼잡도 분류 코드입니다.
코드 | 설명 |
---|---|
0 | 값 없음 |
1 | 원활 |
2 | 서행 |
3 | 혼잡 |
다음은 혼잡도를 기준으로 도로 종별 통행 속도를 나타낸 표입니다.
(km/h) | 일반도로 | 국도 | 도시고속 | 고속도로 |
---|---|---|---|---|
원활 | 30 이상 | 40 이상 | 60 이상 | 70 이상 |
서행 | 15~30 | 20~40 | 30~60 | 40~70 |
혼잡 | 15 미만 | 20 미만 | 30 미만 | 40 미만 |
예시
요청 예시
curl "https://naveropenapi.apigw.gov-ntruss.com/map-direction/v1/driving?start=127.1058342,37.359708&goal=129.075986,35.179470&option=trafast" \
-H "X-NCP-APIGW-API-KEY-ID: {애플리케이션 등록 시 발급받은 client id 값}" \
-H "X-NCP-APIGW-API-KEY: {애플리케이션 등록 시 발급받은 client secret값}" -v
응답 예시
{
"code": 0,
"message": "길찾기를 성공하였습니다.",
"currentDateTime": "2018-12-21T14:45:34",
"route": {
"trafast": [
{
"summary": {
"start": {
"location": [
127.1058342,
37.3597078
]
},
"goal": {
"location": [
129.0759853,
35.1794697
],
"dir": 2
},
"distance": 382403,
"duration": 15372873,
"bbox": [
[
127.0833901,
35.1793188
],
[
129.0817364,
37.3599059
]
],
"tollFare": 24500,
"taxiFare": 319900,
"fuelPrice": 46027
},
"path": [
[
127.1059968,
37.3597093
],
....
[
129.0764276,
35.1795108
],
[
129.0762855,
35.1793188
]
],
"section": [
{
"pointIndex": 654,
"pointCount": 358,
"distance": 22495,
"name": "죽양대로",
"congestion": 1,
"speed": 60
},
{
"pointIndex": 3059,
"pointCount": 565,
"distance": 59030,
"name": "낙동대로",
"congestion": 1,
"speed": 89
},
{
"pointIndex": 4708,
"pointCount": 433,
"distance": 23385,
"name": "새마을로",
"congestion": 1,
"speed": 66
}
],
"guide": [
{
"pointIndex": 1,
"type": 3,
"instructions": "정자일로1사거리에서 '성남대로' 방면으로 우회전",
"distance": 21,
"duration": 4725
},
{
"pointIndex": 8,
"type": 3,
"instructions": "불정교사거리에서 '수원·용인, 미금역' 방면으로 우회전",
"distance": 186,
"duration": 42914
},
....
{
"pointIndex": 6824,
"type": 14,
"instructions": "연산교차로에서 '서면교차로, 시청·경찰청' 방면으로 오른쪽 1시 방향",
"distance": 910,
"duration": 125240
},
{
"pointIndex": 6842,
"type": 88,
"instructions": "목적지",
"distance": 895,
"duration": 111333
}
]
}
]
}
}