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ệu | Mô tả |
|---|---|---|
id | string | Bắ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ệu | Mô tả |
|---|---|---|
zoom | number | Mức zoom của bản đồ (1 - 17). Mặc định: 16. |
bearing | number | Góc xoay bản đồ theo độ (-180° - 180°). Mặc định: 0. |
pitch | number | Góc nghiêng bản đồ theo độ (0° - 85°). Mặc định: 0. |
show-card | boolean | Hiể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
bearingtính từ hướng Bắc (0°) theo chiều kim đồng hồ. - Góc
pitchtối đa là 85° để đảm bảo trải nghiệm tốt nhất. - Tham số
show-cardmặ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...