Chuyển tới nội dung chính
Phiên bản: v1.1

Embed Place

API Embed Place GTEL MAPS cho phép nhúng bản đồ hiển thị một địa điểm cụ thể vào trang web hoặc ứng dụng của bạn thông qua iframe. Phiên bản hỗ trợ nhiều tùy chọn tùy chỉnh như camera controls và card hiển thị.

Embed Place​

Loading...

Tham số yêu cầu​

Tham sốKiểu dữ liệuMô tả
idstringBắt buộc. ID của địa điểm cần hiển thị. Ví dụ: gm:poi:0481c468-e1f0-4d7d-ada3-222f7ce53557

Tham số tùy chọn​

Tham sốKiểu dữ liệuMô tả
zoomnumberMức zoom của bản đồ (1 - 17). Mặc định: 16.
bearingnumberGóc xoay bản đồ theo độ (-180° - 180°). Mặc định: 0.
pitchnumberGóc nghiêng bản đồ theo độ (0° - 85°). Mặc định: 0.
show-cardbooleanHiển thị thông tin card cho địa điểm. Mặc định: false. Giá trị: true, false

Ví dụ sử dụng​

Hiển thị địa điểm cơ bản​

Hiển thị địa điểm với zoom mặc định
<iframe
src="{{API_BASE_URL}}/embed/place?id=gm:poi:0481c468-e1f0-4d7d-ada3-222f7ce53557"
width="600"
height="400"
style="border:0;"
allowfullscreen=""
loading="lazy"
referrerpolicy="no-referrer-when-downgrade"
></iframe>

Hiển thị địa điểm với zoom tùy chỉnh​

Hiển thị địa điểm với zoom 1
<iframe
src="{{API_BASE_URL}}/embed/place?id=gm:poi:0481c468-e1f0-4d7d-ada3-222f7ce53557&zoom=1"
width="600"
height="400"
style="border:0;"
allowfullscreen=""
loading="lazy"
referrerpolicy="no-referrer-when-downgrade"
></iframe>

Hiển thị địa điểm 3D với bearing và pitch​

Hiển thị địa điểm 3D nghiêng 45 độ, xoay 90 độ
<iframe
src="{{API_BASE_URL}}/embed/place?id=gm:poi:0481c468-e1f0-4d7d-ada3-222f7ce53557&zoom=17&bearing=90&pitch=45"
width="600"
height="400"
style="border:0;"
allowfullscreen=""
loading="lazy"
referrerpolicy="no-referrer-when-downgrade"
></iframe>

Hiển thị địa điểm có card​

Hiển thị địa điểm mà không hiển thị card thông tin
<iframe
src="{{API_BASE_URL}}/embed/place?id=gm:poi:0481c468-e1f0-4d7d-ada3-222f7ce53557&show-card=true"
width="600"
height="400"
style="border:0;"
allowfullscreen=""
loading="lazy"
referrerpolicy="no-referrer-when-downgrade"
></iframe>

Lưu ý quan trọng​

  • Góc bearing tính từ hướng Bắc (0°) theo chiều kim đồng hồ.
  • Góc pitch tối đa là 85° để đảm bảo trải nghiệm tốt nhất.
  • Tham số show-card mặc định là false, không hiển thị thông tin chi tiết của địa điểm.

Lưu ý về Place ID​

Place ID có thể được lấy từ các API khác của GTEL MAPS như:

Demo Tương Tác​

Loading embed demo...