Apple Maps: Thêm Ảnh chụp nhanh Web Maps vào website, email của bạn.

Apple gần đây đã công bố Maps Web Snapshots , một sản phẩm bản đồ tĩnh mới. Maps Web Snapshots cho phép người dùng tạo một hình ảnh bản đồ tĩnh từ một URL có thể được sử dụng bất kỳ lúc nào không cần bản đồ tương tác hoặc không có JavaScript. Hình ảnh bản đồ lấy từ một URL, làm cho nó trở thành một lựa chọn tuyệt vời cho các trang web cũng như ứng dụng email.

 Ảnh chụp nhanh trên web của Maps cho phép bạn thêm bản đồ vào trang web, email của mình hoặc bất kỳ nơi nào khác mà bạn có thể chia sẻ liên kết mà bạn đã chọn các điểm dữ liệu. Thêm địa điểm kinh doanh, điểm ưa thích và thông tin định tuyến mà bạn chọn chia sẻ mang lại nhiều cơ hội cho chủ sở hữu doanh nghiệp cũng như người dùng:

• Chia sẻ thông tin lộ trình với khách hàng.
• Chế độ xem bản đồ có thể chia sẻ, có thương hiệu, không lộn xộn (và không có đối thủ cạnh tranh).
• Chia sẻ địa điểm kinh doanh.
• Tạo các điểm ưa thích đã chọn cho khách truy cập.
• Nội dung bản đồ có thể nhúng không phụ thuộc vào Google.
• Chia sẻ tuyến đường riêng.

Apple đã âm thầm làm việc để tạo ra một sản phẩm bản đồ cạnh tranh với Google Maps, và kết quả là họ sẽ ra mắt với những tính năng sáng tạo mà người dùng dường như đang ngày càng hài lòng, một tính năng không thể thiếu giống google đó là tăng review google maps mà apple đang thử nghiệm

Để hoạt động, một URL Ảnh chụp nhanh yêu cầu thông tin tài khoản cơ bản – bao gồm ID nhóm của bạn và ID khóa mà bạn sẽ tạo riêng để truy cập Apple Maps – cùng với vị trí thực để căn giữa bản đồ. Bạn cũng sẽ thêm một chữ ký để đảm bảo rằng yêu cầu bản đồ không bị thay đổi ở bất kỳ đâu giữa máy chủ của bạn và Apple Maps.

Link ảnh địa điểm của bạn trên Apple maps

https://snapshot.apple-mapkit.com/api/v1/snapshot?center=[location name or coordinates]&teamId=[Team ID]&keyId=[Maps Key ID]&signature=[base64_url_encoded_signature]

Điểm trung tâm của bản đồ là tham số bắt buộc duy nhất cho URL và có thể là một cặp kinh độ và vĩ độ được phân tách bằng dấu phẩy hoặc một địa chỉ thực. Ví dụ: sử dụng center="Apple Park"để yêu cầu một ảnh chụp nhanh tập trung vào Apple Park ở California.

Thêm thông số truy vấn

Ảnh chụp nhanh Web Maps có thể được tùy chỉnh thêm bằng cách thêm các tham số truy vấn để hiển thị các chú thích và kiểu lớp phủ khác nhau, các loại bản đồ thay thế và lựa chọn phối màu sáng hoặc tối để phù hợp hơn với nội dung được nhúng của bạn.

Thông Tin Truy Vấn

teamId
string
(Yêu cầu) ID nhóm nhà phát triển Apple của bạn. 
Để biết thêm thông tin, hãy xem 
Tạo mã nhận dạng bản đồ và khóa cá nhân .

keyId
string
(Yêu cầu) ID khóa MapKit JS của bạn. 
Để biết thêm thông tin, hãy xem 
Tạo mã nhận dạng bản đồ và khóa cá nhân .

signature
string
(Yêu cầu) Base64, chữ ký được mã hóa URL, ký hiệu đường dẫn yêu cầu và các tham số truy vấn. 
Chữ ký phải là tham số cuối cùng trong URL yêu cầu; 
nếu không, yêu cầu trả về mã trạng thái , 
401 Unauthorized. 
Xem 
Tạo URL và Chữ ký để Tạo Ảnh chụp nhanh Web Bản đồ .

