Package google.maps.mapmanagement.v2alpha

색인

MapManagement

지도 관리 API는 클라우드 기반 지도 스타일 지정 리소스(MapConfigs, StyleConfigs, MapContextConfigs)에 대한 CRUD 작업을 지원합니다. 이 API를 사용하면 개발자가 지도의 시각적 모양을 관리하고 사양에 맞게 스타일을 지정할 수 있습니다.

CreateMapConfig

rpc CreateMapConfig(CreateMapConfigRequest) returns (MapConfig)

프로젝트에 MapConfig를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
CreateMapContextConfig

rpc CreateMapContextConfig(CreateMapContextConfigRequest) returns (MapContextConfig)

MapContextConfig를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
CreateStyleConfig

rpc CreateStyleConfig(CreateStyleConfigRequest) returns (StyleConfig)

StyleConfig를 만듭니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
DeleteMapConfig

rpc DeleteMapConfig(DeleteMapConfigRequest) returns (Empty)

MapConfig를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
DeleteMapContextConfig

rpc DeleteMapContextConfig(DeleteMapContextConfigRequest) returns (Empty)

MapContextConfig를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
DeleteStyleConfig

rpc DeleteStyleConfig(DeleteStyleConfigRequest) returns (Empty)

StyleConfig를 삭제합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetMapConfig

rpc GetMapConfig(GetMapConfigRequest) returns (MapConfig)

MapConfig를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetMapContextConfig

rpc GetMapContextConfig(GetMapContextConfigRequest) returns (MapContextConfig)

MapContextConfig를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
GetStyleConfig

rpc GetStyleConfig(GetStyleConfigRequest) returns (StyleConfig)

StyleConfig를 가져옵니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
ListMapConfigs

rpc ListMapConfigs(ListMapConfigsRequest) returns (ListMapConfigsResponse)

프로젝트의 MapConfig를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
ListMapContextConfigs

rpc ListMapContextConfigs(ListMapContextConfigsRequest) returns (ListMapContextConfigsResponse)

MapContextConfigs를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
ListStyleConfigs

rpc ListStyleConfigs(ListStyleConfigsRequest) returns (ListStyleConfigsResponse)

StyleConfigs를 나열합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
UpdateMapConfig

rpc UpdateMapConfig(UpdateMapConfigRequest) returns (MapConfig)

MapConfig를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
UpdateMapContextConfig

rpc UpdateMapContextConfig(UpdateMapContextConfigRequest) returns (MapContextConfig)

MapContextConfig를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
UpdateStyleConfig

rpc UpdateStyleConfig(UpdateStyleConfigRequest) returns (StyleConfig)

StyleConfig를 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

CreateMapConfigRequest

MapConfig 생성 요청입니다.

필드
parent

string

필수 항목입니다. MapConfig를 소유할 상위 프로젝트입니다. 형식: projects/{$my-project-id}
map_config

MapConfig

필수 항목입니다. 만들 MapConfig입니다.

CreateMapContextConfigRequest

MapContextConfig 생성 요청입니다.

필드
parent

string

필수 항목입니다. MapContextConfig를 소유할 상위 MapConfig입니다. 형식: projects/{project}/mapConfigs/{map_config}
map_context_config

MapContextConfig

필수 항목입니다. 생성할 MapContextConfig입니다.

CreateStyleConfigRequest

StyleConfig 생성 요청입니다.

필드
parent

string

필수 항목입니다. StyleConfig를 소유할 상위 프로젝트입니다. 형식: projects/{project}
style_config

StyleConfig

필수 항목입니다. 만들 StyleConfig입니다.

DeleteMapConfigRequest

MapConfig 삭제 요청입니다. MapConfig에 하위 MapContextConfig가 있는 경우 해당 MapContextConfig도 삭제됩니다.

필드
name

string

필수 항목입니다. 삭제할 MapConfig의 리소스 이름입니다. 형식: projects/{project}/mapConfigs/{map_config}
force

bool

선택사항입니다. true로 설정하면 이 MapConfig의 MapContextConfig도 삭제됩니다. 그렇지 않으면 MapConfig에 MapContextConfigs가 없는 경우에만 요청이 작동합니다.

DeleteMapContextConfigRequest

MapContextConfig 삭제 요청입니다.

필드
name

string

필수 항목입니다. 삭제할 MapContextConfig의 리소스 이름입니다. 형식: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}

DeleteStyleConfigRequest

StyleConfig 삭제 요청입니다.

필드
name

string

필수 항목입니다. 삭제할 StyleConfig의 리소스 이름입니다. 형식: projects/{project}/styleConfigs/{style_config}

GetMapConfigRequest

MapConfig를 가져오기 위한 요청입니다.

