Trang này được dịch bởi Cloud Translation API.

Chuyển hướng người dùng đến Thông tin chi tiết và đường đi của địa điểm trên Google Maps bằng URL Maps hoặc API Địa điểm

Trong thế giới nhận biết vị trí ngày nay, người dùng mong đợi có thể truy cập liền mạch vào thông tin về địa điểm, thông tin chỉ đường và chỉ dẫn đường đi. Cho dù thông qua ứng dụng nhắn tin, ứng dụng khám phá bối cảnh địa phương, nền tảng hậu cần và vận tải, công cụ lập kế hoạch du lịch hay nền tảng đăng tin bất động sản, người dùng thường cần xem nhanh thông tin chi tiết về vị trí hoặc tìm tuyến đường tối ưu nhất từ A đến B. Mặc dù nhà phát triển có thể xây dựng trải nghiệm trong ứng dụng của riêng mình, nhưng việc tận dụng giao diện toàn diện và quen thuộc của Google Maps sẽ mang lại trải nghiệm vượt trội.

URL Google Maps có cấu trúc hợp lý là yếu tố cần thiết để mang đến trải nghiệm liền mạch cho người dùng. URL không chính xác sẽ ảnh hưởng đến trải nghiệm này, chuyển hướng người dùng đến vị trí không chính xác, hiển thị chế độ xem bản đồ chung thay vì thông tin cụ thể, hoặc thậm chí dẫn đến một đường liên kết bị hỏng. Điều này khiến người dùng cảm thấy khó chịu và không thể đạt được mục tiêu của họ. Ví dụ: ngay cả khi có một URL hợp lệ trên Maps, người dùng đang mong đợi thông tin chi tiết về một doanh nghiệp cụ thể có thể thay vào đó lại truy cập vào một chế độ xem bản đồ chung mà không có thông tin liên quan. Xem ví dụ bên dưới:

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

URL này của Maps hợp lệ để mở Google Maps và hiển thị một vị trí dựa trên vĩ độ và kinh độ. Tuy nhiên, tính năng này không cung cấp cho người dùng thông tin chi tiết về một địa điểm cụ thể.

Chỉ tìm kiếm bằng vĩ độ và kinh độ

Dễ dàng kết nối ứng dụng của bạn với Google Maps thông qua các URL chính xác

Mở trang Chi tiết về địa điểm trên Google Maps

URL trên Maps có tên địa điểm riêng biệt sẽ chuyển người dùng đến trang thông tin chi tiết của địa điểm đó trên Google Maps

Nền tảng Google Maps (GMP) cung cấp 2 phương thức chính để tạo URL chính xác: Places API (mới) (yêu cầu khoá API) và URL Maps (miễn phí và không yêu cầu khoá). Các giải pháp sau đây giải quyết nhiều tình huống và trường hợp sử dụng:

Sử dụng trường googleMapsUri hoặc googleMapsLinks của GMP Places API(Mới)

GMP Places API(Mới) trả về một bộ thông tin toàn diện về một địa điểm cụ thể. Khi yêu cầu trường googleMapsUri hoặc googleMapsLinks (bằng cách chỉ định trường này trong mặt nạ trường), phản hồi API sẽ bao gồm một đối tượng địa điểm. Đối tượng này chứa các URL được định dạng sẵn, có thể dùng để mở trực tiếp chế độ xem tương ứng, chẳng hạn như chế độ xem chi tiết về địa điểm, trong Google Maps.

Ví dụ:

Yêu cầu về thông tin chi tiết về địa điểm

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

Phản hồi về thông tin chi tiết về địa điểm:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

ChIJ3S-JXmauEmsRUcIaWtf4MzE trong ví dụ trên là Mã địa điểm của Nhà hát Opera Sydney. Mã địa điểm là giá trị nhận dạng bằng văn bản giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps.

Truy xuất mã địa điểm mà không tốn phí

Để truy xuất mã địa điểm theo phương thức lập trình, bạn có thể sử dụng chức năng Places API: Text Search(Chỉ mã nhận dạng). Đây là phương pháp không tốn chi phí để lấy mã địa điểm. Tìm hiểu thêm về Mã địa điểm và yêu cầu Place API(mới).

