Zasady i atrybucje dotyczące interfejsu Maps JavaScript API

Ten dokument zawiera listę wymagań dotyczących aplikacji opracowanych za pomocą interfejsu Maps JavaScript API. Pamiętaj, że korzystanie z interfejsu Maps JavaScript API podlega Twojej umowie z Google.

Zasady

W tej sekcji opisujemy zasady dotyczące interfejsu Maps JavaScript API. Zasady zawierają praktyczne wytyczne i wymagania dotyczące implementacji, które pomagają prawidłowo korzystać z usługi zgodnie z oczekiwaniami Google Maps Platform.

Wyjątki od ograniczeń dotyczących buforowania

Pamiętaj, że identyfikator miejsca, który służy do jednoznacznego identyfikowania miejsca, nie podlega ograniczeniom dotyczącym buforowania. Dlatego możesz przechowywać wartości identyfikatorów miejsc przez nieograniczony czas. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu API. Więcej informacji o zapisywaniu, odświeżaniu i zarządzaniu identyfikatorami miejsc znajdziesz w przewodniku Identyfikatory miejsc.

Scraping treści

Nazwa miejsca może zostać zwrócona na podstawie interakcji użytkownika z Twoją aplikacją. Jeśli zapiszesz lub zachowasz nazwę miejsca do wykorzystania w innym kontekście poza sesją użytkownika, będzie to stanowić scraping, który jest niezgodny z naszymi warunkami.

Kraje i terytoria Europejskiego Obszaru Gospodarczego

W przypadku klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG), obowiązują inne warunki korzystania z usługi. Usługa może też mieć inne funkcje. Zanim zaczniesz korzystać z Google Maps Platform, zapoznaj się z tymi warunkami i informacjami dotyczącymi EOG:

• Warunki korzystania z usługi Google Maps Platform w EOG
• Szczegółowe warunki korzystania z usługi Google Maps Platform w EOG
• Najczęstsze pytania dotyczące EOG
• Wymagania Google Maps Platform dotyczące bezpieczeństwa na drodze

Jeśli Twój adres rozliczeniowy nie znajduje się w EOG, obowiązują Cię te warunki korzystania z usługi:

• Warunki korzystania z usługi Google Maps Platform
• Szczegółowe warunki korzystania z usługi Google Maps Platform

Wymagania dotyczące podania źródła w Mapach Google

W tej sekcji znajdziesz wymagania i wytyczne dotyczące podawania źródła podczas wyświetlania Map Google i treści w aplikacjach.

Przykład podawania źródła

Poniżej znajdziesz przykład podawania źródła w przypadku Places UI Kit.

Wyświetlanie podawania źródła Map Google

Podczas wyświetlania treści z interfejsów Google Maps Platform API w aplikacji lub witrynie musisz przestrzegać wymagań dotyczących podawania źródła Map Google. Jeśli treści są wyświetlane na mapie Google, na której podawanie źródła jest już widoczne, nie musisz dodawać dodatkowego podawania źródła.

Podawanie źródła Map Google

W przypadku podawania źródła Map Google, które jest już udostępniane przez Google Maps Platform w interfejsie użytkownika, np. w Places UI Kit:

• Nie usuwaj podawania źródła, niezależnie od tego, gdzie jest wyświetlane. Nie zmieniaj, nie ukrywaj ani nie zasłaniaj podawania źródła. Upewnij się, że jest ono wyraźnie widoczne na tle.
• Zawsze wizualnie odróżniaj treści Google Maps Platform od innych treści, używając wskazówek interfejsu, takich jak obramowanie, kolor tła, cień lub wystarczająca ilość białych znaków.
• Podczas wprowadzania zmian wizualnych musisz przestrzegać wszystkich wymagań dotyczących podawania źródła Map Google.

Logo Map Google i podawanie źródła w postaci tekstu

Jeśli to możliwe, podawanie źródła powinno mieć postać logo Map Google. W przypadkach, gdy ilość miejsca jest ograniczona, dopuszczalny jest tekst Mapy Google. Użytkownicy muszą zawsze wiedzieć, które treści pochodzą z Map Google.

Podawanie źródła w postaci logo

Pobieranie logo Map Google

Używaj oficjalnych plików logo Map Google. Pobierz logo poniżej i postępuj zgodnie z wytycznymi w tej sekcji.

Podczas używania logo Map Google postępuj zgodnie z tymi wytycznymi.

• Nie modyfikuj logo w żaden sposób.
• Zachowaj proporcje logo, aby uniknąć zniekształcenia.
• Używaj logo z obrysem na tle z wieloma elementami, np. na mapie lub obrazie.
• Używaj logo bez obrysu na prostym tle, np. na jednolitym kolorze lub subtelnym gradiencie.

Specyfikacja rozmiaru logo

• Minimalna wysokość logo: 16 dp
• Maksymalna wysokość logo: 19 dp
• Minimalny obszar wokół logo: 10 dp z lewej, prawej i górnej strony, 5 dp z dołu

Więcej informacji o dp znajdziesz na stronie Gęstość pikseli w witrynie Material Design.

Ułatwienia dostępu do logo

