Krótkie omówienie interfejsu Maps Embed API

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 region akceptuje 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

Maps Embed API: typowe błędy

  • Problem: jeśli strona hosta ustawia metatag referrer na no-referrer lub same-origin, przeglądarka nie wysyła nagłówka Referer, a klucz interfejsu API z ograniczeniem HTTP-referrer może odrzucać żądania umieszczenia. Rozwiązanie: dodaj referrerpolicy="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 width i height elementu 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.

Maps Embed API: wskazówki dojazdu i wyznaczanie trasy

Maps Embed API: Mapy

Maps Embed API: Places

Maps Embed API: Street View