กําหนดค่าแผนที่

ภาพรวมนี้อธิบายวิธีกำหนดค่าแผนที่ที่เพิ่มลงในแอป iOS โดยใช้ Maps SDK สำหรับ iOS

ภาพรวม

หลังจากเพิ่มแผนที่ลงในแอปแล้ว คุณจะกำหนดค่าตัวเลือกเริ่มต้นและการตั้งค่ารันไทม์ของแผนที่ได้ โปรดดูรายละเอียดเกี่ยวกับการเพิ่มคอนเทนเนอร์แผนที่ที่หัวข้อเพิ่มแผนที่

การตั้งค่าแผนที่เริ่มต้นมีดังนี้

• ตำแหน่งของกล้อง ซึ่งรวมถึงตำแหน่ง การซูม ทิศทาง และความเอียง ดูรายละเอียดเกี่ยวกับตำแหน่งกล้องได้ที่หัวข้อกล้องและมุมมอง
• สีพื้นหลังของแผนที่
• ประเภทแผนที่
• คอมโพเนนต์ UI เพื่อแสดง เช่น ปุ่มซูมและเข็มทิศ
• ท่าทางสัมผัสที่จะเปิดใช้

คุณสามารถกําหนดการตั้งค่าเหล่านี้และการตั้งค่าเพิ่มเติมบางอย่างได้เมื่อรันไทม์โดยอัปเดตออบเจ็กต์ GMSMapView

ตัวเลือกแผนที่

เมื่อเริ่มต้นใช้งานมุมมองแผนที่ ระบบจะตั้งค่าตัวเลือกการกําหนดค่าด้วย GMSMapViewOptions พร็อพเพอร์ตี้ตัวเลือก ได้แก่ frame, camera, mapID หรือ backgroundColor

กำหนดค่าตัวเลือกแผนที่

คุณสามารถตั้งค่าพร็อพเพอร์ตี้ตัวเลือกของคุณเอง หรือส่ง GMSMapViewOptions ที่สร้างขึ้นพร้อมค่าเริ่มต้นไปยัง GMSMapView โดยตรงก็ได้

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

ต่อไปนี้คือตัวอย่างการส่งออบเจ็กต์ GMSMapViewOptions ที่มีค่าเริ่มต้นไปยัง GMSMapView โดยตรง

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

กำหนดค่าสีพื้นหลัง

เมื่อทำงานในโหมดมืดหรือสลับระหว่างมุมมองแผนที่ คุณอาจต้องการลบล้างสีพื้นหลังแผนที่เริ่มต้น ซึ่งทำได้โดยการตั้งค่าพร็อพเพอร์ตี้ตัวเลือกการแมป backgroundColor

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

ประเภทแผนที่

คุณสามารถปรับแต่งแผนที่ด้วยแผนที่ประเภทใดประเภทหนึ่ง ประเภทของแผนที่จะควบคุมการแสดงภาพโดยรวมของแผนที่ ตัวอย่างเช่น แผนภูมิภูมิศาสตร์มักจะมีแผนที่การเมืองที่เน้นแสดงขอบเขต และแผนที่ถนนที่แสดงถนนทั้งหมดของเมืองหรือภูมิภาค Maps SDK สำหรับ iOS มีแผนที่ประเภทต่อไปนี้

การเปลี่ยนประเภทแผนที่

หากต้องการตั้งค่าประเภทของแผนที่ ให้กําหนดค่าใหม่ให้กับพร็อพเพอร์ตี้ GMSMapView.mapType เช่น หากต้องการแสดงแผนที่ประเภทดาวเทียม ให้ทำดังนี้

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

เครื่องมือเลือกด้านล่างแสดงการเปรียบเทียบแผนที่ภูมิประเทศ แผนที่ปกติ และแผนที่แบบผสมสำหรับสถานที่เดียวกัน

แผนที่ในอาคาร

