Hướng dẫn triển khai Giao dịch được bổ sung chi tiết

Tổng quan

Người dùng thường khó hiểu các thông báo giao dịch vì sử dụng các từ viết tắt như "ACMEHCORP" thay vì tên người bán như "Acme Houseware". Điều này có thể dẫn đến việc tăng số lượng cuộc gọi hỗ trợ khách hàng và các tranh chấp tốn kém. Giao dịch được làm phong phú giúp đơn giản hoá và trực quan hoá các giao dịch này bằng cách cung cấp tên đầy đủ và danh mục doanh nghiệp của người bán, ảnh trang chủ cửa hàng, địa chỉ và vị trí của trang chủ cửa hàng trên bản đồ, thông tin liên hệ đầy đủ, v.v. Đ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ố cuộc gọi hỗ trợ khách hàng, tăng NPS và tăng thời gian người dùng dành cho ứng dụng.

Giao dịch được làm phong phú (hướng dẫn triển khai và các mẹo tuỳ chỉnh mà chúng tôi cung cấp trong chủ đề này) là cách kết hợp tối ưu giữa các API Nền tảng Google Maps để mang lại trải nghiệm tuyệt vời cho người dùng về nhật ký giao dịch. Hướng dẫn triển khai này sẽ hướng dẫn bạn cách so khớp một 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 làm phong phú, bạn phải bật các API sau trong Google Cloud Console. Các đường liên kết siêu văn bản sau đây sẽ đưa bạn đến Google Cloud Console để bật từng API cho dự án bạn đã chọn:

• Places API.
• Geocoding API.
• Maps Static API, SDK Maps cho Android hoặc SDK Maps cho iOS.

Các phần trong hướng dẫn triển khai

Sau đây là các phương thức triển khai và tuỳ chỉnh mà chúng ta sẽ đề cập trong chủ đề này.

• check_circle_filled Biểu tượng dấu kiểm là một bước triển khai cốt lõi.
• stars Biểu tượng ngôi sao là một tuỳ chọn tuỳ chỉnh không bắt buộc nhưng nên dùng để nâng cao giải pháp.

Sơ đồ sau đây cho thấy cách ứng dụng của bạn so khớp các 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:

Lấy 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 có thông tin cơ bản như tên và địa chỉ của doanh nghiệp. Để nhận 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 sẽ cần mã địa điểm của 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 API Địa điểm và chỉ yêu cầu trường place_id để tính phí yêu cầu dưới dạng lệnh gọi Tìm địa điểm – chỉ mã 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 cùng với tên thành phố hoặc tên đường. Chất lượng của dữ liệu do 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ả 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 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 cho tham số đầu vào trong yêu cầu API.

Lưu trữ mã địa điểm

Để lưu trữ thông tin về người bán từ Google Maps Platform 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 dưới dạng thuộc tính của bản ghi 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 chi tiết về 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 mỗi 12 tháng bằng cách sử dụng yêu cầu Thông tin chi tiết về địa điểm với tham 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 mà họ đã thực hiện giao dịch, bạn nên cho phép người dùng đưa ra ý kiến phản hồi về chất lượng của kết quả so khớp người bán.

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 vị trí của bạn. Với Thông tin chi tiết về địa điểm phong phú như thông tin liên hệ, giờ hoạt động, đ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. Sau khi thực hiện lệnh gọi đến API Địa điểm để nhận 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 web hoặc theo bất kỳ cách nào bạn muốn trong phạm vi Điều khoản dịch vụ của chúng tôi.

Để 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í. Hãy xem phần Lấy mã địa điểm để truy xuất mã địa điểm của vị trí.

Yêu cầu Chi tiết địa điểm sau đây sẽ trả về địa chỉ, toạ độ, trang web, số điện thoại, điểm xếp hạng và giờ hoạt động trong kết quả json cho mã địa điểm Google Taipei 101:

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

Xác định vị trí của người bán

API Maps Static chấp nhận địa chỉ hoặc toạ độ để đặt điểm đánh dấu. Nếu bản ghi người bán của bạn đã có địa chỉ, bạn có thể chuyển sang phần tiếp theo. Tuy nhiên, bạn nên sử dụng toạ độ thay vì địa chỉ để có thông tin chính xác trên bản đồ.

Nếu cơ sở dữ liệu người bán của 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 một lần mỗi 30 ngày.

Dưới đây là ví dụ về cách sử dụng API Mã hoá địa lý để lấy vĩ độ và kinh độ của mã địa điểm văn phòng 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 điểm đánh dấu cho vị trí của người bán vào bản đồ

Vì người dùng sẽ xem bản đồ để xác nhận giao dịch thay vì duyệt xem hoặc điều hướng, nên 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à thiết bị di động, hãy tạo URL API Maps Static có 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ể sử dụng API Maps Static bằng lệnh gọi dịch vụ web. Lệnh gọi này sẽ tạo 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 sang phần tiếp theo Thêm bản đồ vào phần ứng dụng di động.

Lệnh gọi sau đây cho thấy một lộ trình có kích thước 640x480px, được căn giữa trên một điểm đánh dấu tại văn phòng của Google ở Đài Bắc ở mức thu phóng mặc định. Tệp này cũng chỉ định một điểm đánh dấu vị trí giao hàng màu đỏ và kiểu bản đồ dựa 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

Phần này được chia thành các phần sau:

Hình ảnh này sẽ trở thành như hình dưới đây:

Bạn cũng có thể sử dụng địa chỉ làm vị trí của đ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 tuỳ chọn tham số, hãy xem tài liệu về API Maps Static.

Thêm bản đồ vào ứng dụng dành cho thiết bị di động

Nếu đang sử dụng SDK Maps cho Android hoặc SDK Maps cho iOS, bạn có thể đặt điểm đánh dấu bằng cách sử dụng toạ độ trong thông tin của phần Thông tin chi tiết về địa điểm.

Vì người dùng sẽ xem bản đồ để xác nhận giao dịch thay vì duyệt xem hoặc di chuyển, nên hãy chọn một bản đồ có khả năng tương tác hạn chế:

• Đối với các ứng dụng Android, hãy xem phần Hướng dẫn thêm bản đồ có điểm đánh dấu và bật chế độ Lite để cung cấp khả năng tương tác có giới hạn.
• Đối với các ứng dụng iOS, hãy xem phần Hướng dẫn thêm bản đồ có điểm đánh dấu và tắt các chế độ điều khiển và cử chỉ bằng cờ GMSUiSettings.