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 warunków dotyczących Google Maps Platform znajdziesz w Warunkach korzystania z tej usługi.

Warunki korzystania z usługi i polityka 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ługi i Polityka prywatności muszą być dostępne publicznie.
  • W Warunkach korzystania z aplikacji musisz wyraźnie określić, że korzystanie z niej oznacza, że użytkownicy są związani Warunkami korzystania z usług Google.
  • Musisz powiadomić użytkowników w Polityce prywatności, że korzystasz z interfejsów API Map Google, i uwzględnić te informacje w Polityce 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 z wyprzedzeniem, buforowanie lub przechowywanie treści

Aplikacje korzystające z interfejsu Maps JavaScript API podlegają warunkom Umowy z Google. Zgodnie z warunkami Umowy Użytkownik nie może pobierać z wyprzedzeniem, indeksować, przechowywać ani zapisywać w pamięci podręcznej żadnych Treści z wyjątkiem ograniczonych warunków określonych w warunkach.

Pamiętaj, że identyfikator miejsca używany do jednoznacznej identyfikacji miejsca jest wykluczony z ograniczeń dotyczących zapisywania w pamięci podręcznej. Identyfikator miejsca jest zwracany w polu place_id w odpowiedziach interfejsu Maps JavaScript API. Więcej informacji o zapisywaniu, odświeżaniu i zarządzaniu identyfikatorami miejsc znajdziesz w przewodniku po identyfikatorach miejsc.

Wyświetlanie wyników interfejsu Maps JavaScript API

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

Jeśli Twoja aplikacja wyświetla dane w Mapach Google, zostanie uwzględnione logo Google, które nie może zostać zmienione. Aplikacje, które wyświetlają dane Google na tym samym ekranie co Mapy Google, nie muszą dodatkowo podawać danych 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 w aplikacji dane Google są wyświetlane na jednej karcie, a w Mapach Google z tymi danymi na innej, na pierwszej karcie musi być widoczne logo Google. Jeśli aplikacja używa pól wyszukiwania z autouzupełnianiem lub bez niego, logo musi być wyświetlane w linii.

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ładzie mapy poniżej widać logo Google w lewym dolnym rogu, a informacje o autorze w prawym dolnym rogu.

miejsce docelowe atrybucji zasad

Ten plik ZIP zawiera logo Google w odpowiednich rozmiarach na potrzeby aplikacji na komputery, urządzenia z Androidem i iOS. Nie można zmieniać rozmiaru ani modyfikować tych logo w żaden sposób.

Pobierz: google_logo.zip

Nie modyfikuj atrybucji. Nie usuwaj, nie zasłaniaj ani nie wycinaj informacji o autorze. Nie możesz używać logo Google w tekście (np. „Te mapy pochodzą z [Google_logo]”).

Utrzymuj atrybucję w pobliżu. 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 przenosić informacji o pochodzeniu danych poza treść, np. na końcu książki, w informacje o autorach plików lub programu ani w stopce witryny.

Uwzględnij zewnętrznych dostawców danych. Niektóre dane i zdjęcia w naszych usługach mapowania pochodzą od dostawców innych 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 źródłach nie jest racjonalne, skontaktuj się z zespołem sprzedaży Google, aby omówić licencje odpowiednie do Twojego zastosowania.

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 atrybutach z Miejsca

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). Usługa zwraca List z String obiektów lub null, jeśli nie ma żadnych atrybucji do wyświetlenia. Poniższy przykładowy kod pokazuje, jak pobierać miejsce i wyświetlać wszystkie atrybuty.

  // 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. Opcjonalnie możesz wyświetlać te opinie w swojej aplikacji.

Przy wyświetlaniu opinii przesłanych przez użytkowników Google musisz umieścić nazwisko autora w pobliżu. Jeśli w polu atrybucji autora obiektu Review są dostępne, zalecamy dodanie zdjęcia autora i linku do jego profilu. Poniższy obraz przedstawia przykładową opinię 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 autorze 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ć do odpowiedzi tablicę photos, umieść w żądaniu 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.

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

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. Wyjaśnienie:

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: dodatkowe informacje
Tekst „Więcej informacji” powinien prowadzić do artykułu w Centrum pomocy.

Button 2: OK

Wytyczne dotyczące stylu na potrzeby atrybucji Google

Poniżej znajdziesz wskazówki dotyczące stylu atrybucji Google w arkuszach CSS i HTML, jeśli nie możesz użyć logo Google do pobrania.

Pusty obszar

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

Odległość między tekstem informacji o źródle a logo Google powinna być o połowę szerokości litery „G”.

czytelność;

Podpis powinien zawsze być wyraźny i czytelny oraz mieć odpowiedni kolor na danym tle. Zawsze dbaj o odpowiedni kontrast dla wybranej odmiany logo.

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 ciemniejszych tłach oraz na zdjęciach lub wzorach brak aktywności użyj białego tekstu jako autora i informacji o autorze.

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

Czcionka

Użyj czcionki Roboto.

Przykładowy kod CSS

Poniższy kod CSS zastosowany do tekstu „Google” spowoduje, że „Google” zostanie wyrenderowane z odpowiednim fontem, kolorem i odstępem 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;