필드
name

string

필수 항목입니다. MapConfig의 리소스 이름입니다. 형식: projects/{project}/mapConfigs/{map_config}

GetMapContextConfigRequest

MapContextConfig 가져오기 요청입니다.

필드
name

string

필수 항목입니다. MapContextConfig의 리소스 이름입니다. 형식: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}

GetStyleConfigRequest

StyleConfig 가져오기 요청입니다.

필드
name

string

필수 항목입니다. StyleConfig의 리소스 이름입니다. 형식: projects/{project}/styleConfigs/{style_config}

ListMapConfigsRequest

MapConfigs를 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. MapConfigs를 소유하는 상위 프로젝트입니다. 형식: projects/{project}
page_size

int32

선택사항입니다. 반환할 최대 MapConfig 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 MapConfig가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 현재 지원되지 않습니다.
page_token

string

선택사항입니다. 이전 ListMapConfigs 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListMapConfigs에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 현재 지원되지 않습니다.

ListMapConfigsResponse

MapConfig를 나열하는 응답입니다.

필드
map_configs[]

MapConfig

MapConfig 목록입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. 현재 지원되지 않습니다.

ListMapContextConfigsRequest

MapContextConfigs를 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. MapContextConfigs를 소유하는 상위 MapConfig입니다. 형식: projects/{project}/mapConfigs/{map_config}
page_size

int32

선택사항입니다. 반환할 최대 MapContextConfigs 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 MapContextConfigs가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 현재 지원되지 않습니다.
page_token

string

선택사항입니다. 이전 ListMapContextConfigs 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListMapContextConfigs에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 현재 지원되지 않습니다.

ListMapContextConfigsResponse

MapContextConfigs 목록에 대한 응답입니다.

필드
map_context_configs[]

MapContextConfig

MapContextConfigs입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. 현재 지원되지 않습니다.

ListStyleConfigsRequest

StyleConfig를 나열하는 요청입니다.

필드
parent

string

필수 항목입니다. StyleConfigs를 소유한 상위 프로젝트입니다. 형식: projects/{project}
page_size

int32

선택사항입니다. 반환할 최대 StyleConfigs 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 50개의 StyleConfig가 반환됩니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 현재 지원되지 않습니다.
page_token

string

선택사항입니다. 이전 ListStyleConfigs 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListStyleConfigs에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 현재 지원되지 않습니다.
filter

string

선택사항입니다. ListStyleConfigs 호출의 필터 표현식입니다. 현재는 display_name을 기준으로 한 필터링만 지원됩니다. 예를 들어 display_name="My StyleConfig"은 표시 이름이 'My StyleConfig'인 모든 StyleConfig를 반환합니다.
view

StyleConfigView

선택사항입니다. 반환할 StyleConfig의 하위 집합입니다. 이 값이 설정되지 않은 경우 기본 동작은 FULL 뷰를 반환하는 것입니다.

ListStyleConfigsResponse

StyleConfig를 나열하는 응답입니다.

필드
style_configs[]

StyleConfig

StyleConfigs입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. 현재 지원되지 않습니다.

MapConfig

지도 API 클라이언트 애플리케이션의 단일 지도를 나타냅니다. MapConfig는 MapContextConfigs의 상위 리소스이며 SDK (모바일/웹)에서 맞춤 스타일을 사용 설정합니다. MapConfig에는 여러 MapContextConfig가 있을 수 있으며, 각 MapContextConfig는 특정 지도 변형에 스타일을 적용합니다. 다음 ID = 9

필드
name

string

출력 전용입니다. 식별자. 이 MapConfig의 리소스 이름입니다. 예: 'projects/my-project-123/mapConfigs/234' 출력 전용입니다.
display_name

string

선택사항입니다. 사용자가 지정한 이 MapConfig의 표시 이름입니다.
description

string

선택사항입니다. 사용자가 지정한 이 MapConfig의 설명입니다.
map_id

string

출력 전용입니다. 클라이언트 애플리케이션에서 지도를 식별하는 데 사용되는 이 MapConfig의 지도 ID입니다. 이 읽기 전용 필드는 MapConfig가 생성될 때 생성됩니다. 출력 전용입니다.
map_features

MapFeatures

선택사항입니다. 이 지도 구성에 적용되는 지도 기능입니다.
map_type

MapRenderingType

선택사항입니다. MapConfig의 지도 유형을 나타냅니다. 이 값이 설정되지 않으면 기본 동작은 래스터 지도 유형을 사용하는 것입니다.
create_time

Timestamp

출력 전용입니다. 지도 구성의 생성 시간을 나타냅니다. 출력 전용입니다.
update_time

Timestamp