Yêu cầu tìm kiếm văn bản bằng Places API(Chỉ mã nhận dạng):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Phản hồi của Places API Text Search(Chỉ mã nhận dạng):

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Bạn cũng có thể truy xuất mã địa điểm khi người dùng nhấp hoặc nhấn vào một địa điểm yêu thích trên bản đồ. Tìm hiểu thêm thông tin chi tiết về biểu tượng POI có thể nhấp vào(JavaScript, Android, iOS)

Triển khai

Khi sử dụng Places API, nhà phát triển chỉ cần trích xuất trường googleMapsUri hoặc googleMapsLinks từ phản hồi và sử dụng trường đó để chạy chế độ xem tương ứng trong ứng dụng Google Maps hoặc trong trình duyệt nếu ứng dụng chưa được cài đặt.

Tính năng	Mô tả
directionsUri	Đường liên kết để mở Google Maps và hiển thị đường đi từ vị trí hiện tại của người dùng đến địa điểm này
placeUri	Đường liên kết để mở Google Maps đến trang thông tin chi tiết về địa điểm này
writeAReviewUri	Đường liên kết để mở Google Maps ở trang viết bài đánh giá cho địa điểm này
reviewsUri	Đường liên kết để mở Google Maps đến trang bài đánh giá của địa điểm này
photosUri	Đường liên kết để mở Google Maps ở trang ảnh của địa điểm này

Hãy xem hướng dẫn cho nhà phát triển và dùng thử tính năng này ngay hôm nay.

Sử dụng URL của Maps

Bằng cách sử dụng URL Maps, bạn có thể tạo một URL đa nền tảng, phổ biến để chạy Google Maps, thực hiện tìm kiếm, tìm đường đi và chỉ đường, cũng như hiển thị chế độ xem bản đồ và hình ảnh toàn cảnh. Cú pháp URL giống nhau bất kể nền tảng đang sử dụng. Bạn không cần khoá API của Google để sử dụng URL của Maps.

Các thao tác có thể thực hiện trên bản đồ là:

Chức năng Tìm kiếm sẽ khởi chạy ứng dụng Google Maps hoặc trong trình duyệt nếu ứng dụng chưa được cài đặt. Chức năng này sẽ hiển thị một ghim cho một địa điểm cụ thể hoặc thực hiện một tìm kiếm chung và khởi chạy bản đồ để hiển thị kết quả.
Hàm Chỉ đường sẽ khởi chạy ứng dụng Google Maps hoặc trong trình duyệt nếu ứng dụng chưa được cài đặt. Hàm này sẽ hiển thị đường đi giữa các điểm hoặc cho phép chỉ đường từng chặng trên Google Maps cho thiết bị di động.
Hàm ảnh toàn cảnh trong Chế độ xem đường phố cho phép bạn chạy một trình xem để hiển thị hình ảnh trong Chế độ xem đường phố dưới dạng ảnh toàn cảnh tương tác.

Hãy truy cập tài liệu dành cho nhà phát triển về URL của Maps trong GMP để khám phá thêm các hàm và ví dụ.

Sau đây là 2 chức năng chính của URL trên Maps:

Hiển thị thông tin chi tiết về địa điểm trên Google Maps: Phần này giải thích cách tạo URL sẽ hiển thị thông tin chi tiết cho một vị trí cụ thể trên Google Maps. Tài liệu này cũng trình bày chi tiết cách làm việc với những địa điểm có tên không phải là tên duy nhất bằng cách sử dụng mã địa điểm và các truy vấn chính xác.
Cung cấp chỉ đường bằng URL của Maps: Phần này giải thích cách tạo URL cung cấp chỉ đường giữa các vị trí, bao gồm cả chỉ đường có nhiều điểm đến và chỉ đường từng chặng.

Hiển thị thông tin chi tiết về địa điểm trên Google Maps

Hàm Tìm kiếm nhận 2 tham số để hoàn tất quá trình tìm kiếm địa điểm, đó là query(bắt buộc) và query_place_id(không bắt buộc).

Tham số query là tham số bắt buộc đối với tất cả các yêu cầu tìm kiếm. API này chấp nhận tên địa điểm, hoặc toạ độ vĩ độ/kinh độ được phân tách bằng dấu phẩy, hoặc một cụm từ tìm kiếm chung.

