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 ngày nay, nơi có khả năng nhận biết vị trí, người dùng mong muốn có thể truy cập liền mạch vào thông tin vị trí, chỉ đường và đ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 cục bộ, nền tảng vận tải và hậu cần, trình lập kế hoạch du lịch hay nền tảng đăng thô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ề vị trí hoặc tìm tuyến đường tốt 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 hợp lý là yếu tố 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ẽ làm giảm trải nghiệm này, đưa người dùng đến sai vị trí, hiển thị chế độ xem bản đồ chung chung thay vì thông tin chi tiết 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 thất vọng và không đạt được mục tiêu của họ. Ví dụ: ngay cả khi có URL Maps hợp lệ, người dùng muốn xem thông tin chi tiết về một doanh nghiệp cụ thể có thể được chuyển đến 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, API 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 các URL chính xác

Nền tảng Google Maps (GMP) cung cấp hai phương thức chính để tạo URL chính xác: API Địa điểm(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 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 đó 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 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 dạ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 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: Tìm kiếm bằng văn bản(chỉ mã). Đâ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 bằng văn bản của API Địa điểm(chỉ mã địa điểm):

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 API Tìm kiếm bằng văn bản của địa điểm(chỉ có 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 địa điểm yêu thích có thể nhấp vào(JavaScript, Android, iOS)

Triển khai

Khi sử dụng API Địa điểm, 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 thành phần hiển thị tương ứng trong ứng dụng Google Maps hoặc trong trình duyệt nếu chưa cài đặt ứng dụng.

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 của Maps

Khi sử dụng URL của Maps, bạn có thể tạo một URL phổ biến, đa nền tảng để khởi chạy Google Maps và thực hiện các thao tác tìm kiếm, xem đườ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 trên bản đồ có sẵn bao gồm:

• Hàm Tìm kiếm sẽ chạy ứng dụng Google Maps hoặc trong trình duyệt nếu bạn chưa cài đặt ứng dụng này. Hàm 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 lượt tìm kiếm chung và chạy bản đồ để hiển thị kết quả.

• Hàm Đường đi sẽ chạy ứng dụng Google Maps hoặc trong trình duyệt nếu bạn chưa cài đặt ứng dụng hiển thị đường đi giữa các điểm hoặc bật tính năng 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.

Truy cập vào tài liệu dành cho nhà phát triển về URL của Google Maps để khám phá thêm các hàm và ví dụ.

Sau đây là hai 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 về 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 xử lý các địa điểm có tên không duy nhất bằng cách sử dụng Mã địa điểm và cụm từ tìm kiếm chính xác.

• Cung cấp đường đi bằng URL của Maps: Phần này giải thích cách tạo URL cung cấp đường đi giữa các vị trí, bao gồm cả đường đi có nhiều điểm trung gian và đường đi 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 hai 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. Phương thức 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

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

Tình huống 2: Tìm kiếm địa điểm theo tên địa điểm không 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 danh sách các vị trí 7-Eleven lân cậ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.

Để 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 thức chính xác hơn. Xem ví dụ tiếp theo.

Tình huống 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ý các tên địa điểm phổ biến, một lượt tìm kiếm tên đơ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 những phương thức sau:

Phương thức 1: Sử dụng cụm từ tìm kiếm 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 vị trí 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 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

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

Tình huống 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 giúp đả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 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: Tìm kiếm bằng văn bản(chỉ mã). Đâ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 bằng văn bản của API Địa điểm(chỉ mã địa điểm):

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 API Tìm kiếm bằng văn bản của địa điểm(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 địa điểm yêu thích có thể nhấp vào(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à yếu tố quan trọng để mang đến trải nghiệm tích cực. Để đảm bảo người dùng truy cập vào đúng trang 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, 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 địa điểm mong muốn. Thay vào đó, bạn sẽ thấy 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

Cung cấp đường đi bằng URL của Maps

Hàm Đường đi hiển thị đường dẫn giữa hai hoặc nhiều điểm đã chỉ định trên bản đồ, cũng như khoảng cách và thời gian di chuyển. API 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 hướng dẫn được cung cấp. Tài liệu Hướng dẫn về URL của Maps trong GMP cung cấp hướng dẫn chi tiết về cách tạo URL cho đường đi tuỳ chỉnh.

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

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

Tình huống 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 đ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ị đường đi bằng ô tô từ vị trí hiện tại của người dùng.

Trong URL này, origin bị bỏ qua. Khi bạn bỏ qua origin, đườ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í thiết bị (nếu có). Nếu không có, bản đồ thu được sẽ cung cấp một biểu mẫu để cho phép người dùng nhập thông tin về đ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 tọa độ vĩ độ/kinh độ được phân tách bằng dấu phẩy.

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

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

Nếu không chỉ định chế độ đi lại, Google Maps sẽ hiển thị một hoặc nhiều chế độ phù hợp nhất với 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 thông số origin_place_id 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 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: Tìm kiếm bằng văn bản(chỉ mã). Đâ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(New).

Yêu cầu Tìm kiếm bằng văn bản của API Địa điểm(chỉ mã địa điểm):

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 API Tìm kiếm bằng văn bản của địa điểm(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 địa điểm yêu thích có thể nhấp vào(JavaScript, Android, iOS)

Tình huống 3: Cung cấp thông tin 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 xuất phát (được cung cấp rõ ràng hoặc được sử dụng ngầm khi bỏ qua tham số điểm xuất phát). Nếu không, bản xem trước tuyến đường sẽ xuất hiện.

Tính năng chỉ đường từng chặng sẽ được khởi chạy 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
• Nguồn gốc 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ẽ chạy khi:

• dir_action=navigate chưa được đặt
• dir_action=navigate được đặt và nguồn gốc được chỉ định, đồng thời nguồn gốc không gần 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 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 chỉ đường không có trên tất cả các sản phẩm của Google Maps, chẳng hạn như Google Maps Web và/hoặc giữa tất cả các điểm đế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 chính xác URL Maps, bạn có thể đảm bảo người dùng nhận được thông tin phù hợp mà 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 điều hướng tức thì, hãy thêm tham số dir_action=navigate để kích hoạt thông tin chỉ đường từng chặng. Tính năng 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ó hai lựa chọn chính: tận dụng các URL được định dạng sẵn do API Địa điểm cung cấp hoặc tạo URL Maps theo cách thủ công 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 đị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 việc định dạng URL.

• Có ít quyền kiểm soát hơn đối với cấu hình của đường đi. Mặc dù cung cấp thông tin chỉ đường cơ bản, nhưng googleMapsLinks không hỗ trợ điểm trung gian hoặc tuỳ chỉnh nâng cao. Ngoài ra, việc kích hoạt tính năng chỉ đường từng chặng một cách trực tiếp sẽ tương đối khó khăn hơn.

URL của Maps:

• Mang lại nhiều quyền kiểm soát và tính linh hoạt 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 đường đi, bao gồm cả việc thêm điểm trung gian, chỉ định phương thức di chuyển và bắt đầu chỉ đường từng chặng.

• Yêu cầu bạn hiểu rõ hơn về cấu trúc và thông số URL. Việc tạo thủ công sẽ làm tăng khả năng xảy ra lỗi nếu không được 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 của Maps và đảm bảo hiệu suất tối ưu, bạn nên thêm các thông 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 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 ứng dụng của bạn. Tham số utm_campaign phải phản ánh hành động mà người dùng dự định 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ể có dạ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 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

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

• URL của Maps
• Mã địa điểm
• API Địa điểm – Liên kết đến Google Maps
• Routes API

Người đóng góp

Tác giả chính:

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