출력 전용입니다. 지도 구성의 마지막 업데이트 시간을 나타냅니다. 출력 전용입니다.

MapContextConfig

지도의 스타일 지정 구성을 캡슐화합니다. MapContextConfig는 스타일 구성요소(예: StyleConfig 및 Datasets)를 MapConfig의 특정 지도 변형과 연결합니다. MapConfig가 SDK에 로드되면 MapContextConfig의 스타일 지정 및 데이터 세트 정보가 지정된 지도 변형에 적용됩니다. 다음 ID = 10;

필드
name

string

출력 전용입니다. 식별자. 이 MapContextConfig의 리소스 이름입니다. 예: projects/{project_id}/mapConfigs/{map_id}/mapContextConfigs/{map_context_config_id}
map_config

string

필수 항목입니다. 이 MapContextConfig와 연결된 MapConfig 리소스 이름입니다. 형식: projects/{project}/mapConfigs/{map_config} 이 필드는 필수이며 생략할 수 없습니다.
style_config

string

필수 항목입니다. 이 MapContextConfig의 스타일을 지정하는 StyleConfig 리소스 이름입니다. 이 필드는 필수이며 생략할 수 없습니다. 형식: projects/{project}/styleConfigs/{style_config}
dataset[]

string

선택사항입니다. 이 MapContextConfig와 연결된 데이터 세트 리소스 이름입니다. 이 필드는 선택사항이며 생략할 수 있습니다. 생략하면 데이터 세트가 MapContextConfig와 연결되지 않습니다. 데이터 세트가 지정되면 MapContextConfig에 적용됩니다. 형식: projects/{project}/datasets/{dataset}
alias

string

선택사항입니다. 이 MapContextConfig에 대해 사용자가 정의한 인간이 읽을 수 있는 이름입니다.
map_variants[]

MapVariant

필수 항목입니다. 이 MapContextConfig를 적용할 수 있는 지도 변형입니다. 비어 있으면 MapContextConfig가 ROADMAP 지도 변형에만 기본적으로 적용됩니다.
create_time

Timestamp

출력 전용입니다. MapContextConfig의 생성 시간을 나타냅니다. 출력 전용입니다.
update_time

Timestamp

출력 전용입니다. MapContextConfig의 마지막 업데이트 시간을 나타냅니다. 출력 전용입니다.

MapVariant

MapContextConfig를 적용할 수 있는 가능한 지도 변형입니다. 지도 변형은 밝은 변형과 어두운 변형으로 그룹화됩니다. 동일한 MapContextConfig의 경우 Light 변형을 Dark 변형과 페어링할 수 없습니다. 밝은 변형은 ROADMAP, SATELLITE, TERRAIN, NAVIGATION, TRANSIT, ABSTRACT3D, PHOTOREALISTIC3D입니다. 어두운 변형은 ROADMAP_DARK, NAVIGATION_LOW_LIGHT, TERRAIN_DARK, TRANSIT_DARK입니다.

예를 들어 {MapContextConfig 1: [ROADMAP, NAVIGATION]} {MapContextConfig 2: [ROADMAP_DARK, NAVIGATION_LOW_LIGHT]}는 유효한 페어링입니다.

다음은 유효하지 않은 페어링입니다. {MapContextConfig 1: [ROADMAP, ROADMAP_DARK]}

열거형
ROADMAP 기본 도로 지도 유형입니다.
ROADMAP_DARK 어두운 버전의 로드맵 지도 유형입니다.
SATELLITE 위성 이미지입니다.
TERRAIN 지형 지도 유형입니다.
TERRAIN_DARK 지형 지도 유형의 어두운 버전입니다.
NAVIGATION 탐색 지도 유형입니다.
NAVIGATION_LOW_LIGHT 탐색 지도 유형의 어두운 버전입니다.
TRANSIT 대중교통 지도 유형입니다.
TRANSIT_DARK 대중교통 지도 유형의 어두운 버전입니다.
ABSTRACT3D 추상 3D 지도 유형입니다.
PHOTOREALISTIC3D 포토리얼리스틱 3D 지도 유형입니다.

MapFeatures

MapConfig에 적용되는 지도 기능의 컬렉션을 나타냅니다. MapConfig에 설정된 기능은 모든 하위 MapContextConfig에서 상속됩니다. 다음 ID = 3;

필드
simple_features[]

SimpleFeature

선택사항입니다. 이 지도에 사용할 시각적 기능입니다.
poi_boost_level

int32