เมื่อซูมในระดับสูง Maps SDK สำหรับ iOS จะแสดงผังชั้นสำหรับพื้นที่ในอาคาร เช่น สนามบิน ห้างสรรพสินค้า ร้านค้าปลีกขนาดใหญ่ และสถานีขนส่งสาธารณะ แผนผังชั้นในอาคารผสานรวมอยู่ในไทล์แผนที่เริ่มต้นสำหรับแผนที่ประเภท "ปกติ" (kGMSTypeNormal) และจะเปิดใช้โดยอัตโนมัติเมื่อผู้ใช้ซูมเข้า และจะจางหายไปเมื่อซูมแผนที่ออก

คุณปิดใช้แผนที่ในอาคารได้โดยการตั้งค่าพร็อพเพอร์ตี้ indoorEnabled ของ GMSMapView เป็น NO

mapView.isIndoorEnabled = false
      

mapView.indoorEnabled = NO;
      

หรือจะปิดใช้เฉพาะการควบคุมเครื่องมือเลือกชั้นก็ได้

การเพิ่มแปลนอาคาร

แผนผังชั้นมีให้บริการในบางสถานที่ หากไม่มีข้อมูลแผนผังชั้นสำหรับอาคารที่ต้องการไฮไลต์ในใบสมัคร คุณจะทำสิ่งต่อไปนี้ได้

• เพิ่มผังชั้นลงใน Google Maps โดยตรง ซึ่งจะทำให้ผู้ใช้ Google Maps ทุกคนเห็นแผนของคุณ
• แสดงผังอาคารเป็นการวางซ้อนพื้นที่ ซึ่งจะทำให้มีเพียงผู้ใช้แอปพลิเคชันเท่านั้นที่ดูผังพื้นได้

เลเยอร์การจราจร

คุณสามารถอนุญาตให้ผู้ใช้ดูแผนที่ที่มีข้อมูลความหนาแน่นของการจราจรวางซ้อนอยู่ด้านบน ซึ่งจะแสดงภาพรวมของสถานการณ์การจราจรในพื้นที่ คุณเปิดและปิดเลเยอร์การจราจรได้โดยเรียกใช้วิธี trafficEnabled ตัวอย่างต่อไปนี้แสดงลักษณะที่เลเยอร์การจราจรอาจปรากฏบนแผนที่

การช่วยเหลือพิเศษ

โดยค่าเริ่มต้น ระบบจะซ่อนองค์ประกอบการช่วยเหลือพิเศษในแผนที่ คุณเปิดใช้การช่วยเหลือพิเศษได้โดยการตั้งค่าพร็อพเพอร์ตี้ accessibilityElementsHidden ของ GMSMapView เป็น NO ซึ่งจะทําให้ระบบสร้างองค์ประกอบการช่วยเหลือพิเศษสําหรับออบเจ็กต์การวางซ้อน (เช่น GMSMarker และหน้าต่างข้อมูล GMSPolyline ฯลฯ)

mapView.accessibilityElementsHidden = false
      

mapView.accessibilityElementsHidden = NO;
      

พร็อพเพอร์ตี้นี้เป็นไปตามโปรโตคอล UIAccessibility อย่างไม่เป็นทางการ ยกเว้นค่าเริ่มต้นใน Maps SDK สําหรับ iOS คือ YES

ตำแหน่งของฉัน

โดยค่าเริ่มต้น จะไม่มีข้อมูลตำแหน่งแสดงบนแผนที่ คุณสามารถเปิดใช้จุดสีน้ำเงิน "ตำแหน่งของฉัน" และเข็มทิศได้โดยตั้งค่า myLocationEnabled เป็นเปิด GMSMapView

mapView.isMyLocationEnabled = true
      

mapView.myLocationEnabled = YES;
      

การเปิดใช้ฟีเจอร์นี้จะระบุตําแหน่งปัจจุบันของผู้ใช้ผ่านพร็อพเพอร์ตี้ myLocation พร็อพเพอร์ตี้นี้อาจไม่พร้อมใช้งานในทันที เช่น หาก iOS แจ้งให้ผู้ใช้อนุญาตการเข้าถึงข้อมูลนี้ ในกรณีนี้ nil

print("User's location: \(String(describing: mapView.myLocation))")
      

NSLog(@"User's location: %@", mapView.myLocation);
      

สิ่งปลูกสร้าง 3 มิติ