center
string
(Yêu cầu) Trung tâm của bản đồ. 
Bạn có thể chỉ định 
centerdưới dạng tọa độ, dưới dạng địa chỉ hoặc với chuỗi 
autokhi bạn thêm chú thích và lớp phủ.
Cung cấp tọa độ dưới dạng một chuỗi với vĩ độ và kinh độ được phân tách bằng dấu phẩy, chẳng hạn như:
center="37.78,-122.42"
Nếu bạn chỉ định 
centerlà tọa độ, vĩ độ phải nằm trong phạm vi (-90, 90) và kinh độ phải trong phạm vi (-180, 180).
Địa chỉ được mã hóa địa lý là một giá trị hợp lệ cho 
centertham số, chẳng hạn như:
center="1 Apple Park Way in Cupertino, California"
Chuỗi 
autocũng là một giá trị hợp lệ cho 
centertham số, ví dụ:
center="auto"
Nếu bạn chỉ định 
center=”auto”, API ảnh chụp nhanh bản đồ web trả về một bản đồ bao gồm tất cả các lớp phủ hoặc chú thích. 
API yêu cầu 
annotationshoặc 
overlayskhi bạn sử dụng 
center=”auto”.

z
float
Mức độ thu phóng của bản đồ.
API xem nhanh bản đồ web bỏ qua 
ztham số khi bạn chỉ định 
autocho 
centertham số hoặc khi bạn chỉ định cả 
spnvà 
ztham số.
Vỡ nợ: 
12
Giá trị tối thiểu: 
3
Gia trị lơn nhât: 
20
spn
string
Khoảng tọa độ được phân tách bằng dấu phẩy cho biết lượng bản đồ mà API Ảnh chụp nhanh bản đồ web hiển thị xung quanh trung tâm của bản đồ. 
Vĩ độ phải nằm trong khoảng (0, 90) và kinh độ phải nằm trong khoảng (0, 180). 
Các thông số vĩ độ và kinh độ delta phải là số dương; 
API xử lý các số âm là 
0.
API ảnh chụp nhanh bản đồ web bỏ qua 
spntham số nếu bạn chỉ định 
autocho 
centertham số. 
Nếu bạn cung cấp cả hai 
zvà 
spntham số, giá trị cho 
spnsẽ được ưu tiên hơn 
z.

size
string
Kích thước của hình ảnh tính bằng pixel. 
Chỉ định 
sizedưới dạng số nguyên chiều rộng và chiều cao được phân tách bằng ký tự 
x. 
Ví dụ: 
640x480tạo một hình ảnh rộng 640 pixel và cao 480 pixel.
Chiều rộng và chiều cao phải nằm trong phạm vi [50, 640].
Vỡ nợ: 
600x400
scale
int32
Mật độ điểm ảnh của hình ảnh. 
scale=2trả về hình ảnh dành cho 
2xmàn hình Retina. 
Đặt 
scalethành các giá trị lớn hơn 1 sẽ làm tăng số lượng pixel trong hình ảnh được tạo.
Vỡ nợ: 
1
Giá trị tối thiểu: 
1
Gia trị lơn nhât: 
2
Những giá trị khả thi: 
1, 2
t
string
Loại bản đồ.
Vỡ nợ: 
standard
Những giá trị khả thi: 
standard, hybrid, satellite, mutedStandard
colorScheme
string
Sự phối màu của bản đồ. 
Bảng 
darkmàu chỉ áp dụng cho các 
loại bản đồ 
standardvà 
.
mutedStandard
Vỡ nợ: 
light
Những giá trị khả thi: 
light, dark
poi
boolean
Giá trị Boolean cho biết có hiển thị các điểm ưa thích trên bản đồ hay không. 
Để ẩn các điểm ưa thích, hãy đặt 
poi=0.
Vỡ nợ: 
1
lang
string
Ngôn ngữ mà API Ảnh chụp nhanh trên web của Maps sử dụng cho các nhãn trên bản đồ. 
Các giá trị được hỗ trợ nằm trong ID ngôn ngữ, chẳng hạn như 
en-GBhoặc 
es-MX.
Vỡ nợ: 
en-US
annotations
[Annotation]
Một mảng các chú thích để hiển thị trên bản đồ, mà bạn chỉ định là 
Annotationcác đối tượng 
JSON 
. 
Lớp chú thích trên đầu bản đồ theo thứ tự bạn chỉ định trong yêu cầu.

overlays
[Overlay]
Một mảng các lớp phủ để hiển thị trên bản đồ mà bạn chỉ định dưới dạng một mảng các 
Overlayđối tượng 
JSON 
.

