Zasady dotyczące interfejsu Maps JavaScript API

W tym artykule znajdziesz wymagania dotyczące atrybucji w przypadku wszystkich aplikacji opracowanych za pomocą interfejsu Maps JavaScript API, w tym usługi autouzupełniania miejsc, która jest częścią tego interfejsu API. Więcej informacji o warunkach korzystania z Google Maps Platform znajdziesz w Warunkach korzystania z Google Maps Platform.

Udostępnianie warunków korzystania z usługi i polityki prywatności

Jeśli tworzysz aplikację korzystającą z interfejsu Maps JavaScript API, musisz udostępnić w niej Warunki korzystania z usługiPolitykę prywatności zgodne z wytycznymi opisanymi w umowie z Google:

  • Warunki korzystania z usługiPolityka prywatności muszą być publicznie dostępne.
  • Warunkach korzystania z aplikacji musisz wyraźnie stwierdzić, że korzystanie z aplikacji jest równoznaczne z zaakceptowaniem Warunków korzystania z usługi Google.
  • Polityce prywatności musisz poinformować użytkowników, że używasz interfejsów API Map Google, i załączyć Politykę prywatności Google.

Miejsce, w którym zalecamy udostępnienie Warunków korzystania z aplikacjiPolityki prywatności, zależy od platformy aplikacji.

Aplikacja mobilna

Jeśli tworzysz aplikację mobilną, zalecamy podanie linku do Warunków korzystania z usługi i Polityki prywatności na stronie pobierania aplikacji w odpowiednim sklepie z aplikacjami oraz w menu ustawień aplikacji.

Aplikacje internetowe

Jeśli tworzysz aplikację internetową, zalecamy umieszczenie w stopce witryny linku do Warunków korzystania z usługiPolityki prywatności.

pobieranie w ramach wstępnego pobierania, przechowywania w pamięci podręcznej lub przechowywania treści;

Aplikacje korzystające z interfejsu Maps JavaScript API są objęte postanowieniami umowy z Google. Zgodnie z warunkami Umowy nie wolno Ci pobierać wstępnie, indeksować, przechowywać ani przechowywać w pamięci podręcznej żadnych Treści, z wyjątkiem ograniczonych warunków określonych w Warunkach.

Pamiętaj, że identyfikator miejsca służący do jednoznacznej identyfikacji miejsca nie podlega ograniczeniami dotyczącymi pamięci podręcznej. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach Maps JavaScript API. Więcej informacji o zapisywaniu i odświeżaniu identyfikatorów miejsc oraz zarządzaniu nimi znajdziesz w przewodniku na temat identyfikatorów miejsc.

Wyświetlanie wyników Maps JavaScript API

Wyniki interfejsu Maps JavaScript API możesz wyświetlać w Mapach Google lub bez mapy. Jeśli chcesz wyświetlać wyniki interfejsu Maps JavaScript API na mapie, muszą one być wyświetlane na mapie Google. Nie wolno używać danych interfejsu Maps JavaScript API na mapie, która nie jest mapą Google.

Jeśli aplikacja wyświetla dane na mapie Google, logo Google będzie widoczne i nie można go zmienić. Aplikacje, które wyświetlają dane Google na tym samym ekranie co Mapa Google, nie muszą zawierać dodatkowych informacji o Google.

Jeśli Twoja aplikacja wyświetla dane na stronie lub w widoku, który nie zawiera też Map Google, musisz wyświetlić logo Google. Jeśli na przykład aplikacja wyświetla dane Google na jednej karcie, a Mapy Google z tymi danymi na drugiej, na pierwszej karcie musi być widoczne logo Google. Jeśli aplikacja korzysta z pól wyszukiwania z autouzupełnianiem lub bez nich, logo musi być wyświetlane w tekście.

Logo Google powinno znajdować się w lewym dolnym rogu mapy, a informacje o autorze – w prawym dolnym rogu. Oba elementy powinny być umieszczone na mapie, która jest prezentowana jako całość, a nie pod mapą ani w innym miejscu w aplikacji. Na przykładowej mapie logo Google znajduje się w lewym dolnym rogu, a w prawym dolnym rogu – informacja o źródle.

policy attribution placement

Poniższy plik ZIP zawiera logo Google we właściwym rozmiarze dla aplikacji na komputery oraz na Androida i iOS. Nie możesz zmieniać rozmiaru ani modyfikować tych logotypów w żaden sposób.

Pobierz: google_logo.zip

Nie modyfikuj atrybucji. Nie wolno usuwać, zasłaniać ani przycinać informacji dotyczących atrybucji. Nie możesz używać logo Google w tekście (np. „Te mapy pochodzą z [Google_logo]”).

Zadbaj o to, aby informacje o atrybucji były jak najbardziej trafne. Jeśli używasz zrzutów ekranu obrazów Google poza bezpośrednim umieszczeniem, dodaj standardowe informacje o źródle, które są widoczne na obrazie. W razie potrzeby możesz dostosować styl i umiejscowienie tekstu z informacjami o autorze, pod warunkiem że znajduje się on blisko treści i jest czytelny dla przeciętnego użytkownika lub czytelnika. Nie możesz przenieść informacji o źródle poza treści, np. do końca książki, informacji o treściach w plikach lub programie albo stopki witryny.