เมืองหลายแห่งจะแสดงอาคาร 3 มิติเมื่อดูจากระยะใกล้ ดังที่เห็นในรูปภาพซีแอตเทิล รัฐวอชิงตันด้านล่าง

คุณปิดใช้อาคาร 3 มิติได้โดยการตั้งค่าพร็อพเพอร์ตี้ GMSMapView ที่เกี่ยวข้องใน Swift หรือ Objective-C ดังที่แสดงด้านล่าง

mapView.isBuildingsEnabled = false
      

[mapView setBuildingsEnabled:NO];
      

การเสริมพื้นที่ในแผนที่

Google Map ออกแบบมาเพื่อแสดงเต็มพื้นที่ทั้งภูมิภาคที่ระบุโดย GMSMapView มิติข้อมูลของมุมมองจะกำหนดลักษณะหลายประการของแผนที่ เช่น

• เป้าหมายของกล้องแสดงถึงจุดศูนย์กลางของพื้นที่ที่มีเบาะ
• การควบคุมแผนที่จะอยู่ในตำแหน่งที่สัมพันธ์กับขอบของแผนที่
• ข้อมูลทางกฎหมาย เช่น ข้อความระบุลิขสิทธิ์หรือโลโก้ Google จะปรากฏที่ขอบด้านล่างของแผนที่

คุณสามารถเพิ่มระยะห่างจากขอบแผนที่ได้โดยใช้ GMSMapViewพร็อพเพอร์ตี้ padding แผนที่จะยังคงแสดงเต็มพื้นที่ของคอนเทนเนอร์ แต่การวางตำแหน่งข้อความและการควบคุม ท่าทางสัมผัสบนแผนที่ และการเคลื่อนไหวของกล้องจะทำงานเหมือนอยู่ในพื้นที่ขนาดเล็ก การเปลี่ยนแปลงนี้ส่งผลให้มีการเปลี่ยนแปลงต่อไปนี้

• การเคลื่อนไหวของกล้องโดยใช้การเรียก API หรือการกดปุ่ม (เช่น เข็มทิศ ตำแหน่งของฉัน) จะสัมพันธ์กับพื้นที่ที่มีระยะขอบ
• GMSMapView.projection แสดงผลโปรเจ็กชันที่มีเฉพาะภูมิภาคที่มีการเติม
• ตัวควบคุม UI จะเลื่อนออกจากขอบของคอนเทนเนอร์ตามจำนวนจุดที่ระบุ

การเว้นระยะมีประโยชน์เมื่อออกแบบ UI ที่ทับซ้อนกับแผนที่บางส่วน ตัวอย่างเช่น ในรูปภาพ แผนที่จะมีระยะห่างจากขอบด้านบนและขวา ตัวควบคุมแผนที่ที่มองเห็นได้และข้อความทางกฎหมายจะแสดงที่ขอบของภูมิภาคที่มีระยะขอบ ซึ่งแสดงเป็นสีเขียว ส่วนแผนที่จะยังคงแสดงเต็มพื้นที่คอนเทนเนอร์ดังที่แสดงเป็นสีน้ำเงิน ในตัวอย่างนี้ คุณสามารถวางเมนูไว้ที่ด้านขวาของแผนที่โดยไม่บดบังตัวควบคุมแผนที่

หากต้องการเพิ่มระยะห่างจากขอบในแผนที่ ให้สร้างออบเจ็กต์ UIEdgeInsets แล้วส่งไปยัง GMSMapViewพร็อพเพอร์ตี้ padding

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

รูปแบบสีของแผนที่

สำหรับแผนที่ประเภทปกติและแผนที่ภูมิประเทศ คุณสามารถตั้งค่ารูปแบบสีของแผนที่เป็นมืด สว่าง หรือใช้การตั้งค่าระบบปัจจุบัน เช่น คุณอาจปรับรูปแบบสีของแผนที่ให้เข้มขึ้นหรืออ่อนลงตามช่วงเวลาของวัน หรือตามการใช้งานอุปกรณ์ในอาคารหรือกลางแจ้ง

ใช้ GMSMapView overrideUserInterfaceStyle: เพื่อตั้งค่าและอัปเดตรูปแบบสีของแผนที่

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;