referer
string
Các 
refererchuỗi giá trị để phù hợp chống lại “của yêu cầu 
Referer” giá trị tiêu đề. 
Yêu cầu không khớp với 
referertham số không thành công với mã trạng thái HTTP 
401 Unauthorized,. 
Đó là một thực tiễn tốt để đặt giới hạn người 
referertham 
chiếu thông qua 
tham số.

expires
int64
Thời gian tính bằng giây kể từ thời điểm yêu cầu hết hạn. 
Yêu cầu hết hạn không thành công với mã trạng thái HTTP 
401 Unauthorized,. 
Bạn nên đặt thời hạn thông qua 
expirestham số.

imgs
[Image]
Một mảng hình ảnh tùy chỉnh để chú thích bản đồ, được chỉ định dưới dạng một mảng các 
Imageđối tượng 
JSON 
.


Mã phản hồi
200
binary
OK
Yêu cầu đã thành công và API Ảnh chụp nhanh trên web của Maps đã trả về một hình ảnh bản đồ dưới dạng 
image/png.
Loại nội dung: image / png
400
Bad Request
Yêu cầu không hợp lệ.
Loại nội dung: ứng dụng / json
401
Unauthorized
Yêu cầu này chứa thông tin xác thực ủy quyền không hợp lệ.
Loại nội dung: ứng dụng / json
413
Request Entity Too Large
URL cho yêu cầu này vượt quá số ký tự tối đa cho phép.
Loại nội dung: ứng dụng / json
429

Bạn đã vượt quá giới hạn tỷ lệ cho khóa API của mình. 
Bạn cần đợi và thử lại yêu cầu.
Loại nội dung: ứng dụng / json
500
Internal Server Error
Yêu cầu không thành công. 
Điều này có thể là do sự cố tạm thời. 
Kiểm tra 
Trang trạng thái hệ thống dành cho nhà phát triển của Apple để biết thông tin cập nhật về API ảnh chụp nhanh bản đồ web.
Loại nội dung: ứng dụng / json

Thêm chú thích bản đồ Để thêm một hoặc nhiều chú thích, hãy sử dụng tham số chú thích và bao gồm một mảng các đối tượng Chú thích JSON đại diện cho điểm trung tâm dưới cùng của mỗi chú thích. Để đặt kiểu mặc định, hãy thêm annotations=["point":"37.33489990234375,-122.00901794433594"]vào URL ảnh chụp nhanh của bạn.

Ngoài ra, bạn có thể tùy chỉnh đối tượng chú thích để thay đổi màu sắc, kiểu dáng, kích thước hoặc thêm hình ảnh tùy chỉnh.

Đặt bảng màu Sử dụng colorSchemetham số này, bạn có thể tạo Ảnh chụp nhanh trên web của Maps để khớp với nội dung và cài đặt Hình thức của thiết bị của một người. Ví dụ: để tìm nạp và hiển thị ảnh chụp nhanh của Apple Park khi thiết bị được đặt thành Giao diện tối, bạn có thể thêm colorScheme=darkvào URL ảnh chụp nhanh của mình.

Chọn địa hình của bạn Để hiển thị một loại hình cụ thể của bản đồ, append tham số với giá trị bản đồ chính xác: standard, satellite, hoặc hybrid. Ví dụ: để tìm nạp hình ảnh vệ tinh của bản đồ Apple Park, hãy thêm t=satellitevào URL ảnh chụp nhanh của bạn.

Khám phá Snapshots Studio

Giờ bạn đã hiểu các kiến ​​thức cơ bản về Maps Web Snapshots, cách tốt nhất để làm quen với toàn bộ các tính năng là thử nghiệm với Snapshots Studio.

Bắt đầu một ảnh chụp nhanh Để xem trước một ảnh chụp nhanh, hãy bắt đầu bằng cách chọn một địa chỉ hoặc điểm ưa thích và chọn kích thước và ngôn ngữ hình ảnh mong muốn của bạn.

Sau đó, nhấp vào nút Hiển thị Ảnh chụp nhanh để xem phần trình bày mặc định của vị trí bạn đã chọn.

Để sửa đổi kết quả, bạn có thể sử dụng bản xem trước ảnh chụp nhanh để tùy chỉnh chú thích mặc định, chọn loại bản đồ và đặt hệ số thu phóng.

