Có một phiên bản mới hơn của tài liệu này, trong đó có ví dụ về cách sử dụng Places API và Routes API mới.
Thông thường, khi lái xe đến một địa điểm yêu thích (POI), người dùng sẽ thực sự cần chỉ đường đến một địa điểm gầ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ự, bãi đậu xe bên cạnh trung tâm mua sắm có thể là lựa chọn phù hợp hơn nhiều cho người dùng có ô tô. 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í mà họ sẽ đến, sau đó cung cấp cho người lái xe các điểm đến tuỳ chọn gần vị trí đó. Phương pháp này giú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 coi trọng thời gian của họ, chỉ cần 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.
Simplified view of systems involved when guiding the driver to a location with a car
Chúng tôi sẽ hướng dẫn cách bạn có thể 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 điểm đế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 chỗ đậu xe khi lái xe đến gần điểm đến cuối cùng. Hãy xem xét chi tiết 2 ví dụ về cách triển khai các trường hợp này.
Ví dụ 1 – một điểm du lịch 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 lề đường để có thể truy xuất riêng một tuyến đường, đích đến là Nhà thờ Đức Bà ở Paris và điểm bắt đầu là ga tàu Gare de l’Est (48.87697775149635, 2.3592247806755564).
Người lái xe rời khỏi trạm sạc 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 du lịch nổi tiếng trên một hòn đảo có cầu nối, một số đường một chiều và không có bãi đỗ xe lớn ở 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 Places API mẫu này đang sử dụ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à API Chỉ đường của Nền tảng Google Maps được bật trong Google Cloud Console. Để biết giải thích chi tiết hơn, 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 sẽ cung cấp các toạ độ vĩ độ và kinh độ sau:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Như bạn thấy, toạ độ này thực sự chỉ đến 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ỗ đậu 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 có thể cân nhắc sử dụng 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 bãi đỗ xe gần Nhà thờ Đức Bà, hãy thực hiện một tìm kiếm văn bản Places API với các tham số loại "parking" và bán kính "300". Ví dụ này sẽ thiên về kết quả là các khu vực đỗ xe trong vòng 300 mét tính từ Nhà thờ Đức Bà.
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à "Parking Saemes Maubert-Lagrange" tại 48.850591, 2.3486436. Hãy sử dụng vị trí này trong phần tiếp theo khi chúng ta thực hiện yêu cầu Directions API.
Yêu cầu Directions API
Để tìm đường đi từ nhà ga đến một bãi đỗ xe gần Nhà thờ Đức Bà, bạn cần thực hiện một yêu cầu Directions API. 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 lựa 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 Directions API thường chứa nhiều đề xuất về tuyến đường. Mỗi tuyến đường bao gồm nhiều "chặng" và những chặng này chứa nhiều "bước" cho biết khoảng cách di chuyển và toạ độ. Để 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 mà 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 nhìn vào bản đồ hoặc Google Street View, bạn sẽ thấy rằng vị trí này chỉ cách Nhà thờ Đức Bà một đoạn đ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 thấy, việc tìm một khu vực đỗ xe 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 cố gắng tìm chỗ đỗ xe ở một điểm du lịch đông đúc. Tóm lại, chúng tôi đã thực hiện các yêu cầu API sau:
- Một yêu cầu Places API để tìm toạ độ của Nhà thờ Đức Bà
- Một yêu cầu Places API để tìm khu vực đỗ xe trong vòng 300 mét tính từ những toạ độ đó
- Yêu cầu Directions API để tìm đường đến khu vực đỗ xe
Ví dụ 2 – Chỉ đường đế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 ghé thăm một sân bay lớn đều biết rằng bạn sẽ mất một khoảng thời gian đáng kể để di chuyển giữa các nhà ga nếu vô tình đế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 việc tự động theo dõi truy vấn để tìm kiếm "nhà ga" bằng vị trí của sân bay Heathrow London (51.47016927594547, -0.45432767852489075) là điều hữu ích. 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 nhà ga và từng điểm dừng tại các nhà ga đó. Trong danh sách kết quả, chúng ta có thể tìm thấy "Nhà ga số 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 chứ không phải 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
Tương tự như 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ẽ tìm thấy phần cuối cùng của hành trình và toạ độ vĩ độ và kinh độ của vị trí cuối (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 người lái xe là rất nhỏ và lợi ích về thời gian tiết kiệm được cho người lái xe rất dễ đo lường. Chúng tôi đã thực hiện các yêu cầu sau:
- Yêu cầu Places API để tìm sân bay Heathrow
- Một yêu cầu Places API để tìm tất cả các nhà ga gần toạ độ sân bay Heathrow
- Yêu cầu Directions API để lấy tuyến đường đến nhà ga số 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 khách hàng đi ô tô là khá nhỏ và cho phép bạn dễ dàng minh hoạ 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 để giúp bạn tạo các dịch vụ cho khách hàng. Hãy xem kho lưu trữ GitHub có sẵn công khai của chúng tôi 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 của Nền tảng Google Maps