Cấu trúc URL tìm kiếm:

https://www.google.com/maps/search/?api=1&parameters

Tình huống 1: Hiển thị thông tin chi tiết về địa điểm cho một tên địa điểm duy nhất

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House

Trong ví dụ này, bạn chỉ cần chỉ định tên địa điểm. URL này sẽ mở trang chi tiết của Nhà hát Opera Sydney.

Tìm tên địa điểm và hiển thị thông tin chi tiết về địa điểm

Bây giờ, hãy xem xét một địa điểm có tên không riêng biệt. Điều gì xảy ra khi bạn chỉ tìm kiếm theo tên không phải là tên duy nhất này? Xem trường hợp tiếp theo.

Trường hợp 2: Tìm kiếm địa điểm bằng tên địa điểm không phải là tên duy nhất

https://www.google.com/maps/search/?api=1&query=7-Eleven

Vì tên địa điểm không phải là duy nhất, nên URL này sẽ mở ra một danh sách các địa điểm 7-Eleven lân cận trong khung hiển thị. Sau đó, người dùng có thể chọn một cửa hàng cụ thể để xem thông tin chi tiết.

Mở trang Danh sách địa điểm trên Google Maps

Trang danh sách địa điểm để tìm kiếm tên không duy nhất

Để tránh danh sách vị trí và truy cập trực tiếp vào một trang chi tiết cụ thể, bạn có thể sử dụng một phương pháp chính xác hơn. Hãy xem ví dụ tiếp theo.

Trường hợp 3: Hiển thị thông tin chi tiết về địa điểm cho một tên địa điểm không phải là duy nhất

Khi xử lý tên địa điểm phổ biến, một cụm từ tìm kiếm đơn giản thường trả về danh sách các vị trí. Để liên kết trực tiếp đến một trang chi tiết cụ thể, bạn có thể sử dụng một trong các phương thức sau:

Cách 1: Sử dụng một cụm từ tìm kiếm chính xác có Tên và địa chỉ của địa điểm

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

Trong URL này, tham số query được định dạng là tên địa điểm, địa chỉ. Điều này giúp thu hẹp phạm vi tìm kiếm và liên kết trực tiếp đến vị trí dự kiến.

Cách 2: Sử dụng mã địa điểm

Mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps.

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

Trong đó, ChIJGcmcg7ZC1moRAOacd3HoEwM là mã địa điểm duy nhất cho một địa điểm cụ thể. Bạn vẫn phải dùng tham số query nhưng tham số này sẽ chỉ được dùng nếu Google Maps không tìm thấy mã địa điểm.

Trường hợp 4: Hiển thị thông tin chi tiết về địa điểm bằng cách sử dụng toạ độ vĩ độ và kinh độ cũng như mã địa điểm

Việc sử dụng Mã địa điểm đảm bảo Google Maps hiển thị thông tin chi tiết về địa điểm.

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE

Trang Chi tiết về địa điểm sử dụng vĩ độ và kinh độ cũng như Mã địa điểm

Truy xuất mã địa điểm mà không mất phí

Để truy xuất mã địa điểm theo phương thức lập trình, bạn có thể sử dụng chức năng Places API: Text Search(ID Only). Đây là phương thức không tốn phí để lấy mã địa điểm. Tìm hiểu thêm về mã địa điểm và yêu cầu Place API(mới).

Yêu cầu tìm kiếm văn bản bằng Places API(Chỉ mã nhận dạng):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Phản hồi của Places API Text Search(Chỉ mã nhận dạng):

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Lời kết

Việc cung cấp thông tin chính xác về địa điểm là rất quan trọng để mang lại trải nghiệm tích cực. Để đảm bảo người dùng truy cập vào trang chi tiết chính xác của địa điểm, hãy tạo URL tìm kiếm bằng một trong các định dạng được đề xuất sau:

query=PLACE_NAME, ADDRESS
query=PLACE_NAME&query_place_id=PLACE_ID

Tránh chỉ sử dụng toạ độ vĩ độ/kinh độ trong tham số query khi mục tiêu của bạn là hiển thị thông tin chi tiết về một địa điểm cụ thể. Các định dạng như query=latitude,longitude, query=PLACE_NAME,latitude,longitude hoặc query=ADDRESS,latitude,longitude sẽ không nhất quán dẫn đến trang chi tiết về địa điểm mà bạn muốn. Thay vào đó, thông tin này sẽ cho biết vĩ độ và kinh độ của vị trí.