• Zachowaj kontrast między logo a tłem, który jest zgodny z zasadami ułatwień dostępu.
• Dodaj etykietę ułatwień dostępu z tekstem Mapy Google.

Podawanie źródła w postaci tekstu

Jeśli rozmiar interfejsu nie pozwala na użycie logo Map Google, możesz wpisać Mapy Google w postaci tekstu. Postępuj zgodnie z tymi wytycznymi:

• Nie modyfikuj tekstu Mapy Google w żaden sposób:
  
  • Nie zmieniaj wielkości liter w tekście Mapy Google.
  • Nie dziel tekstu Mapy Google na kilka wierszy.
  • Nie tłumacz tekstu Mapy Google na inny język.
  • Uniemożliwiaj przeglądarkom tłumaczenie tekstu Mapy Google za pomocą atrybutu HTML translate="no".

• Stylizuj tekst „Mapy Google” zgodnie z tabelą poniżej:

  Wymagania dotyczące stylizowania tekstu „Mapy Google”
  Właściwość	Styl
  Rodzina czcionek	Roboto. Wczytywanie czcionki jest opcjonalne.
  Zapasowa rodzina czcionek	Dowolna czcionka bezszeryfowa używana już w Twojej usłudze lub „Sans-Serif”, aby użyć domyślnej czcionki systemowej.
  Styl czcionki	Normalna
  Grubość czcionki	400
  Kolor czcionki	Biały, czarny (#1F1F1F) lub szary (#5E5E5E). Zachowaj kontrast z tłem, który jest zgodny z zasadami ułatwień dostępu (4,5:1).
  Rozmiar czcionki	Minimalny rozmiar czcionki: 12 sp Maksymalny rozmiar czcionki: 16 sp Więcej informacji o sp znajdziesz na stronie Jednostki rozmiaru czcionki w witrynie Material Design.
  Odstępy między literami	Normalne

Przykładowy kod CSS

Poniższy kod CSS renderuje Mapy Google z odpowiednim stylem typograficznym i kolorem na białym lub jasnym tle.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

Wymagania wizualne

• Umieść podawanie źródła u góry lub u dołu treści w tym samym kontenerze wizualnym. W przypadku jednego wiersza treści podawanie źródła można umieścić po prawej lub lewej stronie.

• Wizualnie odróżniaj treści Google Maps Platform od innych treści, używając wskazówek interfejsu, takich jak obramowanie, kolor tła, cień lub wystarczająca ilość białych znaków.

• Nie wprowadzaj w błąd użytkowników co do pochodzenia treści, przypisując treściom innym niż Google Maps Platform podawanie źródła Map Google.
• Sprawdź, czy podawanie źródła jest zawsze widoczne i czytelne. Nigdy go nie usuwaj, nie ukrywaj, nie zasłaniaj ani nie modyfikuj.

Na ilustracjach poniżej znajdziesz przykłady spełnienia tych wymagań wizualnych.

Zewnętrzni dostawcy danych

Niektóre dane i obrazy w naszych usługach mapowych pochodzą od dostawców innych niż Google. W przypadku niektórych usług, np. Map Tiles API, możemy udostępnić Ci wymagane podawanie źródła zewnętrznego dostawcy danych. W takim przypadku tekst podawania źródła musi zawierać nazwę „Mapy Google” i nazwę odpowiedniego dostawcy lub dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Jeśli Google udostępnia podawanie źródła zewnętrznego, podawanie źródła zawierające tylko "Mapy Google" lub logo Google jest nie prawidłowe.

Inne wymagania dotyczące podawania źródła

Aby pobrać podawanie źródła zewnętrznego i wyświetlić je w aplikacji, postępuj zgodnie z tymi instrukcjami.

Pobieranie podawania źródła z miejsca

Jeśli Twoja aplikacja wyświetla informacje o opiniach uzyskane przez wywołanie Place.fetchFields, musi też wyświetlać podawanie źródła zewnętrznego w przypadku uzyskanych informacji o miejscu.

Interfejs API zwraca Place obiekt. Aby pobrać podawanie źródła z obiektu Place, użyj właściwości Place.attributions, która jest zwracana z każdym żądaniem (nie trzeba jej określać za pomocą pól). Właściwość zwraca List obiektów String lub null, jeśli nie ma podawania źródła do wyświetlenia. Poniższy przykładowy kod pokazuje, jak uzyskać miejsce i wyświetlić podawanie źródła.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Wyświetlanie opinii

Obiekt Place może zawierać maksymalnie 5 opinii, z których każda jest reprezentowana przez obiekt Review. Możesz opcjonalnie wyświetlać te opinie w swojej aplikacji.

Podczas wyświetlania opinii dodanych przez użytkowników Google musisz umieścić nazwę autora w pobliżu opinii. Jeśli jest ona dostępna w polu podawania źródła autora obiektu Review, zalecamy też dodanie zdjęcia autora i linku do jego profilu. Na ilustracji poniżej znajdziesz przykład opinii o parku:

Poniższy przykład pokazuje, jak uzyskać miejsce, sprawdzić, czy są dostępne opinie, i wyświetlić dane z pierwszej opinii:

  // Use place ID to create a new Place instance.
  const place = new Place({
    id: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA
  });

  // Call fetchFields, passing "reviews" and other needed fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }
  

Więcej informacji znajdziesz w dokumentacji opinii o miejscach.

Wyświetlanie podawania źródła zdjęcia

Jeśli Twoja aplikacja wyświetla zdjęcia, musisz pokazywać podawanie źródła autora w przypadku każdego zdjęcia, które je zawiera. Szczegółowe informacje o zdjęciu w obiekcie Place odpowiedzi znajdują się w tablicy photos. Aby dodać tablicę photos do odpowiedzi, uwzględnij w żądaniu pole danych photos.

Każdy element tablicy zdjęć jest instancją Photo, która zawiera tablicę authorAttributions typu AuthorAttribution. Pola obiektu AuthorAttribution to ciągi znaków zawierające displayName, uri, i photoUri podawania źródła lub pusty ciąg znaków, jeśli nie ma podawania źródła do wyświetlenia.

Więcej informacji znajdziesz w dokumentacji zdjęć miejsc.

Podawanie źródła wyników wyszukiwania

W Europie podczas korzystania z niezmodyfikowanego rankingu Google usługi wyszukiwania muszą zawierać tekst wyjaśniający, który jest dostępny po maksymalnie 1 kliknięciu i opisuje główne czynniki oraz ich wagę, które decydują o rankingu wyników wyszukiwania. Tekst wyjaśniający:

Nagłówek: Informacje o tych wynikach

Treść: Gdy szukasz firm lub miejsc w pobliżu danej lokalizacji, w Mapach Google wyświetlają się wyniki lokalne. Kilka czynników – przede wszystkim trafność, odległość i popularność – jest łączonych, aby znaleźć najlepsze wyniki wyszukiwania.

Przycisk 1: Więcej informacji
"Więcej informacji" tekst powinien zawierać link do artykułu w Centrum pomocy.

Przycisk 2: OK

Autouzupełnianie adresów użytkowników

Jeśli użytkownik korzysta z funkcji autouzupełniania w aplikacji klienta, aby wpisać adres ulicy, a ten adres zostałby w pełni i dokładnie podany przez użytkownika bez autouzupełniania, wybrany przez użytkownika adres nie podlega ograniczeniom dotyczącym treści Map Google w umowie Google Maps Platform. Ten wyjątek dotyczy tylko adresu ulicy wybranego przez użytkownika i wyłącznie na potrzeby konkretnej transakcji tego użytkownika. Nie dotyczy on listy sugerowanych adresów udostępnianych przez funkcję autouzupełniania ani innych treści Map Google. Ten wyjątek nie dotyczy żadnych funkcji wyszukiwania miejsc ani adresów oferowanych przez inne usługi Google Maps Platform.

Na poprzednim obrazie lista adresów po lewej stronie nadal podlega ograniczeniom dotyczącym treści Map Google. Gdy użytkownik wybierze adres, ten adres nie podlega ograniczeniom dotyczącym treści Map Google wyłącznie na potrzeby odpowiedniej transakcji tego użytkownika.

Podsumowania oparte na AI

Jeśli w aplikacji wyświetlasz podsumowania oparte na AI, w tym podsumowania miejsc, obszarów i opinii, musisz:

• wyświetlać wymagane podawanie źródła, linki do zgłaszania i linki do źródeł zgodnie z definicjami podanymi poniżej;
• umożliwić użytkownikom przeczytanie pełnego tekstu podsumowania udostępnianego przez Mapy Google.

Wyświetlanie tekstu oświadczenia dotyczącego podsumowań opartych na AI

Podczas wyświetlania podsumowania opartego na AI dowolnego typu zawsze umieszczaj bezpośrednio pod nim zlokalizowany tekst oświadczenia (podany w polu disclosureText treści odpowiedzi). Nigdy nie modyfikuj ani nie rozszerzaj tekstu oświadczenia udostępnianego przez interfejs API.

Dodatkowe wymagania dotyczące podsumowań miejsc i obszarów

Podsumowania miejsc i obszarów wyświetlane w aplikacji muszą zawierać ten tekst i wymagane linki:

Wymagania dotyczące podsumowań opinii

Podsumowania opinii wyświetlane w aplikacji muszą zawierać nagłówek z tekstem „Podsumowanie opinii”. Dodatkowo musisz użyć tego tekstu i wymaganych linków:

Wytyczne dotyczące wyświetlania w przypadku zastosowań w motoryzacji

Ze względu na bezpieczeństwo kierowcy Google zaleca renderowanie podsumowań opartych na AI w trybie parkowania w przypadku zastosowań w motoryzacji. Jeśli podsumowania są renderowane w trybie jazdy, informacje wyświetlane na ekranie powinny być proste, jasne i zwięzłe, aby kierowca mógł szybko wrócić do obserwowania drogi:

• Maksymalnie 3 wiersze.
• Maksymalnie 120 znaków lub 24 słowa.
• Minimalny rozmiar czcionki: 24 dp.

Szczególnie w kontekście motoryzacyjnym deweloper odpowiada za renderowanie podsumowań opartych na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.