Uwzględnij zewnętrznych dostawców danych. Niektóre dane i obrazy w naszych usługach mapowania pochodzą od innych dostawców niż Google. Jeśli używasz takich obrazów, tekst informacji o autorze musi zawierać nazwę „Google” oraz nazwę odpowiedniego dostawcy danych, np. „Dane map: Google, Maxar Technologies”. Jeśli w związku ze zdjęciami są wymienieni zewnętrzni dostawcy danych, podanie tylko nazwy „Google” lub logo Google nie jest prawidłowym przypisaniem autorstwa.

Jeśli korzystasz z Google Maps Platform na urządzeniu, na którym wyświetlanie informacji o pochodzeniu nie jest praktyczne, skontaktuj się z zespołem handlowym Google, aby omówić licencje odpowiednie do Twojego przypadku użycia.

Inne wymagania dotyczące atrybucji

Aby pobrać atrybucję pochodzącą od osoby trzeciej i wyświetlić ją w aplikacji, wykonaj podane niżej instrukcje.

Pobieranie informacji o autorze utworu

Jeśli aplikacja wyświetla informacje o opiniach uzyskane przez wywołanie funkcji Place.fetchFields, musi też wyświetlać informacje o źródłach danych dotyczących 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 musisz podawać jej za pomocą pól). Właściwość List zwraca obiekt String lub null, jeśli nie ma atrybutów do wyświetlenia. Ten przykładowy kod pokazuje znajdowanie miejsca i listę atrybucji.

  // 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świetl opinię

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

Wyświetlając opinie użytkowników Google, musisz umieścić nazwę autora w pobliżu opinii. Zalecamy dołączenie zdjęcia autora i link do jego profilu, jeśli jest ono dostępne w polu informacji o autorze obiektu Review. Na poniższym obrazku znajduje się przykład opinii o parku:

Wyświetlanie informacji o autorze

Ten przykład pokazuje, jak znaleźć miejsce, sprawdzić 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,
      });
  }
  

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

Wyświetlanie informacji o źródle zdjęcia

Jeśli Twoja aplikacja wyświetla zdjęcia, musisz podać informacje o autorze każdego zdjęcia. Szczegóły dotyczące zdjęcia w obiekcie Place odpowiedzi znajdują się w tablicy photos. Aby dodać tablicę photos do odpowiedzi, dodaj do żądania pole danych photos.

Każdy element tablicy photos jest instancją klasy Photo, która zawiera tablicę authorAttributions typu AuthorAttribution. Pola obiektu AuthorAttribution to ciągi znaków zawierające atrybuty displayName, uri i photoUri, lub pusty ciąg znaków, jeśli nie ma atrybutów do wyświetlenia.

Zobacz dokumentację dotyczącą zdjęć miejsc

Atrybucja wyników wyszukiwania

W Europie podczas korzystania z rankingu Google wyniki wyszukiwania nie mogą zawierać tekstu wyjaśnienia, które jest umieszczone w odległości maksymalnie 1 kliknięcia, aby opisać główne czynniki i określić wagę tych czynników, które decydują o pozycji w rankingu wyników wyszukiwania. Tekst wyjaśniający:

Header: Informacje o tych wynikach

Treść: gdy szukasz firm lub miejsc w pobliżu danej lokalizacji, w Mapach Google zobaczysz wyniki lokalne. Aby wybrać dla Ciebie najlepsze wyniki wyszukiwania, uwzględniamy różne czynniki – przede wszystkim trafność, odległość i renomę.

Przycisk 1: dowiedz się więcej
Tekst „Dowiedz się więcej” powinien zawierać link do artykułu w Centrum pomocy.

Button 2: OK

Wytyczne dotyczące stylu atrybucji Google

Jeśli nie możesz użyć logo Google do pobrania, poniżej znajdziesz wytyczne dotyczące stylów w przypadku informacji o Google w CSS i HTML.

Pusty obszar

Wielkość pustego obszaru wokół logo powinna być równa wysokości litery „G” w logo Google lub od niej większa.

Odstęp między tekstem dotyczącym atrybucji a logo Google powinien wynosić połowę szerokości litery „G”.

czytelność;

W przypadku podpisu należy zawsze zadbać o to, aby był on wyraźny, czytelny i wyświetlany w odpowiednim kolorze w zależności od tła. Pamiętaj, aby wybrana przez Ciebie wersja logo miała wystarczający kontrast.

Kolor

Używaj czcionki Google Material Gray 700 na białym lub jasnym tle, która ma zakres 0–40% maksymalnego odcienia czerni.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Na ciemniejszym tle oraz na zdjęciach lub prostych wzorach używaj białego tekstu w przypisach i podpisach.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Czcionka

Użyj czcionki Roboto.

Przykładowy arkusz CSS

Po zastosowaniu takiego kodu CSS do tekstu „Google” tekst „Google” zostałby wyrenderowany z użyciem odpowiedniej czcionki, koloru i odstępów na białym lub jasnym tle.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;