Tạo ảnh chụp nhanh của riêng bạn Bạn muốn tạo Ảnh chụp nhanh trên web của Maps có thể nhúng? Bạn sẽ muốn đảm bảo rằng mình có thông tin đăng nhập phù hợp. Nếu bạn chưa tạo ID Maps và khóa cá nhân MapKitJS, thì đây là cách thực hiện:

1. Tạo số nhận dạng mới (ID bản đồ) trong tài khoản nhà phát triển của bạn. Giống như ID gói, ID bản đồ được tạo theo ký hiệu tên miền ngược lại. *maps.*sẽ được thêm vào trước chuỗi bạn nhập. Với ID bản đồ của bạn đã được tạo, tiếp theo bạn sẽ tạo khóa riêng tư MapKitJS của mình.
2. Tạo và đăng ký Khoá Cá nhân MapKitJS trong tài khoản nhà phát triển của bạn. Đầu tiên, hãy nhập một tên duy nhất vào trường Key Name , chọn hộp kiểm bên cạnh MapKit JS và nhấp vào Tiếp tục .
3. Chọn nút Định cấu hình . Bạn sẽ liên kết khóa với ID bản đồ mà bạn đã tạo trước đó bằng cách chọn nó từ menu thả xuống ID bản đồ .
4. Nhấp vào nút Lưu .
5. Nhấn Tiếp tục .
6. Nhấp vào Đăng ký trên màn hình tiếp theo.
7. Khi hoàn tất, hãy nhấp để tải xuống Khóa cá nhân MapKitJS của bạn. Hãy nhớ rằng sau khi bạn đã tải xuống khóa của mình, bạn không thể tải lại khóa đó vì bản sao máy chủ bị xóa. Đảm bảo lưu một bản sao lưu ở một nơi an toàn.
8. Với khóa của bạn đã được tải xuống, hãy nhấp vào nút Xong và bạn đã sẵn sàng tạo Ảnh chụp nhanh trên web Maps của riêng mình.

Với các thông tin đăng nhập trên đã sẵn sàng, hãy quay lại Snapshots Studio. Nhập ID nhóm nhà phát triển của bạn, thông tin khóa MapKitJS, miền mà bạn sẽ giới thiệu Ảnh chụp nhanh, sau đó nhấn nút OK để xác thực thông tin đăng nhập của bạn.

Sau khi xác nhận, hãy nhấp vào nút Hiển thị Ảnh chụp nhanh một lần nữa.

Bây giờ, hình ảnh xem trước bản đồ của bạn sẽ bao gồm một URL có thể được đặt trên trang web của bạn và được liên kết đến từ bất cứ đâu bạn muốn.

Khám phá Ảnh chụp nhanh Động Mặc dù URL Bản đồ được tạo chứa tất cả các chi tiết bản đồ mà bạn đã định cấu hình trong Snapshots Studio, nó thực sự là một mẫu linh hoạt với các thông số có thể tùy chỉnh mà bạn có thể điều chỉnh mỗi khi ảnh chụp nhanh được yêu cầu. Để khám phá tất cả các tùy chọn bạn có thể tùy chỉnh, hãy xem tài liệu Ảnh chụp nhanh trên web của Maps để biết thêm thông tin.

Khai thác tối đa Ảnh chụp nhanh trên web Maps của bạn

Theo mặc định, bạn có thể hiển thị miễn phí tới 25.000 yêu cầu Ảnh chụp nhanh trên web Maps duy nhất với tư cách thành viên Chương trình nhà phát triển Apple của mình.

Để tránh các lượt truy cập bị tính vào giới hạn dịch vụ của bạn, chúng tôi khuyên bạn nên truy xuất, lưu trữ, sau đó nhúng hình ảnh được kết xuất hơn là phân phát một liên kết truy xuất hình ảnh tại thời điểm hiển thị. Nếu bạn cần thêm năng lực để triển khai, vui lòng liên hệ với Bộ phận quan hệ nhà phát triển.

Hiện tại bản đồ của họ hiện được hiển thị trong SERP của DuckDuckGo và xu hướng này có thể sẽ tiếp tục trên các nền tảng tìm kiếm khác khi mong muốn về quyền riêng tư của người dùng tăng lên.

Hy vọng mình chia sẻ để giúp các bạn có thể nắm bắt xu thế tất yêu của Apple.

Theo Apple