ดัชนี
MapManagement(อินเทอร์เฟซ)CreateMapConfigRequest(ข้อความ)CreateMapContextConfigRequest(ข้อความ)CreateStyleConfigRequest(ข้อความ)DeleteMapConfigRequest(ข้อความ)DeleteMapContextConfigRequest(ข้อความ)DeleteStyleConfigRequest(ข้อความ)GetMapConfigRequest(ข้อความ)GetMapContextConfigRequest(ข้อความ)GetStyleConfigRequest(ข้อความ)ListMapConfigsRequest(ข้อความ)ListMapConfigsResponse(ข้อความ)ListMapContextConfigsRequest(ข้อความ)ListMapContextConfigsResponse(ข้อความ)ListStyleConfigsRequest(ข้อความ)ListStyleConfigsResponse(ข้อความ)MapConfig(ข้อความ)MapContextConfig(ข้อความ)MapContextConfig.MapVariant(enum)MapFeatures(ข้อความ)MapFeatures.SimpleFeature(enum)MapRenderingType(enum)StyleConfig(ข้อความ)StyleConfigView(enum)UpdateMapConfigRequest(ข้อความ)UpdateMapContextConfigRequest(ข้อความ)UpdateStyleConfigRequest(ข้อความ)
MapManagement
Map Management API รองรับการดำเนินการ CRUD ในทรัพยากรการจัดรูปแบบแผนที่ในระบบคลาวด์ ได้แก่ MapConfigs, StyleConfigs และ MapContextConfigs API นี้ช่วยให้นักพัฒนาแอปจัดการลักษณะที่ปรากฏของแผนที่และจัดรูปแบบตามข้อกำหนดได้
| CreateMapConfig |
|---|
|
สร้าง MapConfig ในโปรเจ็กต์
|
| CreateMapContextConfig |
|---|
|
สร้าง MapContextConfig
|
| CreateStyleConfig |
|---|
|
สร้าง StyleConfig
|
| DeleteMapConfig |
|---|
|
ลบ MapConfig
|
| DeleteMapContextConfig |
|---|
|
ลบ MapContextConfig
|
| DeleteStyleConfig |
|---|
|
ลบ StyleConfig
|
| GetMapConfig |
|---|
|
รับ MapConfig
|
| GetMapContextConfig |
|---|
|
รับ MapContextConfig
|
| GetStyleConfig |
|---|
|
รับ StyleConfig
|
| ListMapConfigs |
|---|
|
แสดงรายการ MapConfigs สำหรับโปรเจ็กต์
|
| ListMapContextConfigs |
|---|
|
แสดงรายการ MapContextConfigs
|
| ListStyleConfigs |
|---|
|
แสดงรายการ StyleConfigs
|
| UpdateMapConfig |
|---|
|
อัปเดต MapConfig
|
| UpdateMapContextConfig |
|---|
|
อัปเดต MapContextConfig
|
| UpdateStyleConfig |
|---|
|
อัปเดต StyleConfig
|
CreateMapConfigRequest
ขอสร้าง MapConfig
| ช่อง | |
|---|---|
parent |
ต้องระบุ โปรเจ็กต์หลักที่จะเป็นเจ้าของ MapConfig รูปแบบ: |
map_config |
ต้องระบุ MapConfig ที่จะสร้าง |
CreateMapContextConfigRequest
ขอสร้าง MapContextConfig
| ช่อง | |
|---|---|
parent |
ต้องระบุ MapConfig หลักที่จะเป็นเจ้าของ MapContextConfig รูปแบบ: |
map_context_config |
ต้องระบุ MapContextConfig ที่จะสร้าง |
CreateStyleConfigRequest
ขอสร้าง StyleConfig
| ช่อง | |
|---|---|
parent |
ต้องระบุ โปรเจ็กต์หลักที่จะเป็นเจ้าของ StyleConfig รูปแบบ: |
style_config |
ต้องระบุ StyleConfig ที่จะสร้าง |
DeleteMapConfigRequest
คำขอให้ลบ MapConfig หาก MapConfig มี MapContextConfig ย่อย ระบบจะลบ MapContextConfig ย่อยเหล่านั้นด้วย
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของ MapConfig ที่จะลบ รูปแบบ: |
force |
ไม่บังคับ หากตั้งค่าเป็น "จริง" ระบบจะลบ MapContextConfigs จาก MapConfig นี้ด้วย (มิฉะนั้น คำขอจะทำงานได้ก็ต่อเมื่อ MapConfig ไม่มี MapContextConfigs) |
DeleteMapContextConfigRequest
คำขอลบ MapContextConfig
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของ MapContextConfig ที่จะลบ รูปแบบ: |
DeleteStyleConfigRequest
คำขอให้ลบ StyleConfig
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของ StyleConfig ที่จะลบ รูปแบบ: |
GetMapConfigRequest
ส่งคำขอเพื่อรับ MapConfig
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของ MapConfig รูปแบบ: |
GetMapContextConfigRequest
ขอรับ MapContextConfig
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของ MapContextConfig รูปแบบ: |
GetStyleConfigRequest
คำขอรับ StyleConfig
| ช่อง | |
|---|---|
name |
ต้องระบุ ชื่อทรัพยากรของ StyleConfig รูปแบบ: |
ListMapConfigsRequest
คำขอแสดงรายการ MapConfig
| ช่อง | |
|---|---|
parent |
ต้องระบุ โปรเจ็กต์หลักที่เป็นเจ้าของ MapConfig รูปแบบ: |
page_size |
ไม่บังคับ จำนวนสูงสุดของ MapConfig ที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผล MapConfig อย่างมาก 50 รายการ ค่าสูงสุดคือ 1,000 และระบบจะบังคับให้ค่าที่สูงกว่า 1,000 เป็น 1,000 ไม่รองรับในขณะนี้ |
page_token |
ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ |
ListMapConfigsResponse
การตอบกลับเพื่อแสดงรายการ MapConfig
| ช่อง | |
|---|---|
map_configs[] |
รายการ MapConfig |
next_page_token |
โทเค็นที่ส่งเป็น |
ListMapContextConfigsRequest
คำขอแสดงรายการ MapContextConfigs
| ช่อง | |
|---|---|
parent |
ต้องระบุ MapConfig หลักที่เป็นเจ้าของ MapContextConfigs รูปแบบ: |
page_size |
ไม่บังคับ จำนวนสูงสุดของ MapContextConfigs ที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผล MapContextConfig อย่างมาก 50 รายการ ค่าสูงสุดคือ 1,000 และระบบจะบังคับให้ค่าที่สูงกว่า 1,000 เป็น 1,000 ไม่รองรับในขณะนี้ |
page_token |
ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ |
ListMapContextConfigsResponse
การตอบกลับเพื่อแสดงรายการ MapContextConfigs
| ช่อง | |
|---|---|
map_context_configs[] |
MapContextConfigs |
next_page_token |
โทเค็นที่ส่งเป็น |
ListStyleConfigsRequest
คำขอแสดงรายการ StyleConfig
| ช่อง | |
|---|---|
parent |
ต้องระบุ โปรเจ็กต์หลักที่เป็นเจ้าของ StyleConfigs รูปแบบ: |
page_size |
ไม่บังคับ จำนวนสูงสุดของ StyleConfig ที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผล StyleConfig อย่างมาก 50 รายการ ค่าสูงสุดคือ 1,000 และระบบจะบังคับให้ค่าที่สูงกว่า 1,000 เป็น 1,000 ไม่รองรับในขณะนี้ |
page_token |
ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ |
filter |
ไม่บังคับ นิพจน์ตัวกรองสำหรับการเรียก ListStyleConfigs ปัจจุบันรองรับเฉพาะการกรองตาม display_name เช่น |
view |
ไม่บังคับ ส่วนย่อยของ StyleConfig ที่จะแสดงผล หากไม่ได้ตั้งค่าไว้ ลักษณะการทำงานเริ่มต้นคือการแสดงมุมมองแบบเต็ม |
ListStyleConfigsResponse
การตอบกลับเพื่อแสดงรายการ StyleConfig
| ช่อง | |
|---|---|
style_configs[] |
StyleConfigs |
next_page_token |
โทเค็นที่ส่งเป็น |
MapConfig
แสดงแผนที่เดียวในแอปพลิเคชันไคลเอ็นต์ Maps API MapConfig เป็นทรัพยากรหลักของ MapContextConfigs และช่วยให้ใช้การจัดรูปแบบที่กำหนดเองใน SDK (อุปกรณ์เคลื่อนที่/เว็บ) ได้ MapConfig มี MapContextConfig ได้หลายรายการ โดยแต่ละรายการจะใช้การจัดรูปแบบกับแผนที่รูปแบบที่เฉพาะเจาะจง Next ID = 9;
| ช่อง | |
|---|---|
name |
เอาต์พุตเท่านั้น ตัวระบุ ชื่อทรัพยากรของ MapConfig นี้ เช่น "projects/my-project-123/mapConfigs/234" เอาต์พุตเท่านั้น |
display_name |
ไม่บังคับ ชื่อที่แสดงของ MapConfig นี้ตามที่ผู้ใช้ระบุ |
description |
ไม่บังคับ คำอธิบายของ MapConfig นี้ตามที่ผู้ใช้ระบุ |
map_id |
เอาต์พุตเท่านั้น รหัสแผนที่ของ MapConfig นี้ ซึ่งใช้เพื่อระบุแผนที่ในแอปพลิเคชันไคลเอ็นต์ ระบบจะสร้างฟิลด์แบบอ่านอย่างเดียวนี้เมื่อสร้าง MapConfig เอาต์พุตเท่านั้น |
map_features |
ไม่บังคับ ฟีเจอร์ของแผนที่ที่ใช้กับการกำหนดค่าแผนที่นี้ |
map_type |
ไม่บังคับ แสดงประเภทแผนที่ของ MapConfig หากไม่ได้ตั้งค่าไว้ ลักษณะการทำงานเริ่มต้นคือการใช้ประเภทแผนที่แรสเตอร์ |
create_time |
เอาต์พุตเท่านั้น ระบุเวลาที่สร้างการกำหนดค่าแผนที่ เอาต์พุตเท่านั้น |
update_time |
เอาต์พุตเท่านั้น ระบุเวลาอัปเดตล่าสุดของการกำหนดค่าแผนที่ เอาต์พุตเท่านั้น |
MapContextConfig
ห่อหุ้มการกำหนดค่าการจัดรูปแบบสำหรับแผนที่ MapContextConfig จะเชื่อมโยงคอมโพเนนต์การจัดรูปแบบ เช่น StyleConfig และ Datasets กับตัวแปรแผนที่ที่เฉพาะเจาะจงของ MapConfig เมื่อโหลด MapConfig ใน SDK ระบบจะใช้ข้อมูลการจัดรูปแบบและชุดข้อมูลจาก MapContextConfig กับแผนที่รูปแบบที่ระบุ Next ID = 10;
| ช่อง | |
|---|---|
name |
เอาต์พุตเท่านั้น ตัวระบุ ชื่อทรัพยากรของ MapContextConfig นี้ เช่น projects/{project_id}/mapConfigs/{map_id}/mapContextConfigs/{map_context_config_id} |
map_config |
ต้องระบุ ชื่อทรัพยากร MapConfig ที่ MapContextConfig นี้เชื่อมโยงด้วย รูปแบบ: projects/{project}/mapConfigs/{map_config} ต้องระบุข้อมูลในช่องนี้และจะเว้นว่างไม่ได้ |
style_config |
ต้องระบุ ชื่อทรัพยากร StyleConfig ที่จัดรูปแบบ MapContextConfig นี้ ต้องระบุข้อมูลในช่องนี้และจะเว้นว่างไม่ได้ รูปแบบ: projects/{project}/styleConfigs/{style_config} |
dataset[] |
ไม่บังคับ ชื่อทรัพยากรชุดข้อมูลที่เชื่อมโยงกับ MapContextConfig นี้ ช่องนี้จะระบุหรือไม่ก็ได้ หากไม่ระบุ ระบบจะไม่เชื่อมโยงชุดข้อมูลกับ MapContextConfig หากระบุชุดข้อมูล ระบบจะนำไปใช้กับ MapContextConfig รูปแบบ: projects/{project}/datasets/{dataset} |
alias |
ไม่บังคับ ชื่อที่ผู้ใช้กำหนดซึ่งมนุษย์อ่านได้สำหรับ MapContextConfig นี้ |
map_variants[] |
ต้องระบุ รูปแบบแผนที่ที่ใช้ MapContextConfig นี้ได้ หากเว้นว่างไว้ ระบบจะใช้ MapContextConfig เริ่มต้นกับเฉพาะตัวแปรแผนที่ ROADMAP |
create_time |
เอาต์พุตเท่านั้น ระบุเวลาที่สร้าง MapContextConfig เอาต์พุตเท่านั้น |
update_time |
เอาต์พุตเท่านั้น ระบุเวลาอัปเดตล่าสุดของ MapContextConfig เอาต์พุตเท่านั้น |
MapVariant
รูปแบบแผนที่ที่เป็นไปได้ซึ่งใช้ MapContextConfig ได้ โดยตัวแปรแผนที่จะจัดกลุ่มเป็นตัวแปรสว่างและตัวแปรมืด จับคู่ตัวแปร Light กับตัวแปร Dark สำหรับ MapContextConfig เดียวกันไม่ได้ รูปแบบแสงมีดังนี้ แผนที่นำทาง ดาวเทียม ภูมิประเทศ การนำทาง ขนส่ง มิติ 3D แบบนามธรรม และมิติ 3D แบบสมจริง รูปแบบสีเข้ม ได้แก่ 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]}
| Enum | |
|---|---|
ROADMAP |
ประเภทแผนที่โรดแมปเริ่มต้น |
ROADMAP_DARK |
แผนที่เวอร์ชันมืดของประเภทแผนที่โรดแมป |
SATELLITE |
ภาพถ่ายจากดาวเทียม |
TERRAIN |
ประเภทแผนที่ภูมิประเทศ |
TERRAIN_DARK |
แผนที่ภูมิประเทศเวอร์ชันมืด |
NAVIGATION |
ประเภทแผนที่การนำทาง |
NAVIGATION_LOW_LIGHT |
แผนที่นำทางประเภทเวอร์ชันที่มีแสงน้อย |
TRANSIT |
ประเภทแผนที่ขนส่งสาธารณะ |
TRANSIT_DARK |
แผนที่การเดินทางประเภทเวอร์ชันมืด |
ABSTRACT3D |
ประเภทแผนที่ 3 มิติแบบนามธรรม |
PHOTOREALISTIC3D |
ประเภทแผนที่ 3 มิติแบบสมจริง |
MapFeatures
แสดงถึงคอลเล็กชันของฟีเจอร์แผนที่ที่ใช้กับ MapConfig ฟีเจอร์ที่ตั้งค่าใน MapConfig จะรับช่วงมาจาก MapContextConfig ทั้งหมด Next ID = 3;
| ช่อง | |
|---|---|
simple_features[] |
ไม่บังคับ ฟีเจอร์ภาพที่จะใช้สำหรับแผนที่นี้ |
poi_boost_level |
ไม่บังคับ ระดับการเพิ่ม POI โดย 0 หมายถึงไม่มีการเพิ่ม และค่าลบหมายถึงการลด POI ที่ได้รับการเพิ่มจะแสดงที่ระดับการซูมต่ำกว่าค่าเริ่มต้น และ POI ที่ลดระดับจะแสดงที่ระดับการซูมสูงกว่าค่าเริ่มต้น ปัจจุบันรองรับการเพิ่ม 2 ระดับ ดังนั้นระดับจึงถูกจำกัดไว้ที่ [-2, 2] หากไม่ได้ระบุ ระบบจะใช้ความหนาแน่นของจุดที่น่าสนใจที่กำหนดไว้ในชีตสไตล์ หากมี ไม่เช่นนั้น ระบบจะไม่ใช้ความหนาแน่นของจุดที่น่าสนใจ |
SimpleFeature
แสดงชุดฟีเจอร์แผนที่ที่มีผลต่อโครงสร้างโดยธรรมชาติของแผนที่
| Enum | |
|---|---|
SIMPLE_FEATURE_UNSPECIFIED |
ฟีเจอร์ภาพที่ไม่ระบุ |
FLATTEN_BUILDINGS |
ทำให้อาคารทั้งหมดในแผนที่แบนราบ |
ICONIC_ICONS |
มีผลต่อวิธีแสดงผลไอคอน |
MapRenderingType
ประเภทแผนที่ที่จะแสดง ลักษณะการทำงานเริ่มต้นคือ RASTER หากไม่ได้ระบุไว้
| Enum | |
|---|---|
RASTER |
แผนที่ที่แสดงผลโดยใช้การติดตั้งใช้งานแบบแรสเตอร์ |
VECTOR |
แผนที่ที่แสดงผลโดยใช้ WebGL |
StyleConfig
แสดงรูปแบบเดียวในแอปพลิเคชันไคลเอ็นต์ Maps API StyleConfig มีสไตล์ชีตที่กำหนดลักษณะที่ปรากฏของแผนที่ Next ID = 9;
| ช่อง | |
|---|---|
name |
เอาต์พุตเท่านั้น ตัวระบุ ชื่อทรัพยากรของ StyleConfig นี้ เช่น "projects/my-project-123/styleConfigs/234" |
display_name |
ไม่บังคับ ชื่อที่แสดงของ StyleConfig นี้ตามที่ผู้ใช้ระบุ |
description |
ไม่บังคับ คำอธิบายของ StyleConfig นี้ตามที่ผู้ใช้ระบุ |
style_id |
เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันของสไตล์นี้ นี่คือฟิลด์แบบอ่านอย่างเดียวที่สร้างขึ้นเมื่อสร้าง StyleConfig เอาต์พุตเท่านั้น |
json_style_sheet |
ไม่บังคับ การแสดง JSON ของชีตสไตล์สำหรับ StyleConfig นี้ หากไม่ได้ระบุ ระบบจะใช้รูปแบบแผนที่ Google ฐาน ดูรายละเอียดเพิ่มเติมเกี่ยวกับรูปแบบ JSON ที่ยอมรับได้ที่ https://developers.google.com/maps/documentation/javascript/cloud-customization/json-reference |
create_time |
เอาต์พุตเท่านั้น ระบุเวลาที่สร้าง StyleConfig |
update_time |
เอาต์พุตเท่านั้น ระบุเวลาที่อัปเดต StyleConfig ครั้งล่าสุด |
StyleConfigView
กำหนดชุดย่อยของ StyleConfig ที่จะแสดงผล
| Enum | |
|---|---|
STYLE_CONFIG_VIEW_UNSPECIFIED |
มุมมองที่ไม่ได้ระบุ |
FULL |
รวม json_style_sheet ไว้ในการตอบกลับ |
METADATA_ONLY |
ไม่รวม json_style_sheet จากการตอบกลับ |
UpdateMapConfigRequest
ส่งคำขออัปเดต MapConfig
| ช่อง | |
|---|---|
map_config |
ต้องระบุ MapConfig ที่จะอัปเดต ระบบจะใช้ฟิลด์ |
update_mask |
ไม่บังคับ ฟิลด์ที่เฉพาะเจาะจงที่จะอัปเดตสำหรับ MapConfig หากไม่ได้ระบุไว้ ระบบจะอัปเดต MapConfig ทั้งหมด ฟิลด์ที่ใช้ได้มีดังนี้
|
UpdateMapContextConfigRequest
คำขออัปเดต MapContextConfig
| ช่อง | |
|---|---|
map_context_config |
ต้องระบุ MapContextConfig ที่จะอัปเดต ระบบจะใช้ฟิลด์ |
update_mask |
ไม่บังคับ รายการฟิลด์ที่จะอัปเดต หากไม่ได้ระบุ ระบบจะอัปเดต MapContextConfig ทั้งหมด ฟิลด์ที่ใช้ได้มีดังนี้
|
UpdateStyleConfigRequest
ส่งคำขออัปเดต StyleConfig
| ช่อง | |
|---|---|
style_config |
ต้องระบุ StyleConfig ที่จะอัปเดต ฟิลด์ |
update_mask |
ไม่บังคับ รายการฟิลด์ที่จะอัปเดต หากไม่ได้ระบุ ระบบจะอัปเดต StyleConfig ทั้งหมด ฟิลด์ที่ใช้ได้มีดังนี้
|