001// Generated by delombok at Tue Dec 10 13:42:03 UTC 2024
002/*
003 * Copyright (c) 2010-2024 Mark Allen, Norbert Bartels.
004 *
005 * Permission is hereby granted, free of charge, to any person obtaining a copy
006 * of this software and associated documentation files (the "Software"), to deal
007 * in the Software without restriction, including without limitation the rights
008 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
009 * copies of the Software, and to permit persons to whom the Software is
010 * furnished to do so, subject to the following conditions:
011 *
012 * The above copyright notice and this permission notice shall be included in
013 * all copies or substantial portions of the Software.
014 *
015 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
016 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
017 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
018 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
019 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
020 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
021 * THE SOFTWARE.
022 */
023package com.restfb.types;
024
025import static java.util.Collections.unmodifiableList;
026import java.util.ArrayList;
027import java.util.List;
028import com.restfb.Facebook;
029import com.restfb.JsonMapper;
030import com.restfb.types.ads.AppLinks;
031import com.restfb.types.features.HasCover;
032import com.restfb.types.features.HasProfilePicture;
033
034/**
035 * Represents the <a href="https://developers.facebook.com/docs/places/fields">SearchPlace</a>
036 */
037public class SearchPlace extends NamedFacebookType implements HasProfilePicture, HasCover {
038  /**
039   * Information about the Place provided by the Page administrator.
040   */
041  @Facebook
042  private String about;
043  /**
044   * AppLinks to the Place on various devices.
045   */
046  @Facebook("app_links")
047  private AppLinks appLinks;
048  @Facebook("category_list")
049  private List<Category> categoryList = new ArrayList<>();
050  /**
051   * The number of checkins at this Place.
052   */
053  @Facebook
054  private Long checkins;
055  /**
056   * Information about the cover photo.
057   */
058  @Facebook
059  private CoverPhoto cover;
060  /**
061   * The description of the Place provided by the Page administrator.
062   */
063  @Facebook
064  private String description;
065  /**
066   * The social sentence and the like count information for this Place. This is the same information used for the like
067   * button.
068   */
069  @Facebook
070  private Page.Engagement engagement;
071  /**
072   */
073  @Facebook
074  private String hours;
075  /**
076   * Indicates whether this Place is always open.
077   */
078  @Facebook("is_always_open")
079  private Boolean isAlwaysOpen;
080  /**
081   * Indicates whether this Place is permanently closed.
082   */
083  @Facebook("is_permanently_closed")
084  private Boolean isPermanentlyClosed;
085  /**
086   * Pages with a large number of followers can be manually verified by Facebook as having an authentic identity. This
087   * field indicates whether the Page has been verified by this process.
088   */
089  @Facebook("is_verified")
090  private Boolean isVerified;
091  /**
092   * The URL of the Facebook Page.
093   */
094  @Facebook
095  private String link;
096  /**
097   * Location information about the Place. E.g., latitude and longitude, and address.
098   */
099  @Facebook
100  private Location location;
101  /**
102   * The overall page rating, based on rating survey from users, on a scale of 1-5.
103   *
104   * This value is normalized, and is not guaranteed to be a strict average of user ratings.
105   */
106  @Facebook("overall_star_rating")
107  private Double overallStarRating;
108  /**
109   * The Page node corresponding to the Place.
110   */
111  @Facebook
112  private Page page;
113  /**
114   * Parking information about the Place.
115   */
116  @Facebook
117  private Page.PageParking parking;
118  /**
119   * Payment options accepted by the Place. Applicable to restaurants and nightlife.
120   */
121  @Facebook("payment_options")
122  private Page.PagePaymentOptions paymentOptions;
123  /**
124   * The Place's telephone number.
125   */
126  @Facebook
127  private String phone;
128  /**
129   * The pages's profile picture, if provided.
130   *
131   * To force Facebook to fill the <code>picture</code> field you have to fetch the page with the
132   * <code>fields=picture</code> parameter, otherwise the picture is <code>null</code>.
133   */
134  private ProfilePictureSource picture;
135  @Facebook("picture")
136  private transient String rawPicture;
137  /**
138   * Price range of the business.
139   *
140   * Applicable to Restaurants or Nightlife. Can be one of $ (0-10), $$ (10-30), $$$ (30-50), $$$$ (50+), or Unspecified
141   */
142  @Facebook("price_range")
143  private String priceRange;
144  /**
145   * Number of ratings for the Place
146   */
147  @Facebook("rating_count")
148  private Long ratingCount;
149  /**
150   * The services that the restaurant provides.
151   */
152  @Facebook("restaurant_services")
153  private Page.PageRestaurantServices restaurantServices;
154  /**
155   * The restaurant's specialties.
156   */
157  @Facebook("restaurant_specialties")
158  private Page.PageRestaurantSpecialties restaurantSpecialties;
159  /**
160   * The Place's complete postal address, on a single line.
161   */
162  @Facebook("single_line_address")
163  private String singleLineAddress;
164  /**
165   * The URL of the Place's website.
166   */
167  @Facebook
168  private String website;
169  /**
170   * Photos for the Place.
171   *
172   * By default, this edge returns the profile photos for the Place. You can also use an optional type parameter with
173   * the value uploaded to get the photos uploaded by the Place.
174   */
175  @Facebook
176  private List<Photo> photos = new ArrayList<>();
177  /**
178   * The native component workflows for this Place.
179   *
180   * Workflows allow people to perform actions like requesting appointments, buying tickets, and ordering from
181   * restaurants on Facebook
182   */
183  @Facebook
184  private List<PagesPlatformComponentFlowServiceConfig> workflows = new ArrayList<>();
185
186  @JsonMapper.JsonMappingCompleted
187  protected void fillProfilePicture(JsonMapper jsonMapper) {
188    picture = convertPicture(jsonMapper, rawPicture);
189  }
190
191  /**
192   * The Place's categories.
193   *
194   * @return The Place's categories.
195   */
196  public List<Category> getCategoryList() {
197    return unmodifiableList(categoryList);
198  }
199
200  public boolean addCategory(Category category) {
201    return categoryList.add(category);
202  }
203
204  public boolean removeCategory(Category category) {
205    return categoryList.remove(category);
206  }
207
208
209  public static class PagesPlatformComponentFlowServiceConfig extends FacebookType {
210    @Facebook
211    private String deeplink;
212    @Facebook
213    private String label;
214    @Facebook("flow_category")
215    private String flowCategory;
216
217    @java.lang.SuppressWarnings("all")
218    public String getDeeplink() {
219      return this.deeplink;
220    }
221
222    @java.lang.SuppressWarnings("all")
223    public void setDeeplink(final String deeplink) {
224      this.deeplink = deeplink;
225    }
226
227    @java.lang.SuppressWarnings("all")
228    public String getLabel() {
229      return this.label;
230    }
231
232    @java.lang.SuppressWarnings("all")
233    public void setLabel(final String label) {
234      this.label = label;
235    }
236
237    @java.lang.SuppressWarnings("all")
238    public String getFlowCategory() {
239      return this.flowCategory;
240    }
241
242    @java.lang.SuppressWarnings("all")
243    public void setFlowCategory(final String flowCategory) {
244      this.flowCategory = flowCategory;
245    }
246  }
247
248  /**
249   * Information about the Place provided by the Page administrator.
250   *
251   * @return Information about the Place provided by the Page administrator.
252   */
253  @java.lang.SuppressWarnings("all")
254  public String getAbout() {
255    return this.about;
256  }
257
258  /**
259   * Information about the Place provided by the Page administrator.
260   */
261  @java.lang.SuppressWarnings("all")
262  public void setAbout(final String about) {
263    this.about = about;
264  }
265
266  /**
267   * AppLinks to the Place on various devices.
268   *
269   * @return AppLinks to the Place on various devices.
270   */
271  @java.lang.SuppressWarnings("all")
272  public AppLinks getAppLinks() {
273    return this.appLinks;
274  }
275
276  /**
277   * AppLinks to the Place on various devices.
278   */
279  @java.lang.SuppressWarnings("all")
280  public void setAppLinks(final AppLinks appLinks) {
281    this.appLinks = appLinks;
282  }
283
284  /**
285   * The number of checkins at this Place.
286   *
287   * @return The number of checkins at this Place.
288   */
289  @java.lang.SuppressWarnings("all")
290  public Long getCheckins() {
291    return this.checkins;
292  }
293
294  /**
295   * The number of checkins at this Place.
296   */
297  @java.lang.SuppressWarnings("all")
298  public void setCheckins(final Long checkins) {
299    this.checkins = checkins;
300  }
301
302  /**
303   * Information about the cover photo.
304   *
305   * @return Information about the cover photo.
306   */
307  @Override
308  @java.lang.SuppressWarnings("all")
309  public CoverPhoto getCover() {
310    return this.cover;
311  }
312
313  /**
314   * Information about the cover photo.
315   */
316  @java.lang.SuppressWarnings("all")
317  public void setCover(final CoverPhoto cover) {
318    this.cover = cover;
319  }
320
321  /**
322   * The description of the Place provided by the Page administrator.
323   *
324   * @return The description of the Place provided by the Page administrator.
325   */
326  @java.lang.SuppressWarnings("all")
327  public String getDescription() {
328    return this.description;
329  }
330
331  /**
332   * The description of the Place provided by the Page administrator.
333   */
334  @java.lang.SuppressWarnings("all")
335  public void setDescription(final String description) {
336    this.description = description;
337  }
338
339  /**
340   * The social sentence and the like count information for this Place. This is the same information used for the like
341   * button.
342   *
343   * @return The social sentence and the like count information for this Place.
344   */
345  @java.lang.SuppressWarnings("all")
346  public Page.Engagement getEngagement() {
347    return this.engagement;
348  }
349
350  /**
351   * The social sentence and the like count information for this Place. This is the same information used for the like
352   * button.
353   */
354  @java.lang.SuppressWarnings("all")
355  public void setEngagement(final Page.Engagement engagement) {
356    this.engagement = engagement;
357  }
358
359  /**
360   */
361  @java.lang.SuppressWarnings("all")
362  public String getHours() {
363    return this.hours;
364  }
365
366  /**
367   */
368  @java.lang.SuppressWarnings("all")
369  public void setHours(final String hours) {
370    this.hours = hours;
371  }
372
373  /**
374   * Indicates whether this Place is always open.
375   *
376   * @return Indicates whether this Place is always open.
377   */
378  @java.lang.SuppressWarnings("all")
379  public Boolean getIsAlwaysOpen() {
380    return this.isAlwaysOpen;
381  }
382
383  /**
384   * Indicates whether this Place is always open.
385   */
386  @java.lang.SuppressWarnings("all")
387  public void setIsAlwaysOpen(final Boolean isAlwaysOpen) {
388    this.isAlwaysOpen = isAlwaysOpen;
389  }
390
391  /**
392   * Indicates whether this Place is permanently closed.
393   *
394   * @return Indicates whether this Place is permanently closed.
395   */
396  @java.lang.SuppressWarnings("all")
397  public Boolean getIsPermanentlyClosed() {
398    return this.isPermanentlyClosed;
399  }
400
401  /**
402   * Indicates whether this Place is permanently closed.
403   */
404  @java.lang.SuppressWarnings("all")
405  public void setIsPermanentlyClosed(final Boolean isPermanentlyClosed) {
406    this.isPermanentlyClosed = isPermanentlyClosed;
407  }
408
409  /**
410   * Pages with a large number of followers can be manually verified by Facebook as having an authentic identity. This
411   * field indicates whether the Page has been verified by this process.
412   */
413  @java.lang.SuppressWarnings("all")
414  public Boolean getIsVerified() {
415    return this.isVerified;
416  }
417
418  /**
419   * Pages with a large number of followers can be manually verified by Facebook as having an authentic identity. This
420   * field indicates whether the Page has been verified by this process.
421   */
422  @java.lang.SuppressWarnings("all")
423  public void setIsVerified(final Boolean isVerified) {
424    this.isVerified = isVerified;
425  }
426
427  /**
428   * The URL of the Facebook Page.
429   *
430   * @return The URL of the Facebook Page.
431   */
432  @java.lang.SuppressWarnings("all")
433  public String getLink() {
434    return this.link;
435  }
436
437  /**
438   * The URL of the Facebook Page.
439   */
440  @java.lang.SuppressWarnings("all")
441  public void setLink(final String link) {
442    this.link = link;
443  }
444
445  /**
446   * Location information about the Place. E.g., latitude and longitude, and address.
447   *
448   * @return Location information about the Place. E.g., latitude and longitude, and address.
449   */
450  @java.lang.SuppressWarnings("all")
451  public Location getLocation() {
452    return this.location;
453  }
454
455  /**
456   * Location information about the Place. E.g., latitude and longitude, and address.
457   */
458  @java.lang.SuppressWarnings("all")
459  public void setLocation(final Location location) {
460    this.location = location;
461  }
462
463  /**
464   * The overall page rating, based on rating survey from users, on a scale of 1-5.
465   *
466   * This value is normalized, and is not guaranteed to be a strict average of user ratings.
467   *
468   * @return The overall page rating, based on rating survey from users, on a scale of 1-5.
469   */
470  @java.lang.SuppressWarnings("all")
471  public Double getOverallStarRating() {
472    return this.overallStarRating;
473  }
474
475  /**
476   * The overall page rating, based on rating survey from users, on a scale of 1-5.
477   *
478   * This value is normalized, and is not guaranteed to be a strict average of user ratings.
479   */
480  @java.lang.SuppressWarnings("all")
481  public void setOverallStarRating(final Double overallStarRating) {
482    this.overallStarRating = overallStarRating;
483  }
484
485  /**
486   * The Page node corresponding to the Place.
487   *
488   * @return The Page node corresponding to the Place.
489   */
490  @java.lang.SuppressWarnings("all")
491  public Page getPage() {
492    return this.page;
493  }
494
495  /**
496   * The Page node corresponding to the Place.
497   */
498  @java.lang.SuppressWarnings("all")
499  public void setPage(final Page page) {
500    this.page = page;
501  }
502
503  /**
504   * Parking information about the Place.
505   *
506   * @return Parking information about the Place.
507   */
508  @java.lang.SuppressWarnings("all")
509  public Page.PageParking getParking() {
510    return this.parking;
511  }
512
513  /**
514   * Parking information about the Place.
515   */
516  @java.lang.SuppressWarnings("all")
517  public void setParking(final Page.PageParking parking) {
518    this.parking = parking;
519  }
520
521  /**
522   * Payment options accepted by the Place. Applicable to restaurants and nightlife.
523   *
524   * @return Payment options accepted by the Place.
525   */
526  @java.lang.SuppressWarnings("all")
527  public Page.PagePaymentOptions getPaymentOptions() {
528    return this.paymentOptions;
529  }
530
531  /**
532   * Payment options accepted by the Place. Applicable to restaurants and nightlife.
533   */
534  @java.lang.SuppressWarnings("all")
535  public void setPaymentOptions(final Page.PagePaymentOptions paymentOptions) {
536    this.paymentOptions = paymentOptions;
537  }
538
539  /**
540   * The Place's telephone number.
541   *
542   * @return The Place's telephone number.
543   */
544  @java.lang.SuppressWarnings("all")
545  public String getPhone() {
546    return this.phone;
547  }
548
549  /**
550   * The Place's telephone number.
551   */
552  @java.lang.SuppressWarnings("all")
553  public void setPhone(final String phone) {
554    this.phone = phone;
555  }
556
557  /**
558   * The pages's profile picture, if provided.
559   *
560   * To force Facebook to fill the <code>picture</code> field you have to fetch the page with the
561   * <code>fields=picture</code> parameter, otherwise the picture is <code>null</code>.
562   *
563   * @return the page's profile picture as ProfilePictureSource object
564   */
565  @Override
566  @java.lang.SuppressWarnings("all")
567  public ProfilePictureSource getPicture() {
568    return this.picture;
569  }
570
571  /**
572   * The pages's profile picture, if provided.
573   *
574   * To force Facebook to fill the <code>picture</code> field you have to fetch the page with the
575   * <code>fields=picture</code> parameter, otherwise the picture is <code>null</code>.
576   */
577  @java.lang.SuppressWarnings("all")
578  public void setPicture(final ProfilePictureSource picture) {
579    this.picture = picture;
580  }
581
582  /**
583   * Price range of the business.
584   *
585   * Applicable to Restaurants or Nightlife. Can be one of $ (0-10), $$ (10-30), $$$ (30-50), $$$$ (50+), or Unspecified
586   *
587   * @return Price range of the business.
588   */
589  @java.lang.SuppressWarnings("all")
590  public String getPriceRange() {
591    return this.priceRange;
592  }
593
594  /**
595   * Price range of the business.
596   *
597   * Applicable to Restaurants or Nightlife. Can be one of $ (0-10), $$ (10-30), $$$ (30-50), $$$$ (50+), or Unspecified
598   */
599  @java.lang.SuppressWarnings("all")
600  public void setPriceRange(final String priceRange) {
601    this.priceRange = priceRange;
602  }
603
604  /**
605   * Number of ratings for the Place
606   *
607   * @return Number of ratings for the Place
608   */
609  @java.lang.SuppressWarnings("all")
610  public Long getRatingCount() {
611    return this.ratingCount;
612  }
613
614  /**
615   * Number of ratings for the Place
616   */
617  @java.lang.SuppressWarnings("all")
618  public void setRatingCount(final Long ratingCount) {
619    this.ratingCount = ratingCount;
620  }
621
622  /**
623   * The services that the restaurant provides.
624   *
625   * @return The services that the restaurant provides.
626   */
627  @java.lang.SuppressWarnings("all")
628  public Page.PageRestaurantServices getRestaurantServices() {
629    return this.restaurantServices;
630  }
631
632  /**
633   * The services that the restaurant provides.
634   */
635  @java.lang.SuppressWarnings("all")
636  public void setRestaurantServices(final Page.PageRestaurantServices restaurantServices) {
637    this.restaurantServices = restaurantServices;
638  }
639
640  /**
641   * The restaurant's specialties.
642   *
643   * @return The restaurant's specialties.
644   */
645  @java.lang.SuppressWarnings("all")
646  public Page.PageRestaurantSpecialties getRestaurantSpecialties() {
647    return this.restaurantSpecialties;
648  }
649
650  /**
651   * The restaurant's specialties.
652   */
653  @java.lang.SuppressWarnings("all")
654  public void setRestaurantSpecialties(final Page.PageRestaurantSpecialties restaurantSpecialties) {
655    this.restaurantSpecialties = restaurantSpecialties;
656  }
657
658  /**
659   * The Place's complete postal address, on a single line.
660   *
661   * @return The Place's complete postal address, on a single line.
662   */
663  @java.lang.SuppressWarnings("all")
664  public String getSingleLineAddress() {
665    return this.singleLineAddress;
666  }
667
668  /**
669   * The Place's complete postal address, on a single line.
670   */
671  @java.lang.SuppressWarnings("all")
672  public void setSingleLineAddress(final String singleLineAddress) {
673    this.singleLineAddress = singleLineAddress;
674  }
675
676  /**
677   * The URL of the Place's website.
678   *
679   * @return The URL of the Place's website.
680   */
681  @java.lang.SuppressWarnings("all")
682  public String getWebsite() {
683    return this.website;
684  }
685
686  /**
687   * The URL of the Place's website.
688   */
689  @java.lang.SuppressWarnings("all")
690  public void setWebsite(final String website) {
691    this.website = website;
692  }
693
694  /**
695   * Photos for the Place.
696   *
697   * By default, this edge returns the profile photos for the Place. You can also use an optional type parameter with
698   * the value uploaded to get the photos uploaded by the Place.
699   */
700  @java.lang.SuppressWarnings("all")
701  public List<Photo> getPhotos() {
702    return this.photos;
703  }
704
705  /**
706   * Photos for the Place.
707   *
708   * By default, this edge returns the profile photos for the Place. You can also use an optional type parameter with
709   * the value uploaded to get the photos uploaded by the Place.
710   */
711  @java.lang.SuppressWarnings("all")
712  public void setPhotos(final List<Photo> photos) {
713    this.photos = photos;
714  }
715
716  /**
717   * The native component workflows for this Place.
718   *
719   * Workflows allow people to perform actions like requesting appointments, buying tickets, and ordering from
720   * restaurants on Facebook
721   */
722  @java.lang.SuppressWarnings("all")
723  public List<PagesPlatformComponentFlowServiceConfig> getWorkflows() {
724    return this.workflows;
725  }
726
727  /**
728   * The native component workflows for this Place.
729   *
730   * Workflows allow people to perform actions like requesting appointments, buying tickets, and ordering from
731   * restaurants on Facebook
732   */
733  @java.lang.SuppressWarnings("all")
734  public void setWorkflows(final List<PagesPlatformComponentFlowServiceConfig> workflows) {
735    this.workflows = workflows;
736  }
737}