Zasady i atrybucje dotyczące interfejsu Maps JavaScript API

Ten dokument zawiera wymagania dotyczące aplikacji tworzonych za pomocą interfejsu Maps JavaScript API. Pamiętaj, że korzystanie z Maps JavaScript API podlega Twojej umowie z Google.

Zasady

W tej sekcji opisujemy zasady dotyczące interfejsu Maps JavaScript API. Zasady zawierają praktyczne wskazówki i wymagania dotyczące wdrażania, które pomogą Ci prawidłowo korzystać z usługi i spełniać oczekiwania Google Maps Platform.

Wyjątki od ograniczeń dotyczących buforowania

Pamiętaj, że identyfikator miejsca, który służy do jednoznacznej identyfikacji miejsca, nie podlega ograniczeniom dotyczącym buforowania. Dlatego możesz przechowywać wartości identyfikatorów miejsc bezterminowo. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu API. Więcej informacji o zapisywaniu i odświeżaniu identyfikatorów miejsc oraz zarządzaniu nimi znajdziesz w przewodniku po identyfikatorach miejsc.

Scraping treści

Nazwa miejsca może zostać zwrócona na podstawie interakcji użytkownika z aplikacją. Jeśli przechwycisz lub zachowasz nazwę miejsca do użycia w innym kontekście poza sesją użytkownika, będzie to stanowić scrapowanie, które jest niedozwolone zgodnie z naszymi warunkami.

Kraje i terytoria Europejskiego Obszaru Gospodarczego

W przypadku klientów, których adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym (EOG), ta usługa ma inne Warunki korzystania z usługi i może mieć inne funkcje. Zanim zaczniesz tworzyć rozwiązania za pomocą Google Maps Platform, zapoznaj się z tymi warunkami i informacjami dotyczącymi Europejskiego Obszaru Gospodarczego:

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

Jeśli Twój adres rozliczeniowy nie znajduje się w Europejskim Obszarze Gospodarczym, 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 dotyczące podania źródła i wytyczne dotyczące wyświetlania Map Google i treści z Map Google w aplikacjach.

Przykład atrybucji

Poniżej znajdziesz przykład atrybucji w przypadku Places UI Kit.

Wyświetlanie informacji o autorstwie w Mapach Google

Podczas wyświetlania treści z interfejsów API Google Maps Platform w aplikacji lub witrynie musisz przestrzegać wymagań dotyczących podania źródła Map Google. Nie musisz dodawać dodatkowych informacji o autorstwie, jeśli Treści są wyświetlane w Mapach Google, gdzie informacje o autorstwie są już widoczne.

Uwzględniono atrybucję Map Google

W przypadku atrybucji Map Google, która jest już udostępniana przez Google Maps Platform w interfejsie, np. w Places UI Kit:

• Nie usuwaj dołączonych informacji o autorstwie, niezależnie od tego, gdzie są wyświetlane. Nie zmieniaj, nie ukrywaj ani nie zasłaniaj informacji o autorze i upewnij się, że jest ona wyraźnie widoczna 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ść pustego miejsca.
• Wprowadzając zmiany wizualne, musisz przestrzegać wszystkich wymagań Google Maps dotyczących podawania źródła.

Logo Map Google i atrybucja tekstowa

Jeśli to możliwe, atrybucja powinna mieć formę 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.

Atrybucja logo

Pobieranie logo Map Google

Używaj oficjalnych plików logo Map Google. Pobierz logo poniżej i postępuj zgodnie ze wskazówkami podanymi w tej sekcji.

Podczas korzystania z logo Map Google postępuj zgodnie z tymi wytycznymi.

• Nie modyfikuj logo w żaden sposób.
• Zachowaj format obrazu logo, aby uniknąć zniekształceń.
• Używaj logo z obramowaniem na szczegółowym tle, np. na mapie lub obrazie.
• Używaj logo bez obramowania na jednolitym tle, np. w jednolitym kolorze lub z delikatnym gradientem.

Specyfikacja rozmiaru logo

