Trong thế giới hiện đại, người dùng mong muốn có thể truy cập liền mạch vào thông tin địa điểm, thông tin chỉ đường và tính năng điều hướng. Cho dù là 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 vận chuyển và logistics, 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 nhanh chóng xem thông tin chi tiết về địa điểm 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 riêng trong ứng dụng, 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 rõ ràng là điều cần thiết để mang lại 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 chi tiết cụ thể hoặc thậm chí dẫn đến đường liên kết bị hỏng. Điều này khiến người dùng thất vọng và không đạt được mục tiêu. Ví dụ: ngay cả khi có URL Maps hợp lệ, người dùng mong muốn xem thông tin chi tiết về một doanh nghiệp cụ thể nhưng lại có thể chuyển đến một chế độ xem bản đồ chung 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 Maps này hợp lệ để mở Google Maps và hiển thị một vị trí dựa trên vĩ độ và kinh độ. Tuy nhiên, URL 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ể.
Kết nối liền mạch ứng dụng của bạn với Google Maps thông qua URL chính xác
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 trường hợp và tình huống sử dụng:
Sử dụng trường googleMapsUri hoặc googleMapsLinks của Places API(Mới) trên GMP
Places API(Mới) trên GMP trả về một tập hợp 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 mà bạn có thể dùng để mở trực tiếp
chế độ xem tương ứng, chẳng hạn như chế độ xem thông tin chi tiết về địa điểm trong Google Maps.
Ví dụ:
Yêu cầu Place Details
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 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 Sydney
Nhà hát Opera trong ví dụ trên. 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 Google Địa điểm và trên Google Maps.
Truy xuất Mã địa điểm miễ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: Tìm kiếm văn bản(Chỉ mã nhận dạng). Đây là phương thức miễn phí để lấy Mã địa điểm. Tìm hiểu thêm về Mã địa điểm và yêu cầu Places API(Mới).
Yêu cầu Places API: Tìm kiếm văn bản(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 Places API: Tìm kiếm văn bản(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 POI trên bản đồ. Tìm hiểu thêm thông tin chi tiết về các biểu tượng POI có thể nhấp(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 này để khởi 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ị thông tin chỉ đường 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 đến trang viết bài đánh giá cho địa điểm này |
| reviewsUri | Đường liên kết để mở Google Maps đến trang đánh giá cho địa điểm này |
| photosUri | Đường liên kết để mở Google Maps đến trang ảnh cho địa điểm này |
Hãy xem hướng dẫn dành cho nhà phát triển và dùng thử tính năng này ngay hôm nay.
Sử dụng URL Maps
Khi sử dụng URL Maps, bạn có thể tạo URL đa nền tảng, phổ biến để khởi chạy Google Maps và thực hiện tìm kiếm, nhận thông tin chỉ đường và tính năng điều hướ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 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 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 tìm kiếm chung và khởi chạy bản đồ để hiển thị kết quả.
Chức năng Đường đi 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ị thông tin chỉ đường giữa các điểm hoặc bật tính năng điều hướng từng chặng trên Google Maps cho thiết bị di động.
Chức năng toàn cảnh Ảnh toàn cảnh trong Chế độ xem đường phố cho phép bạn khởi chạy trình xem để hiển thị hình ảnh trong Chế độ xem đường phố dưới dạng ảnh toàn cảnh có thể tương tác.
Hãy truy cập tài liệu dành cho nhà phát triển về URL Maps trên GMP để khám phá thêm các chức năng và ví dụ.
Sau đây là 2 chức năng chính của URL 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 địa điểm cụ thể trên Google Maps. Phần này cũng trình bày chi tiết cách làm việc với các địa điểm có tên không phải là duy nhất bằng cách sử dụng Mã địa điểm và truy vấn chính xác.
Cung cấp thông tin chỉ đường bằng URL Maps: Phần này giải thích cách tạo URL cung cấp thông tin chỉ đường giữa các địa điểm, bao gồm cả thông tin chỉ đường có nhiều điểm tham chiếu và tính năng điều hướng từng chặng.
Hiển thị thông tin chi tiết về địa điểm trên Google Maps
Chức năng Tìm kiếm nhận 2 tham số để hoàn tất việc 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à bắt buộc đối với tất cả các yêu cầu tìm kiếm. Tham số 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 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¶meters
Trường hợp 1: Hiển thị thông tin chi tiết về địa điểm có tên duy nhất
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Bây giờ, hãy xem xét một địa điểm có tên không phải là duy nhất. Điều gì sẽ xảy ra khi bạn chỉ tìm kiếm theo tên không phải là 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 có tên không phải là 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ở danh sách các địa điểm 7-Eleven ở gần trong khung nhìn. Sau đó, người dùng có thể chọn một cửa hàng cụ thể để xem thông tin chi tiết về cửa hàng đó.
Để tránh danh sách địa điểm và truy cập trực tiếp vào một trang thông tin chi tiết cụ thể, bạn có thể sử dụng phương thức chính xác hơn. Xem ví dụ tiếp theo.
Trường hợp 3: Hiển thị thông tin chi tiết về địa điểm có tên không phải là duy nhất
Khi xử lý các tên địa điểm phổ biến, việc tìm kiếm theo tên đơn giản thường trả về danh sách địa điểm. Để liên kết trực tiếp đến một trang thông tin chi tiết cụ thể, bạn có thể sử dụng một trong các phương thức sau:
Phương thức 1: Sử dụng truy vấn chính xác có Tên địa điểm và Địa chỉ
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 địa điểm dự định.
Phương thức 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 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
địa điểm cụ thể. Tham số query vẫn là bắt buộc nhưng sẽ chỉ được sử 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 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
Truy xuất Mã địa điểm miễ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: Tìm kiếm văn bản(Chỉ mã nhận dạng). Đây là phương thức miễn phí để lấy Mã địa điểm. Tìm hiểu thêm về Mã địa điểm và yêu cầu Places API(Mới).
Yêu cầu Places API: Tìm kiếm văn bản(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 Places API: Tìm kiếm văn bản(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 POI trên bản đồ. Tìm hiểu thêm thông tin chi tiết về các biểu tượng POI có thể nhấp(JavaScript, Android, iOS)
Lời kết
Việc cung cấp thông tin chi tiết 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 chuyển đến đúng trang thông tin chi tiết về đị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, ADDRESSquery=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 thông tin chi tiết về địa điểm mong muốn. Thay vào đó, trang này sẽ hiển thị vĩ độ và kinh độ của
vị trí.
Tìm kiếm theo danh mục bằng URL Maps
Trong 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 cố gắng tìm các 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 không có vị trí nào được chỉ định, 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.
Trường hợp 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
Cung cấp thông tin chỉ đường bằng URL Maps
Chức năng Đường đi hiển thị đường đi giữa 2 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. Chức năng này giúp nhà phát triển kiểm soát tốt hơn thông tin chỉ đường được cung cấp. Tài liệu về Đường đi bằng URL Maps của GMP cung cấp hướng dẫn chi tiết về cách tạo URL cho thông tin chỉ đường tuỳ chỉnh.
Cấu trúc URL Đường đi:
https://www.google.com/maps/dir/?api=1¶meters
Trường hợp 1: Tìm tuyến đường tốt nhất từ vị trí hiện tại của người dùng đến một đích đế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ị thông tin 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 đi sẽ mặc định
là vị trí bắt đầu phù hợp nhất, chẳng hạn như vị trí thiết bị (nếu có).
Nếu không có vị trí nào, 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 bắt đầu.
Giá trị của điểm bắt đầu và đích đế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à tham số không bắt buộc. Tham số này xác định phương thức di chuyển.
Bạn có thể đặt tham 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 không có travelmode nào được chỉ định, 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 tuỳ chọ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 origin_place_id tham số và
destination_place_id. Việc sử dụng Mã địa điểm là cách tốt nhất để đảm bảo bạn sẽ
liên kết đến đúng địa điểm.
Truy xuất Mã địa điểm miễ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: Tìm kiếm văn bản(Chỉ mã nhận dạng). Đây là phương thức miễn phí để lấy Mã địa điểm. Tìm hiểu thêm về Mã địa điểm và yêu cầu Places API(Mới).
Yêu cầu Places API: Tìm kiếm văn bản(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 Places API: Tìm kiếm văn bản(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 POI trên bản đồ. Tìm hiểu thêm thông tin chi tiết về các biểu tượng POI có thể nhấp(JavaScript, Android, iOS)
Trường hợp 3: Cung cấp tính năng điều hướ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ế độ
điều hướ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
sử dụng làm điểm bắt đầu (được cung cấp rõ ràng hoặc được sử dụng ngầm khi tham số điểm bắt đầu
bị bỏ qua). Nếu không, hệ thống sẽ hiển thị bản xem trước tuyến đường.
Tính năng điều hướng từng chặng sẽ khởi chạy khi bạn đặt dir_action=navigate và:
- Điểm bắt đầu được chỉ định và ở gần vị trí hiện tại của người dùng
- Điểm bắt đầu 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ẽ khởi chạy khi:
dir_action=navigatekhông được đặtdir_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ị trí hiện tại của người dùngdir_action=navigateđược đặt và điểm bắt đầu bị bỏ qua, đồng thời vị trí hiện tại của người dùng không có sẵn
Xin lưu ý rằng tính năng điều hướng không có sẵn trên tất cả các sản phẩm của Google Maps, chẳng hạn như Google Maps trên web và/hoặc giữa tất cả các đích đến. Trong những trường hợp đó, tham số này sẽ bị bỏ qua.
 |
 |
Lời kết
Bằng cách tạo URL Maps chính xác, bạn có thể đảm bảo người dùng nhận được thông tin cần thiết 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 tính năng điều hướng ngay lập tức, hãy thêm tham số dir_action=navigate để kích hoạt tính năng điều hướng từng chặng. Tính năng điều hướng sẽ bắt đầu từ vị trí hiện tại của người dùng nếu vị trí thiết bị có sẵn và được sử dụng làm điểm bắt đầu (đượ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ạo URL Maps theo cách thủ công trong ứng dụng của bạn. 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
googleMapsUrivàgoogleMapsLinkstrong phản hồi Place Details 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 rủi ro xảy ra lỗi trong định dạng URL.Cung cấp ít quyền kiểm soát hơn đối với cấu hình thông tin chỉ đường. Mặc dù
googleMapsLinkscung cấp thông tin 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 tính năng điều hướng từng chặng trực tiếp cũng tương đối khó khăn hơn.
URL Maps:
Cung cấp tính 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 thông tin 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 tính năng điều hướng từng chặng.
Yêu cầu bạn phải hiểu rõ hơn về các tham số và cấu trúc URL. Việc tạo 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 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. Bằng cách thêm các tham số utm_source và utm_campaign, bạn sẽ
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 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 dự định của người dùng, 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 tham số này giúp chúng tôi xác định các lĩnh vực cần cải thiện, khắc phục sự cố hiệu quả hơn và cuối cùng là mang lại trải nghiệm tốt hơn cho tất cả người dùng.
Các bước tiếp theo
Đề xuất đọc thêm:
Người đóng góp
Tác giả chính:
Teresa Qin | Kỹ sư giải pháp Nền tảng Google Maps