Tìm kiếm theo danh mục bằng URL của Maps

Trong một lượt tìm kiếm theo danh mục, bạn sẽ truyền một cụm từ tìm kiếm chung và Google Maps sẽ cố gắng tìm những trang thông tin phù hợp với tiêu chí của bạn ở gần vị trí mà bạn chỉ định. Nếu bạn không chỉ định vị trí, Google Maps sẽ cố gắng tìm các trang thông tin ở gần vị trí hiện tại của bạn.

Tình huống 1: Tìm kiếm địa điểm lân cận

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now

Tìm kiếm theo danh mục – địa điểm lân cận

Cung cấp chỉ đường bằng URL trên Maps

Chức năng Đường đi hiển thị đường đi giữa hai hoặc nhiều điểm được chỉ định trên bản đồ, cũng như khoảng cách và thời gian di chuyển. Tính năng này giúp nhà phát triển có nhiều quyền kiểm soát hơn đối với các chỉ dẫn được cung cấp. Tài liệu Chỉ đường bằng URL của Maps trong GMP cung cấp hướng dẫn chi tiết về cách tạo URL cho chỉ đường tuỳ chỉnh.

Cấu trúc URL chỉ đường:

https://www.google.com/maps/dir/?api=1&parameters

Tình huống 1: Tìm tuyến đường phù hợp nhất từ vị trí hiện tại của người dùng đến một điểm đến

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

URL này sẽ mở Google Maps và hiển thị chỉ đường lái xe từ vị trí hiện tại của người dùng.

Trong URL này, origin bị bỏ qua. Khi origin bị bỏ qua, đường dẫn sẽ mặc định là vị trí bắt đầu phù hợp nhất, chẳng hạn như vị trí của thiết bị (nếu có). Nếu không có, bản đồ kết quả sẽ cung cấp một biểu mẫu để cho phép người dùng nhập điểm xuất phát. Giá trị của điểm xuất phát và điểm đến có thể là tên địa điểm, địa chỉ hoặc toạ độ vĩ độ/kinh độ được phân tách bằng dấu phẩy.

travelmode là một tham số không bắt buộc. Nơi này xác định phương thức di chuyển. Bạn có thể đặt thông số này như sau:

lái xe
đi bộ
đi xe đạp
xe mô tô hai bánh
phương tiện

Nếu bạn không chỉ định travelmode, thì Google Maps sẽ hiển thị một hoặc nhiều chế độ phù hợp nhất cho tuyến đường đã chỉ định và/hoặc lựa chọn ưu tiên của người dùng.

Nhà phát triển cũng có thể chỉ định Mã địa điểm bằng cách sử dụng tham số origin_place_id và destination_place_id. Sử dụng Mã địa điểm là cách đảm bảo tốt nhất rằng bạn sẽ liên kết đến đúng địa điểm.

Truy xuất mã địa điểm mà không mất phí

Yêu cầu tìm kiếm văn bản bằng Places API(Chỉ mã nhận dạng):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Phản hồi của Places API Text Search(Chỉ mã nhận dạng):

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Đường đi từ vị trí hiện tại của người dùng

Tình huống 3: Cung cấp chỉ đường từng chặng

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

Việc đặt dir_action=navigate trong URL sẽ khởi chạy Google Maps ở chế độ chỉ đường từng chặng nếu vị trí hiện tại của người dùng(vị trí thiết bị) có sẵn và được dùng làm điểm bắt đầu (được cung cấp rõ ràng hoặc được dùng ngầm khi bạn bỏ qua tham số điểm bắt đầu). Nếu không, bản xem trước tuyến đường sẽ xuất hiện.

Chế độ điều hướng theo từng chặng sẽ được kích hoạt khi bạn đặt dir_action=navigate và:

Vị trí xuất phát được chỉ định và gần với vị trí hiện tại của người dùng
Nơi xuất phát bị bỏ qua và vị trí hiện tại của người dùng có sẵn

Bản xem trước tuyến đường sẽ xuất hiện khi:

