Có phiên bản mới hơn của tài liệu này với các ví dụ về cách sử dụng API Địa điểm và API Tuyến đường mới.
Thông thường, khi người dùng lái xe đến một điểm yêu thích (POI), họ sẽ thực sự cần được chỉ đường đến một vị trí lân cận, chẳng hạn như bãi đỗ xe hoặc điểm truy cập. Hãy hình dung một người lái xe cần đến sân bay hoặc trung tâm mua sắm. Khi đến sân bay, tài xế đang cố gắng đến một nhà ga hoặc điểm trả khách thay vì trung tâm của khu vực sân bay. Tương tự, đối với người dùng có ô tô, bãi đỗ xe bên cạnh trung tâm mua sắm có thể là lựa chọn tốt hơn nhiều. Trong trường hợp này, khi phát triển một ứng dụng hoặc dịch vụ để hướng dẫn người lái xe, trước tiên, hãy tìm vị trí họ sẽ đến, sau đó cung cấp cho người lái xe các điểm đến không bắt buộc gần vị trí đó. Phương pháp này cho phép bạn cung cấp dịch vụ tốt hơn cho khách hàng và thể hiện rằng bạn trân trọng thời gian của họ, với một nỗ lực phát triển nhỏ nhưng thông minh, tận dụng dữ liệu vị trí do Nền tảng Google Maps cung cấp.
Chế độ xem đơn giản về các hệ thống liên quan khi hướng dẫn người lái xe đến một vị trí bằng ô tô
Chúng tôi sẽ hướng dẫn bạn cách sử dụng Places API và Directions API theo trình tự hoặc kết hợp để xác định vị trí phù hợp để đỗ xe bên cạnh đích đến của bạn. Giải pháp này nhằm loại bỏ sự không chắc chắn và nhiều lượt tương tác để tìm một điểm đỗ xe trong khi lái xe khi đến gần điểm đến cuối cùng. Hãy xem hai ví dụ về cách triển khai chi tiết các trường hợp này.
Ví dụ 1: một điểm tham quan không có bãi đỗ xe
Hãy chọn một vị trí không kết nối trực tiếp với đường bên lề để phải truy xuất riêng một tuyến đường, đích đến là Nhà thờ Đức Bà ở Paris và làm điểm xuất phát, hãy sử dụng ga xe lửa Gare de l’Est (48.87697775149635, 2.3592247806755564).
Người lái xe rời ga cách Nhà thờ Đức Bà khoảng 16 phút về phía bắc. Nhà thờ Đức Bà là một điểm tham quan du lịch nổi tiếng trên một hòn đảo có cầu, một số đường một chiều và không có bãi đỗ xe lớn nào ở gần đó. Vì vậy, đây sẽ là một thử thách thú vị.
Yêu cầu Places API
Yêu cầu API Địa điểm mẫu này đang sử dụng tính năng "tìm kiếm bằng văn bản" để tìm Nhà thờ Đức Bà. Hãy xem tài liệu dành cho nhà phát triển để biết thông tin chi tiết. “YOUR_KEY” trong các ví dụ này là khoá API mà bạn có cho API Địa điểm và Chỉ đường của Nền tảng Google Maps được bật trong Google Cloud Console. Để biết thêm thông tin giải thích chi tiết, vui lòng xem tài liệu về cách bắt đầu sử dụng Google Maps Platform.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
Phản hồi cho yêu cầu trên cung cấp toạ độ vĩ độ và kinh độ sau:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Như bạn có thể thấy, tọa độ này thực sự chỉ ra Nhà thờ Đức Bà.
|
|
Là nhà phát triển hoặc nhà cung cấp dịch vụ, bạn nên tự động nhắc người lái xe "Bạn đang tìm chỗ đỗ xe gần Nhà thờ Đức Bà?". Trải nghiệm người dùng sẽ khác nhau tuỳ thuộc vào thiết bị và màn hình, nhưng bạn nên cân nhắc việc hiển thị một văn bản bật lên tinh tế sẽ biến mất sau một thời gian ngắn trong trường hợp này. Để tìm vị trí đỗ xe gần Nhà thờ Đức Bà, hãy thực hiện một lượt tìm kiếm bằng văn bản trên Places API với loại "bãi đỗ xe" và bán kính "300". Ví dụ này sẽ làm sai lệch kết quả đối với các khu vực đỗ xe trong phạm vi 300 mét từ Nhà thờ Đức Bà Paris.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
Kết quả đầu tiên là "Bãi đỗ xe Saemes Maubert-Lagrange" tại 48.850591, 2.3486436. Hãy sử dụng vị trí này trong phần tiếp theo, nơi chúng ta thực hiện yêu cầu API chỉ đường.
Yêu cầu Directions API
Để tìm tuyến đường từ nhà ga đến khu vực đỗ xe gần Nhà thờ Đức Bà, bạn cần thực hiện yêu cầu API chỉ đường. Bạn chỉ cần đặt các tham số điểm xuất phát và điểm đến. Hãy xem tài liệu dành cho nhà phát triển để biết thêm các tuỳ chọn.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
Phản hồi của API chỉ đường thường chứa nhiều đề xuất tuyến đường. Mỗi tuyến đường bao gồm nhiều "đoạn" và các đoạn đó chứa nhiều "bước" cho biết khoảng cách và toạ độ di chuyển. Để tìm toạ độ cuối cùng có thể đến được bằng ô tô, hãy sử dụng trường "end_location" của bước cuối cùng trong chặng cuối cùng của tuyến đường bạn đã chọn.
Vị trí này có vẻ không phải là lựa chọn đầu tiên, nhưng khi xem bản đồ hoặc Chế độ xem đường phố của Google, bạn sẽ thấy vị trí này cách Nhà thờ Đức Bà một quãng đi bộ rất ngắn, khoảng 6-7 phút.
Tuyến đường đi bộ từ bãi đỗ xe đến Nhà thờ Đức Bà
Tóm tắt ví dụ 1
Như bạn có thể thấy, việc tìm khu vực đỗ xe cho ô tô chỉ cần một vài lệnh gọi API và hiển thị đề xuất cho người lái xe. Điều này giúp người dùng tiết kiệm thời gian vì họ không phải lái xe trên đường một chiều hoặc tìm chỗ đỗ xe ở một điểm tham quan đông đúc. Tóm lại, chúng ta đã thực hiện các yêu cầu API sau:
- Yêu cầu API Địa điểm để tìm toạ độ của Nhà thờ Đức Bà
- Yêu cầu API Địa điểm để tìm khu vực đỗ xe trong phạm vi 300 mét tính từ các toạ độ đó
- Yêu cầu API Chỉ đường để tìm tuyến đường đến khu vực đỗ xe
Ví dụ 2 – Hướng dẫn đến một nhà ga trong sân bay lớn
"types" : [ "airport", "point_of_interest", "establishment" ],
Tuy nhiên, bất kỳ ai đã từng đến sân bay lớn đều biết rằng sẽ mất khá nhiều thời gian để di chuyển giữa các nhà ga nếu bạn đến nhầm vị trí. Trong trường hợp này, vì loại kết quả tìm kiếm là "sân bay", nên bạn nên tự động theo dõi truy vấn để tìm "nhà ga" bằng vị trí của sân bay Heathrow ở London (51.47016927594547, -0.45432767852489075). Trong ví dụ này, bạn cũng có thể thấy giới hạn không bắt buộc về bán kính tìm kiếm là 3.000 mét.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
Truy vấn ở trên cung cấp cho chúng ta danh sách các trạm và điểm trả xe riêng lẻ tại các trạm đó. Trong danh sách kết quả, chúng ta có thể tìm thấy "Nhà ga 5 của sân bay London Heathrow" và mã địa điểm của nhà ga này:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Bằng cách sử dụng tham số "place_id", chúng ta có thể cho Directions API biết rằng chúng ta đang cố gắng đến một địa điểm thay vì một số toạ độ tuỳ ý.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Xin nhắc lại, giống như trong ví dụ trước, bằng cách đọc tất cả các bước trong phản hồi JSON, bạn sẽ thấy phần cuối của hành trình và toạ độ vĩ độ và kinh độ của vị trí kết thúc (51.47079979999999,-0.4896765).
Tóm tắt ví dụ 2
Giống như trong ví dụ trước, nỗ lực phát triển để cung cấp hướng dẫn cải tiến cho trình điều khiển là rất nhỏ và lợi ích về thời gian tiết kiệm cho trình điều khiển có thể dễ dàng đo lường. Chúng tôi đã thực hiện những yêu cầu sau:
- Yêu cầu API Địa điểm để tìm sân bay Heathrow
- Yêu cầu API Địa điểm để tìm tất cả các nhà ga gần toạ độ sân bay Heathrow
- Yêu cầu API Chỉ đường để nhận tuyến đường đến nhà ga 5
Kết luận
Như bạn có thể thấy, nỗ lực phát triển cần thiết để cung cấp dịch vụ cao cấp cho những khách hàng đi bằng ô tô là khá nhỏ và cho phép bạn dễ dàng thể hiện cách bạn suy nghĩ về nhu cầu của khách hàng.
Đối với mục đích phát triển, bạn có thể sử dụng nhiều thư viện và công cụ có sẵn để xây dựng dịch vụ cho khách hàng. Hãy xem kho lưu trữ GitHub công khai của chúng tôi dành cho Nền tảng Google Maps.
Hành động tiếp theo
Tác giả chính
Mikko Toivanen | Kỹ sư giải pháp Nền tảng Google Maps