선택사항입니다. POI 부스트 수준입니다. 0은 부스트가 없음을 나타내고 음수 값은 디부스트를 나타냅니다. 부스트된 관심 장소는 기본값보다 낮은 확대/축소로 표시되며, 부스트가 해제된 관심 장소는 그 반대로 표시됩니다. 현재 2단계의 부스팅을 지원하므로 수준은 [-2, 2]로 제한됩니다. 지정하지 않으면 스타일 시트에 정의된 관심 장소 밀도가 사용됩니다(있는 경우). 그렇지 않으면 관심 장소 밀도가 적용되지 않습니다.

SimpleFeature

이는 지도의 내재적 구조에 영향을 미치는 지도 기능 집합을 나타냅니다.

열거형
SIMPLE_FEATURE_UNSPECIFIED 지정되지 않은 시각적 특징입니다.
FLATTEN_BUILDINGS 지도의 모든 건물을 평평하게 만듭니다.
ICONIC_ICONS 아이콘이 렌더링되는 방식에 영향을 줍니다.

MapRenderingType

렌더링할 지도 유형입니다. 지정하지 않으면 기본 동작은 RASTER입니다.

열거형
RASTER 래스터 기반 구현을 사용하여 렌더링된 지도
VECTOR WebGL을 사용하여 렌더링된 지도

StyleConfig

Maps API 클라이언트 애플리케이션의 단일 스타일을 나타냅니다. StyleConfig에는 지도의 시각적 모양을 정의하는 스타일 시트가 포함되어 있습니다. 다음 ID = 9

필드
name

string

출력 전용입니다. 식별자. 이 StyleConfig의 리소스 이름입니다. 예: 'projects/my-project-123/styleConfigs/234'
display_name

string

선택사항입니다. 사용자가 지정한 이 StyleConfig의 표시 이름입니다.
description

string

선택사항입니다. 사용자가 지정한 이 StyleConfig의 설명입니다.
style_id

string

출력 전용입니다. 이 스타일의 고유 식별자입니다. StyleConfig가 생성될 때 생성되는 읽기 전용 필드입니다. 출력 전용입니다.
json_style_sheet

string

선택사항입니다. 이 StyleConfig의 스타일 시트의 JSON 표현입니다. 지정하지 않으면 기본 Google 지도 스타일이 사용됩니다. 허용되는 JSON 형식에 관한 자세한 내용은 https://developers.google.com/maps/documentation/javascript/cloud-customization/json-reference를 참고하세요.
create_time

Timestamp

출력 전용입니다. StyleConfig의 생성 시간을 나타냅니다.
update_time

Timestamp

출력 전용입니다. StyleConfig의 마지막 업데이트 시간을 나타냅니다.

StyleConfigView

반환할 StyleConfig의 하위 집합입니다.

열거형
STYLE_CONFIG_VIEW_UNSPECIFIED 지정되지 않은 뷰입니다.
FULL 응답에 json_style_sheet를 포함합니다.
METADATA_ONLY 응답에서 json_style_sheet를 제외합니다.

UpdateMapConfigRequest

MapConfig 업데이트 요청입니다.

필드
map_config

MapConfig

필수 항목입니다. 업데이트할 MapConfig입니다.

MapConfig의 name 필드는 업데이트할 MapConfig를 식별하는 데 사용됩니다. 형식: projects/{project}/mapConfigs/{map_config}
update_mask

FieldMask

선택사항입니다. MapConfig에 대해 업데이트할 특정 필드입니다. 지정하지 않으면 MapConfig가 전체적으로 업데이트됩니다. 유효한 필드는 다음과 같습니다.

  • display_name
  • description
  • map_features

UpdateMapContextConfigRequest

MapContextConfig 업데이트 요청입니다.

필드
map_context_config

MapContextConfig

필수 항목입니다. 업데이트할 MapContextConfig입니다.

MapContextConfig의 name 필드는 업데이트할 MapContextConfig를 식별하는 데 사용됩니다. 형식: projects/{project}/mapConfigs/{map_config}/mapContextConfigs/{map_context_config}
update_mask

FieldMask

선택사항입니다. 업데이트할 필드 목록입니다. 지정하지 않으면 MapContextConfig가 전체적으로 업데이트됩니다. 유효한 필드는 다음과 같습니다.

  • display_name
  • alias
  • map_variants
  • style_config
  • dataset

UpdateStyleConfigRequest

StyleConfig 업데이트 요청입니다.

필드
style_config

StyleConfig

필수 항목입니다. 업데이트할 StyleConfig입니다.

StyleConfig의 name 필드는 업데이트할 StyleConfig를 식별하는 데 사용됩니다. 형식: projects/{project}/styleConfigs/{style_config}
update_mask

FieldMask

선택사항입니다. 업데이트할 필드 목록입니다. 지정하지 않으면 StyleConfig가 전체적으로 업데이트됩니다. 유효한 필드는 다음과 같습니다.

  • display_name
  • description
  • json_style_sheet