dir_action=navigate chưa được đặt
dir_action=navigate được đặt và điểm bắt đầu được chỉ định, đồng thời điểm bắt đầu không gần với vị trí hiện tại của người dùng
dir_action=navigate được đặt và nguồn gốc bị bỏ qua, đồng thời người dùng không thể truy cập vào vị trí hiện tại

Xin lưu ý rằng tính năng chỉ đường không có trên một số sản phẩm của Google Maps, chẳng hạn như Google Maps trên web và/hoặc giữa một số điểm đến. Trong những trường hợp đó, tham số này sẽ bị bỏ qua.


Chỉ đường từng chặng	Xem trước tuyến đường

Lời kết

Bằng cách tạo đúng URL của Maps, bạn có thể đảm bảo người dùng nhận được thông tin họ cần một cách nhanh chóng và hiệu quả.

Luôn chỉ định đích đến và sử dụng Mã địa điểm bất cứ khi nào có thể để đảm bảo độ chính xác
Khi mục tiêu là cung cấp thông tin chỉ đường ngay lập tức, hãy thêm tham số dir_action=navigate để kích hoạt thông tin chỉ đường từng chặng. Chế độ chỉ đường sẽ bắt đầu từ vị trí hiện tại của người dùng nếu có thông tin vị trí thiết bị và được dùng làm điểm xuất phát (được đặt rõ ràng hoặc bị bỏ qua)

Chọn phương pháp phù hợp cho ứng dụng của bạn

Bạn có 2 lựa chọn chính: tận dụng các URL được định dạng sẵn do Places API cung cấp hoặc tự tạo URL của Maps trong ứng dụng. Mỗi phương pháp đều có những ưu điểm và nhược điểm riêng.

Places API:

Các trường googleMapsUri và googleMapsLinks trong phản hồi Chi tiết về địa điểm cung cấp các URL sẵn sàng sử dụng. Điều này giúp giảm thời gian phát triển và giảm thiểu nguy cơ xảy ra lỗi trong quá trình định dạng URL.
Ít kiểm soát hơn đối với cấu hình chỉ đường. Mặc dù googleMapsLinks cung cấp chỉ đường cơ bản, nhưng không hỗ trợ điểm tham chiếu hoặc tuỳ chỉnh nâng cao. Ngoài ra, việc kích hoạt trực tiếp chế độ chỉ đường từng chặng cũng tương đối phức tạp.

URL của Maps:

Mang lại sự linh hoạt và khả năng kiểm soát cao hơn. Nhà phát triển có thể tạo URL để hiển thị thông tin chi tiết về địa điểm và định cấu hình nhiều khía cạnh của chỉ đường, bao gồm cả việc thêm điểm tham chiếu, chỉ định phương thức di chuyển và bắt đầu chỉ đường từng chặng.
Bạn cần hiểu rõ hơn về các tham số và cấu trúc URL. Việc xây dựng theo cách thủ công sẽ làm tăng khả năng xảy ra lỗi nếu bạn không thực hiện cẩn thận.

Cải thiện URL trên Maps bằng tham số UTM

Để giúp Google hiểu rõ hơn về cách nhà phát triển tích hợp URL Maps và để đảm bảo hiệu suất tối ưu, bạn nên thêm các tham số theo dõi UTM vào cấu trúc URL của mình. Bằng cách thêm các tham số utm_source và utm_campaign, bạn cung cấp dữ liệu có giá trị giúp chúng tôi phân tích các mẫu sử dụng và cải thiện sản phẩm URL của Maps.

Đối với tham số utm_source, hãy sử dụng tên của ứng dụng. Tham số utm_campaign phải phản ánh hành động mà người dùng muốn thực hiện, chẳng hạn như "location_sharing", "place_details_search" hoặc "directions_request".

Ví dụ: URL có tham số UTM có thể trông như sau:

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

Việc sử dụng nhất quán các thông số này giúp chúng tôi xác định những khía cạnh cần cải thiện, khắc phục sự cố hiệu quả hơn và cuối cùng là mang đến trải nghiệm tốt hơn cho tất cả người dùng.

Các bước tiếp theo

Tài liệu đọc thêm được đề xuất:

Người đóng góp

Tác giả chính:

Teresa Qin | Kỹ sư giải pháp của Nền tảng Google Maps