Tài liệu tham khảo nhanh về URL của Maps

URL của Maps cho phép bạn tạo một URL chung, nhiều nền tảng để chạy Google Maps nhằm thực hiện tìm kiếm, xem đường đi và thông tin chỉ đường, hiển thị chế độ xem bản đồ, tạo danh sách rút gọn các địa điểm hoặc hiển thị Ảnh toàn cảnh trong Chế độ xem đường phố. Cú pháp URL giống nhau trên mọi nền tảng và không cần khoá API.

URL của Maps: thông tin chính

  • Sản phẩm: URL của Maps
  • Còn được gọi là: URL của Google Maps
  • Danh mục: Maps
  • Nền tảng: Lược đồ URL
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về URL của Maps

URL của Maps: trường hợp sử dụng

Sử dụng URL của Maps khi:

  • Bạn cần có một đường liên kết từ ứng dụng Android, ứng dụng iOS hoặc trang web của mình để mở Google Maps nhằm tìm kiếm một địa điểm hoặc hiển thị kết quả tìm kiếm.
  • Bạn cần mở Google Maps có đường đi giữa các điểm, có thể có điểm tham chiếu, phương tiện di chuyển hoặc đường đi từng chặng.
  • Bạn cần mở Google Maps ở chế độ xem bản đồ, danh sách rút gọn các địa điểm hoặc ảnh toàn cảnh trong Chế độ xem đường phố mà không cần dùng khoá API.
  • Bạn cần một cú pháp URL hoạt động giống nhau trên Android, iOS và trình duyệt dành cho máy tính.

Không sử dụng URL của Maps khi:

  • Bạn đã yêu cầu Place Details và muốn có đường liên kết đến Google Maps được định dạng sẵn cho một địa điểm (trường googleMapsUri hoặc googleMapsLinks). Hãy sử dụng Places API (Mới).
  • Bạn cần có các tính năng chỉ dành cho thiết bị di động khi chạy ứng dụng Google Maps; hãy sử dụng Ý định của Google Maps cho Android hoặc Lược đồ URL của Google Maps cho iOS.

URL của Maps: thiết lập

  • Phân bổ mức sử dụng: Thêm các tham số truy vấn không bắt buộc utm_source (tên ứng dụng của bạn) và utm_campaign (hành động dự kiến của người dùng, ví dụ: place_details_search) vào URL của Maps.
  • Bắt đầu: Thiết lập URL của Maps

URL của Maps: lỗi thường gặp

  • Vấn đề: Một URL tìm kiếm chỉ có vĩ độ/kinh độ trong query cho thấy một ghim nhưng không có thông tin chi tiết về địa điểm trong bản đồ hoặc bảng điều khiển bên. Cách khắc phục: Sử dụng query=PLACE_NAME,ADDRESS hoặc thêm query_place_id cùng với query để cho biết thông tin chi tiết về địa điểm cụ thể. Xem /maps/documentation/urls/get-started.
  • Vấn đề: Các tham số Mã địa điểm (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) không hoạt động riêng lẻ. Cách khắc phục: Luôn thêm tham số cơ sở phù hợp (query, origin, destination hoặc waypoints) khi bạn truyền tham số mã địa điểm. Xem /maps/documentation/urls/get-started.
  • Vấn đề: Tham số waypoints bị bỏ qua trên các sản phẩm của Google Maps không hỗ trợ điểm tham chiếu và có giới hạn số lượng phụ thuộc vào nền tảng, còn dir_action=navigate bị bỏ qua khi không có tính năng chỉ đường. Cách khắc phục: Sử dụng tối đa 3 điểm tham chiếu cho các đường liên kết mở trong trình duyệt di động (tối đa 9 điểm tham chiếu cho các trường hợp khác) và không phụ thuộc vào việc waypoints hoặc dir_action=navigate hoạt động trên mọi sản phẩm hoặc tuyến đường của Google Maps. Xem /maps/documentation/urls/get-started#directions-action.
  • Vấn đề: Maps và Chế độ xem đường phố có cùng một điểm cuối @, vì vậy, URL bản đồ không có hành động phù hợp có thể không hiển thị bản đồ. Cách khắc phục: Đặt map_action=map cho chế độ xem bản đồ và map_action=pano cho ảnh toàn cảnh trong Chế độ xem đường phố. Xem /maps/documentation/urls/get-started.
  • Vấn đề: Nếu thiếu api=1 trong URL của Maps, thì tất cả tham số sẽ bị bỏ qua và Google Maps sẽ mở chế độ xem mặc định. Cách khắc phục: Thêm api=1 vào mọi URL của Maps (1 là giá trị hợp lệ duy nhất). Xem /maps/documentation/urls/get-started#forming-the-url.