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

Tổng quan

Bảng sao kê giao dịch thường khó hiểu đối với người dùng, 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. Tính năng Giao dịch phong phú giúp đơn giản hoá các giao dịch này và giúp chúng 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 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.v. Điều này giúp tăng mức độ hài lòng và tính minh bạch cho người dùng, đồng thời có thể giảm số cuộc gọi đến bộ phận 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 phong phú (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 mà chúng tôi đề xuất cho các API của Google Maps Platform để xây dựng trải nghiệm người dùng tuyệt vời về 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 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 phong phú, bạn phải bật các API sau trong Google Cloud Console. Các siêu liên kết 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, Maps SDK cho Android hoặc SDK bản đồ 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 được đề cập trong phần 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 dấu sao là một tuỳ chỉnh không bắt buộc nhưng nên dùng để cải thiện 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 Chi tiết đị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 Google Maps Platform

Bạn có thể có một cơ sở dữ liệu về người bán, trong đó có thông tin cơ bản như tên và địa chỉ 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 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 bạn.

Để 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 để tính phí 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. Chất lượng của dữ liệu mà lệnh gọi trả về có thể 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 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 Google Đài Bắc bằng cách sử dụng tên người bán và thành phố:

```html
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.

Mã địa điểm của cửa hàng

Để lưu trữ thông tin từ Google Maps Platform 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 trong bản ghi của 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 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 12 tháng một lần bằng cách sử dụng yêu cầu Chi tiết địa điểm có tham số place_id.

Trong trường hợp Chi tiết đị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 đư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ẻ Place Details 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 Place Details phong phú như thông tin liên hệ, giờ hoạt động, điểm xếp hạng từ 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 gọi Places API để lấy Place Details, bạn có thể lọc và hiển thị phản hồi trong cửa sổ thông tin, thanh bên của trang web hoặc theo bất kỳ cách nào bạn muốn trong giới hạn của Điều khoản dịch vụ.

Để yêu cầu Place Details, 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 của vị trí của bạn.

Yêu cầu Chi tiết đị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ờ mở cửa ở định dạng json cho mã địa điểm Google Taipei 101:

```html
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

Maps Static API chấp nhận địa chỉ hoặc toạ độ để đặt điểm đánh dấu. Nếu hồ sơ người bán của 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 bạn có địa chỉ đường phố nhưng không có toạ độ địa lý và bạn chưa yêu cầu Place Details, thì bạn có thể sử dụng Geocoding API để 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 Geocoding API để lấy vĩ độ và kinh độ của mã địa điểm văn phòng Google Đài Bắc:

```html
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 muố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 một URL Maps Static API có một điểm đánh dấu duy nhất tại vĩ độ/kinh độ hoặc địa chỉ của người bán. Bạn có thể sử dụng Maps Static API bằng cách gọi dịch vụ web. Thao tác này sẽ tạo một phiên bản hình ảnh của bản đồ dựa trên các tham số 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 ứng dụng di động.

Lệnh gọi sau đây cho thấy một bản đồ đường, 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 Google Đài Bắc ở mức thu phóng mặc định. Nó cũng chỉ định một điểm đánh dấu vị trí giao hàng màu đỏ và một kiểu Bản đồ dựa trên đám mây:

```html
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
```

Cuộc gọi này được chia thành các phần sau:

Kết quả này sẽ trở thành hình ảnh 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:

```html
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 tham số, hãy xem tài liệu về Maps Static API.

Thêm bản đồ vào ứng dụng di động

Nếu đang sử dụng Maps SDK cho Android hoặc Maps SDK cho iOS, bạn có thể đặt điểm đánh dấu bằng cách sử dụng toạ độ từ thông tin trong Chi tiết đị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 điều hướng, hãy chọn một bản đồ có khả năng tương tác hạn chế:

• Đối với ứng dụng Android, hãy xem Hướng dẫn thêm bản đồ có đ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 ứng dụng iOS, hãy xem 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.