• Minimalna wysokość logo: 16 dp
• Maksymalna wysokość logo: 19 dp
• Minimalny pusty obszar wokół logo: 10 dp po lewej i prawej stronie oraz u góry, 5 dp u dołu.

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

Dostępność logo

• Zachowaj odpowiedni kontrast między logo a tłem.
• Dołącz etykietę ułatwień dostępu z tekstem Mapy Google.

Atrybucja tekstowa

Jeśli rozmiar interfejsu nie pozwala na użycie logo Map Google, możesz wpisać tekst Mapy Google. Skorzystaj z tych wskazówek:

• Nie modyfikuj w żaden sposób tekstu Mapy Google:
  
  • Nie zmieniaj wielkości liter w nazwie Mapy Google.
  • Nie zawijaj nazwy Mapy Google do wielu wierszy.
  • Nie tłumacz nazwy Mapy Google na inny język.
  • Aby uniemożliwić przeglądarkom tłumaczenie Map Google, użyj atrybutu HTML translate="no".

• Tekst Map Google należy sformatować zgodnie z tabelą poniżej:

  Wymagania dotyczące stylizacji tekstu w Mapach Google
  Właściwość	Styl
  Rodzina czcionek	Roboto. Wczytywanie czcionki jest opcjonalne.
  Rodzina czcionek zastępczych	Dowolna czcionka bezszeryfowa używana już w Twojej usłudze lub „Sans-Serif”, aby wywołać domyślną czcionkę systemową.
  Styl czcionki	Normalna
  Grubość czcionki	400
  Kolor czcionki	Biały, czarny (#1F1F1F) lub szary (#5E5E5E). Zachowaj dostępny kontrast (4,5:1) względem tła.
  Rozmiar czcionki	Minimalny rozmiar czcionki: 12 sp Maksymalny rozmiar czcionki: 16 sp Więcej informacji o jednostce sp znajdziesz w sekcji Jednostki rozmiaru czcionki na stronie Material Design.
  Odstępy między literami	Normalna

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 dotyczące treści wizualnych

• Umieść informacje o autorze w pobliżu góry lub dołu treści i w tym samym kontenerze wizualnym. W przypadku pojedynczego wiersza treści atrybucję 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ść pustego miejsca.

• Nie przedstawiaj Map Google w fałszywy sposób, przypisując im treści, które nie pochodzą z Google Maps Platform.
• Sprawdź, czy atrybucja jest zawsze widoczna i czytelna. Nigdy nie usuwaj, nie ukrywaj, nie zasłaniaj ani nie modyfikuj tego logo.

Na ilustracjach poniżej pokazano przykłady tych wymagań wizualnych.

zewnętrzni dostawcy danych,

Niektóre dane i zdjęcia w naszych usługach mapowania pochodzą od dostawców innych niż Google. W przypadku niektórych usług, takich jak Map Tiles API, możemy podać wymagane informacje o autorze, które należy przypisać zewnętrznemu dostawcy danych. W takim przypadku tekst atrybucji musi zawierać nazwę „Mapy Google” i nazwy odpowiednich dostawców danych, np. „Dane mapy: Google, Maxar Technologies”. Gdy Google podaje informacje o źródle, które należy do innej firmy, podanie tylko „Map Google” lub logo Google nie jest prawidłowym podaniem źródła.

Inne wymagania dotyczące atrybucji

Aby pobrać informacje o autorstwie i wyświetlić je w aplikacji, postępuj zgodnie z tymi instrukcjami.

Pobieranie atrybucji z miejsca

Jeśli aplikacja wyświetla informacje o opiniach uzyskane przez wywołanie Place.fetchFields, musi też wyświetlać informacje o pochodzeniu danych osób trzecich w przypadku uzyskanych informacji o miejscu.

Interfejs API zwraca obiekt Place. Aby pobrać atrybucje z obiektu Place, użyj właściwości Place.attributions, która jest zwracana z każdym żądaniem (nie trzeba jej określać w polach). Właściwość zwraca List obiektów String lub null, jeśli nie ma atrybucji do wyświetlenia. Poniższy przykładowy kod pokazuje, jak pobrać miejsce i wyświetlić listę autorów.

  // 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 aplikacji.

Podczas wyświetlania opinii dodanych przez użytkowników Google musisz umieścić imię i nazwisko autora w pobliżu opinii. Jeśli w polu atrybucji autora obiektu Review jest dostępne zdjęcie autora i link do jego profilu, zalecamy ich uwzględnienie. Poniższy obraz przedstawia przykład opinii o parku:

Poniższy przykład pokazuje, jak pobrać miejsce, sprawdzić opinie i wyświetlić dane z pierwszej opinii:

// 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'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

Zapoznaj się z dokumentacją dotyczącą opinii o miejscach

Wyświetlanie informacji o autorze zdjęcia

Jeśli Twoja aplikacja wyświetla zdjęcia, musisz podać informacje o autorze 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 atrybucji lub pusty ciąg znaków, jeśli nie ma atrybucji do wyświetlenia.

Zapoznaj się z dokumentacją dotyczącą zdjęć miejsc

Atrybucje wyników wyszukiwania

W Europie, gdy używasz niezmienionego rankingu Google, usługi wyszukiwania muszą zawierać tekst objaśniający, który znajduje się nie dalej niż 1 kliknięcie od strony głównej i opisuje główne czynniki oraz ich wagę, które decydują o pozycji w 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. Aby wybrać dla Ciebie najlepsze wyniki wyszukiwania, uwzględniamy różne czynniki – przede wszystkim trafność, odległość i renomę.

Przycisk 1: Więcej informacji
Tekst „Więcej informacji” powinien prowadzić do artykułu w Centrum pomocy.

Przycisk 2: OK

Autouzupełnianie adresów użytkowników

Gdy użytkownik korzysta z funkcji autouzupełniania w Twojej aplikacji, aby wpisać adres, który zostałby przez niego podany w całości i prawidłowo bez użycia autouzupełniania, wybrany przez niego adres nie podlega ograniczeniom dotyczącym treści Map Google określonym w Umowie dotyczącej Google Maps Platform. Ten wyjątek dotyczy tylko adresu pocztowego wybranego przez użytkownika i wyłącznie konkretnej transakcji tego użytkownika. Nie dotyczy on listy sugerowanych adresów dostarczanych przez funkcję autouzupełniania ani innych Treści Map Google. Ten wyjątek nie dotyczy funkcji wyszukiwania ciekawych 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, nie będzie on podlegać ograniczeniom dotyczącym Treści Map Google wyłącznie na potrzeby danej transakcji użytkownika.

Podsumowania oparte na AI

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

• Wyświetlaj wymagane informacje o autorstwie, linki do raportów i linki referencyjne zgodnie z poniższymi definicjami.
• Użytkownicy muszą mieć możliwość przeczytania pełnego tekstu podsumowania dostarczonego przez Mapy Google.

Wyświetlanie tekstu oświadczenia o podsumowaniach opartych na AI

Podczas wyświetlania dowolnego typu podsumowania wygenerowanego przez AI zawsze umieszczaj zlokalizowany tekst ujawnienia (podany w polu disclosureText treści odpowiedzi) bezpośrednio pod podsumowaniem. Nigdy nie modyfikuj ani nie rozszerzaj tekstu oświadczenia dostarczanego 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 podsumowania opinii

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

Wyświetlanie wskazówek w przypadku zastosowań motoryzacyjnych

Ze względu na bezpieczeństwo kierowcy Google zaleca renderowanie podsumowań opartych na AI w trybie parkowania w przypadku aplikacji samochodowych. Jeśli podsumowania są renderowane w trybie prowadzenia samochodu, informacje na ekranie powinny być proste, jasne i zwięzłe, aby kierowca mógł szybko skupić się z powrotem na drodze:

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

Szczególnie w przypadku zastosowań motoryzacyjnych deweloper jest odpowiedzialny za renderowanie podsumowań opartych na AI w sposób bezpieczny i zgodny ze wszystkimi lokalnymi przepisami i regulacjami prawnymi.