Maps Embed API umieszcza interaktywną mapę lub panoramę Street View na stronie internetowej za pomocą żądania HTTP ustawionego jako adres URL elementu iframe src, bez konieczności używania JavaScriptu. Obsługuje tryby mapy place, view, directions, streetview i search.
Maps Embed API: najważniejsze informacje
- Usługa: Maps Embed API
- Inne nazwy: Google Maps Embed API, Maps Embed
- Kategoria: Mapy
- Platforma: JavaScript (przeglądarka)
- Działa na: kliencie (kod aplikacji lub przeglądarki)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: omówienie interfejsu Maps Embed API
- Dostępność: cały świat. Tryb Street View zależy od zasięgu Street View. Parametr
regionakceptuje regiony wymienione na stronie z informacjami o zasięgu Maps Platform. (szczegóły dotyczące zakresu ochrony)
Maps Embed API: kiedy używać
Używaj Maps Embed API, gdy:
- Potrzebujesz interaktywnej mapy lub panoramy Street View na stronie internetowej, która używa tylko elementu iframe HTML, bez JavaScriptu.
- Musisz wyświetlić pinezkę miejsca, widok mapy, wskazówki dojazdu między punktami lub wyniki wyszukiwania dla obszaru na umieszczonej mapie.
- Potrzebujesz mapy umieszczonej na stronie bez opłat za żądanie i bez limitów QPS lub dziennych żądań (klucz interfejsu API jest nadal wymagany).
Nie używaj Maps Embed API, gdy:
- Musisz dostosować mapę internetową, dodając własne treści i obrazy. Zamiast tego użyj Maps JavaScript API.
- Chcesz rozszerzyć wbudowaną mapę o funkcje automatyzacji wykraczające poza parametry adresu URL elementu iframe. Zamiast tego użyj Maps JavaScript API.
Maps Embed API: konfiguracja
- Usługa do włączenia:
maps-embed-backend.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Pierwsze kroki: skonfiguruj Maps Embed API
- Dokumentacja: dokumentacja Maps Embed API
- Ceny: korzystanie z Maps Embed API i płatności
Maps Embed API: typowe błędy
- Problem: jeśli strona hosta ustawia metatag
referrernano-referrerlubsame-origin, przeglądarka nie wysyła nagłówkaReferer, a klucz interfejsu API z ograniczeniem HTTP-referrer może odrzucać żądania umieszczenia. Rozwiązanie: dodajreferrerpolicy="strict-origin-when-cross-origin"do elementu iframe, aby domena witryny była wysyłana do Google. See /maps/documentation/embed/embedding-map. - Problem: mapy umieszczone na stronie nie są obsługiwane, jeśli ich wymiary są mniejsze niż 200 pikseli. Rozwiązanie: ustaw atrybuty
widthiheightelementu iframe na co najmniej 200 pikseli. Zobacz /maps/documentation/embed/embedding-map. - Problem: mimo że korzystanie z usługi jest bezpłatne, jeśli płatności nie są włączone, forma płatności jest nieprawidłowa, został przekroczony samodzielnie nałożony limit dzienny lub w żądaniu brakuje nagłówka HTTP referer, gdy używany jest klucz z ograniczeniem do nagłówka referer, pojawia się przyciemniona mapa ze znakiem wodnym „for development purposes only” (tylko do celów programistycznych). Rozwiązanie: włącz płatności w projekcie, podając prawidłową formę płatności, zwiększ lub usuń samodzielnie nałożony dzienny limit i upewnij się, że odsyłacz jest wysyłany w przypadku kluczy z ograniczeniem odsyłacza (np. z
referrerpolicy="strict-origin-when-cross-origin"w elemencie iframe). See /maps/documentation/embed/error-messages. - Problem: w przypadku nieprawidłowych żądań (nieprawidłowe lub brakujące parametry oraz błędy klucza interfejsu API i limitu, takie jak brakujący lub nieprawidłowy klucz, niewłączony interfejs Maps Embed API lub naruszenie ograniczenia klucza) w konsoli przeglądarki jest zgłaszany tylko kod stanu HTTP 4xx, a nie komunikat opisowy. Tekst błędu pojawia się w elemencie iframe zamiast mapy. Rozwiązanie: przeczytaj tekst błędu w elemencie iframe i kod stanu konsoli (400 w przypadku błędów parametrów, 401 w przypadku braku klucza, 403 w przypadku nieprawidłowego klucza), a następnie sprawdź, czy parametry i klucz są prawidłowe, czy interfejs Maps Embed API jest włączony i czy ograniczenia klucza zezwalają na żądanie. See /maps/documentation/embed/error-messages.
Co możesz zrobić za pomocą Maps Embed API
Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.