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

Tổng quan

web iOS API

Google Maps Platform có sẵn cho web (JS, TS), Android và iOS, đồng thời cung cấp 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 chúng tôi cung cấp các đường liên kết đến tài liệu để triển khai trên các nền tảng khác.

Người dùng thường khó hiểu bảng sao kê giao dịch, cá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ể dẫn đến số 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 sẽ đơn giản hoá các giao dịch này và làm cho chúng trực quan bằng cách cung cấp tên đầy đủ và loại hình doanh nghiệp 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. Chiến dịch này giúp tăng sự hài lòng và tính minh bạch của người dùng, đồng thời cũng có thể giảm các cuộc 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êm 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à các mẹo tuỳ chỉnh mà chúng tôi cung cấp trong đây là chủ đề tối ưu mà chúng tôi đề xuất API Nền tảng Google Maps để tạo dựng người dùng có nhật ký giao dịch tuyệt vời của bạn. 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à đăng thông tin chi tiết của họ.

Màn hình mẫu về giao dịch được bổ sung chi tiết
Màn hình mẫu về giao dịch được bổ sung chi tiết (nhấp để phóng to)

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 Bảng điều khiển Google Cloud. Các siêu liên kết sau đây sẽ chuyển bạn đến Google Cloud Console để bật từng API cho dự án bạn đã chọn:

Để biết thêm thông tin về cách thiết lập, hãy xem bài viết Cách thực hiện bắt đầu với Nền tảng Google Maps.

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 nên tuỳ chỉnh để cải thiện giải pháp này.
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 ở 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 giàu dữ liệu cung cấp thông tin hữu ích về người bán để người dùng có thể 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: Places API

Sơ đồ dưới đây cho thấy cách ứng dụng của bạn so khớp với 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 người bán hiện có hoặc thông qua yêu cầu Tìm kiếm địa điểm:

Ma trận quy trình so khớp người bán
Ma trận quy trình so khớp người bán (nhấp để phóng to)

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ư doanh nghiệp tên và địa chỉ của nó. Để 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 ID địa điểm trên Nền tảng Google Maps tương ứng với mỗi người bán trong cơ sở dữ liệu của mình.

Để nhận 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 miễn phí Tìm địa điểm – Chỉ dùng giấy tờ tuỳ thân . Nếu người bán có nhiều địa điểm, hãy sử dụng tên người bán trong liên từ với tên thành phố hoặc tên đường phố. Chất lượng của dữ liệu được trả về bởi lệnh gọi sẽ khác nhau, do đó bạn cần xác thực xem kết quả có trả về hay không thực sự khớp với người bán mong muốn.

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 về người bán trên Nền tảng Google Maps trong tương lai theo yêu cầu, 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 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ó thể còn tìm kiếm mã địa điểm mỗi khi người dùng yêu cầu chi tiết giao dịch.

Để đảm bảo bạn luôn có thông tin chính xác nhất, làm mới Mã địa điểm 12 tháng một lần bằng cách sử dụng Chi tiết địa điểm với thông số place_id.

Trong trường hợp Chi tiết địa điểm bạn đăng không khớp với người bán ở nơi đã 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 người bán.

Hiện thông tin chi tiết về người bán

Ví dụ này sử dụng: Places API Cũng có: SDK Địa điểm dành cho Android | SDK Địa điểm dành cho iOS | Thư viện địa điểm, API Maps JavaScript

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 vị trí. 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ề những gì họ đã hoàn thành giao dịch. Sau khi gọi đến API Địa điểm để nhận Chi tiết đị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 bạn muốn.

Màn hình thông tin mẫu về người bán
Màn hình thông tin mẫu về người bán (nhấp để phóng to)

Để 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 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 đị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 dữ liệu đầu ra json dành cho Google Taipei 101 mã địa điểm:

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 có: Android | iOS

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

API tĩnh của Maps chấp nhận đị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ể bỏ qua phần tiếp theo, nhưng bạn nên sử dụng toạ độ thay vì địa chỉ cho bản đồ độ chính xác.

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, bạn có thể sử dụng API mã hóa địa lý để chuyển đổi địa chỉ đường phố thành 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ề việc sử dụng API mã hóa địa lý để nhận 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 qua điều hướng, bạn muốn tạo bản đồ có giới hạn tương tác.

Đố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 bằng một điểm đánh dấu vĩ độ/kinh độ hoặc địa chỉ của người bán. Bạn có thể sử dụng API Tĩnh của Maps bằng cách sử dụ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 vào các tham số bạn chỉ định. Đối với thiết bị di động, hãy chuyển đến tiếp theo Thêm bản đồ trong mục ứng dụng dành cho thiết bị di động của bạn.

Lệnh gọi sau đây hiển thị một lộ trình, với kích thước 640x480px, tập trung vào 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. Mã này cũng chỉ định điểm đánh dấu vị trí giao hàng 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 khoá=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ố) signature=BASE64_SIGNATURE
Tham số kênh giải pháp (Xem tài liệu về tham 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:

Hình ảnh bản đồ tĩnh về Văn phòng của Google Đài Bắc

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 các lựa chọn khác về thông số, hãy xem Tài liệu về API Maps tĩnh.

Thêm bản đồ trong ứng dụng dành cho thiết bị di động của bạn

Nếu bạn đang sử dụng SDK Maps dành cho Android hoặc SDK bản đồ dành cho iOS, bạn có thể đặt một điểm đánh dấu sử dụng toạ độ từ 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 di chuyển, chọn một bản đồ có tính tương tác hạn chế: