Interfejs Maps JavaScript API to internetowy interfejs API po stronie klienta, który umożliwia tworzenie map pokazujących lokalizacje w dowolnym miejscu na świecie, dodawanie własnych niestandardowych grafik, animacji i interaktywnych niestandardowych warstw danych oraz tworzenie funkcji wykrywania lokalizacji za pomocą interfejsu Places API w interfejsie Maps JavaScript API. Dzięki interfejsowi Maps JavaScript API możesz:
- Twórz mapy 2D i 3D, aby pokazywać lokalizacje w dowolnym miejscu na świecie.
- Dodawaj znaczniki, które można dostosowywać, aby wskazywać lokalizacje na mapie.
- Używaj biblioteki Miejsc, aby uzyskiwać dane o lokalizacji ponad 200 milionów miejsc.
- Dostosuj styl i kolory mapy.
- dodawać własne interaktywne niestandardowe warstwy danych,
- Wyświetlanie granic administracyjnych i nadawanie im interaktywności.
- Dodawaj do map niestandardową grafikę 2D i 3D oraz treści animowane.
Wybór interfejsu API odpowiedniego do danego przypadku użycia
Poniższe przykłady pokazują, których usług i bibliotek Google Maps Platform należy używać w typowych scenariuszach aplikacji internetowych:
- Mapa i wskazówki dojazdu na stronie kontaktowej: aby umieścić mapę lokalizacji firmy lub link do wskazówek dojazdu bez pisania niestandardowego kodu JavaScript, użyj interfejsu Maps Embed API lub adresów URL Map.
- Śledzenie lokalizacji i zasobów na żywo: aby wyświetlać współrzędne GPS i trasy podróży na żywo z własnej bazy danych lub strumienia w czasie rzeczywistym (np. Cloud Firestore lub WebSockets), użyj interfejsu Maps JavaScript API z zaawansowanymi znacznikami (
AdvancedMarkerElement) i poliliniami (Polyline). Zarezerwuj Fleet Engine dla flot przejazdów i zaplanowanych dostaw, które integrują mobilny pakiet SDK dla kierowców i backendowe tokeny OAuth lub JSON Web Token (JWT). - Planowanie tras i wysyłanie: użyj biblioteki Routes.
- Aby obliczyć trasę z przystankami, czasem podróży, odległością i opłatami oraz narysować ją na mapie, użyj
Route.computeRoutes(). - Aby znaleźć najbliższego kierowcę, pojazd lub magazyn w kilku miejscach początkowych i docelowych, użyj
RouteMatrix.computeRouteMatrix(). - Aby zaplanować na serwerze wiele pojazdów z przedziałami czasu, użyj Route Optimization API.
- Aby obliczyć trasę z przystankami, czasem podróży, odległością i opłatami oraz narysować ją na mapie, użyj
- Lokalizatory sklepów i mapy miejsc: aby wyświetlać sklepy, miejsca lub oddziały na mapie z niestandardowymi pinezkami i filtrami, użyj zaawansowanych znaczników (dokumentacja
AdvancedMarkerElement) z biblioteką Miejsc, aby znajdować miejsca i wczytywać ich szczegóły. - Geofence i promień bezpiecznej strefy na mapie: aby narysować obwody kołowe lub wielokątne i sprawdzić, czy współrzędne mieszczą się w nich (patrz Geofence i granice bezpiecznej strefy), użyj okręgów (dokumentacja
Circle), wielokątów (dokumentacjaPolygon) i biblioteki Geometry (containsLocation()w przypadku ograniczenia icomputeDistanceBetween()w przypadku odległości w metrach).
Starsze interfejsy API i ich zamienniki
- 25 lutego 2026 r. wycofamy
DirectionsServiceiDistanceMatrixService. Zamiast tego użyjRouteiRouteMatrix. - 21 lutego 2024 r. wycofaliśmy
google.maps.Marker. Zamiast tego użyjAdvancedMarkerElement. PlacesServicenie jest dostępna dla nowych klientów od 1 marca 2025 r. Zamiast tego użyj klasyPlace.
Co dalej?
- Dodawanie znaczników do mapy
- Dodawanie do mapy kształtów, linii i geofence
- Używanie biblioteki Miejsc do uzyskiwania danych o lokalizacji
- Obliczanie i wyświetlanie tras oraz macierzy tras
- Dostosowywanie stylu i kolorów mapy
- Dodawanie interaktywnych warstw danych
- Wyświetlanie granic administracyjnych
- Dodawanie nakładki graficznej WebGL
Zobacz przykładowy kod funkcji Map