Tổng quan
Google Maps Platform có sẵn cho web (JS, TS), Android và iOS, đồng thời cũng cung cấp các API dịch vụ web để nhận thông tin về địa điểm, chỉ đường và khoảng cách. Các mẫu trong hướng dẫn này được viết cho một nền tảng, nhưng các đường liên kết đến tài liệu cũng được cung cấp để triển khai trên các nền tảng khác.
Người dùng thường khó hiểu tuyên bố giao dịch vì dùng những cách viết tắt như "ACMEHCORP" thay vì tên người bán như "Acme Houseware". Điều này có thể khiến số lượng cuộc gọi hỗ trợ khách hàng tăng lên và tranh chấp tốn kém. Giao dịch được bổ sung chi tiết giúp đơn giản hoá các giao dịch này và trở nên trực quan bằng cách cung cấp tên đầy đủ và danh mục kinh doanh của người bán, ảnh chụp mặt tiền cửa hàng, địa chỉ và vị trí của cửa hàng trên bản đồ, thông tin liên hệ đầy đủ và nhiều thông tin khác. Điều này giúp tăng mức độ hài lòng và tính minh bạch của người dùng, đồng thời có thể giảm số lượng lệnh gọi hỗ trợ khách hàng, tăng NPS (chỉ số đo lường mức độ hài lòng của khách hàng) và tăng thời gian sử dụng ứng dụng.
Giao dịch được bổ sung chi tiết (hướng dẫn triển khai và mẹo tuỳ chỉnh mà chúng tôi cung cấp trong chủ đề này) là sự kết hợp tối ưu giữa các API Nền tảng Google Maps để tạo trải nghiệm người dùng tuyệt vời cho nhật ký giao dịch. Hướng dẫn triển khai này sẽ cho bạn biết cách so khớp vị trí với một người bán cụ thể và hiển thị thông tin chi tiết của họ.
Bật API
Để triển khai Giao dịch được bổ sung chi tiết, bạn phải bật các API sau trong Google Cloud Console. Các siêu liên kết sau sẽ đưa bạn đến Google Cloud Console để bật từng API cho dự án bạn đã chọn:
- API Địa điểm.
- API mã hoá địa lý.
- Maps Static API, SDK Maps dành cho Android hoặc SDK Maps dành cho iOS.
Các phần trong hướng dẫn triển khai
Sau đây là các cách triển khai và tuỳ chỉnh mà chúng tôi sẽ đề cập trong chủ đề này.
- Biểu tượng dấu kiểm là một bước triển khai cốt lõi.
- Biểu tượng dấu sao là không bắt buộc nhưng bạn nên tuỳ chỉnh để cải thiện giải pháp.
| So khớp người bán với Nền tảng Google Maps | Liên kết người bán trong nhật ký giao dịch với một địa điểm trong Nền tảng Google Maps. | |
| Hiện thông tin chi tiết về người bán | Hiển thị các giao dịch chứa dữ liệu phong phú, trong đó cho thấy thông tin hữu ích về người bán, giúp người dùng nhanh chóng nhận ra giao dịch. | |
| Thêm bản đồ vị trí của người bán | Thêm bản đồ vị trí của người bán. |
So khớp người bán với Nền tảng Google Maps
| Ví dụ này sử dụng: API Địa điểm |
Sơ đồ dưới đây cho thấy cách ứng dụng so khớp giao dịch của người bán để trả về kết quả bằng cách sử dụng Thông tin chi tiết về địa điểm từ cơ sở dữ liệu hiện có của người bán hoặc thông qua yêu cầu Tìm kiếm địa điểm:
Tải mã địa điểm trên Nền tảng Google Maps
Bạn có thể có một cơ sở dữ liệu về người bán với thông tin cơ bản như tên doanh nghiệp và địa chỉ của doanh nghiệp. Để nhận được thông tin mà Nền tảng Google Maps có về địa điểm đó, bao gồm cả thông tin liên hệ và thông tin do người dùng đóng góp, bạn cần có mã địa điểm trên Nền tảng Google Maps tương ứng với từng người bán trong cơ sở dữ liệu của mình.
Để lấy mã địa điểm của một doanh nghiệp, hãy gửi yêu cầu đến điểm cuối /findplacefromtext trong Places API và chỉ yêu cầu trường place_id để lập hoá đơn cho yêu cầu dưới dạng lệnh gọi Tìm địa điểm – Chỉ mã nhận dạng (không tính phí). Nếu người bán có nhiều địa điểm, hãy sử dụng tên người bán kết hợp với tên thành phố hoặc tên đường phố. Chất lượng của dữ liệu mà lệnh gọi trả về sẽ khác nhau, vì vậy, bạn cần xác thực xem kết quả được trả về có thực sự khớp với người bán mong muốn hay không.
Dưới đây là ví dụ về cách yêu cầu mã địa điểm cho văn phòng của Google Đài Bắc bằng cách sử dụng tên người bán và thành phố:
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
Hãy nhớ Mã hoá URL tham số đầu vào trong yêu cầu API.
Lưu trữ mã địa điểm
Để lưu trữ thông tin trên Nền tảng Google Maps về người bán cho các yêu cầu trong tương lai, bạn có thể lưu trữ mã địa điểm này vô thời hạn trong cơ sở dữ liệu của mình dưới dạng một thuộc tính của hồ sơ người bán. Bạn chỉ cần thực hiện yêu cầu Tìm địa điểm một lần cho mỗi người bán. Bạn cũng có thể tìm kiếm mã địa điểm mỗi khi người dùng yêu cầu thông tin giao dịch.
Để đảm bảo bạn luôn có thông tin chính xác nhất, hãy làm mới Mã địa điểm 12 tháng một lần bằng cách sử dụng yêu cầu Chi tiết địa điểm bằng thông số place_id.
Trong trường hợp Thông tin chi tiết về địa điểm mà bạn hiển thị không khớp với người bán nơi họ thực hiện giao dịch, bạn nên cho phép người dùng cung cấp ý kiến phản hồi về chất lượng so khớp của thông tin người bán đã khớp.
Hiện thông tin chi tiết về người bán
| Ví dụ này sử dụng: API Địa điểm | Cũng có sẵn: SDK Địa điểm dành cho Android | SDK Địa điểm dành cho iOS | Thư viện Địa điểm, API JavaScript cho Maps |
Bạn có thể chia sẻ Thông tin chi tiết về địa điểm mà người dùng cần biết sau khi họ ghé thăm một trong các địa điểm của bạn. Với Thông tin chi tiết phong phú về địa điểm như thông tin liên hệ, giờ làm việc, điểm xếp hạng của người dùng và ảnh của người dùng, ứng dụng của bạn có thể nhắc người dùng về giao dịch đã hoàn tất của họ. Sau khi thực hiện lệnh gọi đến API Địa điểm để lấy Thông tin chi tiết về địa điểm, bạn có thể lọc và hiển thị phản hồi trong cửa sổ thông tin, thanh bên trên web hoặc theo bất kỳ cách nào khác mà bạn muốn.
Để yêu cầu Thông tin chi tiết về địa điểm, bạn cần có mã địa điểm của từng vị trí. Xem phần Lấy mã địa điểm để truy xuất mã địa điểm cho vị trí của bạn.
Yêu cầu Chi tiết về địa điểm sau đây trả về địa chỉ, toạ độ, trang web, số điện thoại, điểm xếp hạng và giờ trong đầu ra json cho mã địa điểm 101 của Google Đài Bắc:
https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
Thêm bản đồ vị trí của người bán
| Ví dụ này sử dụng: API mã hoá địa lý | API tĩnh của Maps | Cũng áp dụng: Android | iOS |
Xác định vị trí của người bán
Maps Static API chấp nhận một địa chỉ hoặc toạ độ để đặt một điểm đánh dấu. Nếu bản ghi người bán đã có địa chỉ, bạn có thể chuyển sang phần tiếp theo, nhưng bạn nên sử dụng toạ độ thay vì địa chỉ để đảm bảo độ chính xác của bản đồ.
Nếu cơ sở dữ liệu người bán có địa chỉ đường phố nhưng không có toạ độ địa lý và bạn chưa yêu cầu Thông tin chi tiết về địa điểm, thì bạn có thể sử dụng API mã hoá địa lý để chuyển đổi địa chỉ đường phố thành toạ độ vĩ độ/kinh độ phía máy chủ, lưu trữ toạ độ trong cơ sở dữ liệu và làm mới toạ độ ít nhất 30 ngày một lần.
Dưới đây là ví dụ về cách sử dụng API mã hóa địa lý để lấy vĩ độ và kinh độ của mã địa điểm văn phòng của Google Đài Bắc:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
Thêm một điểm đánh dấu cho vị trí của người bán vào bản đồ
Vì người dùng của bạn sẽ nhìn thấy bản đồ để xác nhận giao dịch thay vì duyệt hoặc điều hướng, bạn nên tạo một bản đồ có khả năng tương tác hạn chế.
Đối với web dành cho máy tính và web dành cho thiết bị di động, hãy tạo URL API tĩnh của Maps với một điểm đánh dấu tại vĩ độ/kinh độ hoặc địa chỉ của người bán. Bạn có thể dùng Maps Static API bằng cách sử dụng lệnh gọi dịch vụ web. Lệnh gọi này sẽ tạo ra một phiên bản hình ảnh của bản đồ dựa trên các tham số mà bạn chỉ định. Đối với thiết bị di động, hãy chuyển đến phần Thêm bản đồ trên ứng dụng dành cho thiết bị di động tiếp theo.
Lệnh gọi sau đây cho thấy một lộ trình có kích thước 640x480px, đặt ở giữa một điểm đánh dấu tại văn phòng Google Đài Bắc ở mức thu phóng mặc định. Phương thức này cũng chỉ định một điểm đánh dấu vị trí phân phối màu đỏ và kiểu bản đồ trên đám mây:
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
Việc này sẽ được chia nhỏ thành các phần sau:
| URL của API | https://maps.googleapis.com/maps/api/staticmap? |
| Kích thước hình ảnh | kích thước=640x480 |
| Điểm đánh dấu vị trí của người bán (Sử dụng phương thức mã hoá URL) | bút đánh dấu=màu:đỏ%7C25.033976%2C121.5645389 |
| Kiểu bản đồ trên đám mây | map_id=b224095f76859890 |
| Khoá API | key=YOUR_API_KEY |
| Chữ ký số (Tìm hiểu cách ký yêu cầu bằng phương thức kỹ thuật số) | chữ ký=BASE64_SIGNATURE |
| Tham số kênh giải pháp (Xem tài liệu về thông số) | solution_channel=GMP_guides_enrichedtransactions_v1_a |
Thao tác này sẽ trở thành hình ảnh như minh hoạ dưới đây:
Bạn cũng có thể sử dụng địa chỉ làm vị trí điểm đánh dấu:
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
Để biết thêm các lựa chọn về tham số, hãy xem tài liệu về API tĩnh của Maps.
Thêm bản đồ trong ứng dụng dành cho thiết bị di động của bạn
Nếu đang sử dụng SDK Maps dành cho Android hoặc SDK Maps dành cho iOS, bạn có thể đặt một điểm đánh dấu bằng cách sử dụng các toạ độ trong thông tin trong Chi tiết địa điểm.
Vì người dùng của bạn sẽ nhìn thấy bản đồ để xác nhận giao dịch thay vì duyệt qua hoặc điều hướng, hãy chọn một bản đồ có giới hạn tương tác:
- Đối với các ứng dụng Android, hãy xem phần Thêm bản đồ với hướng dẫn về điểm đánh dấu và bật chế độ thu gọn để cung cấp khả năng tương tác hạn chế.
- Đối với các ứng dụng iOS, hãy xem phần Thêm bản đồ với hướng dẫn về điểm đánh dấu và tắt các chế độ điều khiển và cử chỉ bằng cờ
GMSUiSettings.