public Places getPlacesForContacts(JinxConstants.PlaceTypeId placeTypeId, String placeId, String woeId,
                                     Integer threshold, JinxConstants.Contacts contacts,
                                     Date minimumUploadDate, Date maximumUploadDate,
                                     Date minimumTakenDate, Date maximumTakenDate) throws JinxException {
    JinxUtils.validateParams(placeTypeId);
    if (JinxUtils.isNullOrEmpty(placeId)) {
      JinxUtils.validateParams(woeId);
    }
    Map<String, String> params = new TreeMap<>();
    params.put("method", "flickr.places.placesForContacts");
    params.put("place_type_id", placeTypeId.getTypeId().toString());
    if (JinxUtils.isNullOrEmpty(placeId)) {
      params.put("woe_id", woeId);
    } else {
      params.put("place_id", placeId);
    }
    if (threshold != null) {
      params.put("threshold", threshold.toString());
    }
    if (contacts != null) {
      params.put("contacts", contacts.toString());
    }
    if (minimumUploadDate != null) {
      params.put("min_upload_date", JinxUtils.formatDateAsUnixTimestamp(minimumUploadDate));
    }
    if (maximumUploadDate != null) {
      params.put("max_upload_date", JinxUtils.formatDateAsUnixTimestamp(maximumUploadDate));
    }
    if (minimumTakenDate != null) {
      params.put("min_taken_date", JinxUtils.formatDateAsMySqlTimestamp(minimumTakenDate));
    }
    if (maximumTakenDate != null) {
      params.put("max_taken_date", JinxUtils.formatDateAsMySqlTimestamp(maximumTakenDate));
    }
    return jinx.flickrGet(params, Places.class);
  }
public Places getPlacesForContacts ( JinxConstants . PlaceTypeId placeTypeId , String placeId , String woeId , Integer threshold , JinxConstants . Contacts contacts , Date minimumUploadDate , Date maximumUploadDate , Date minimumTakenDate , Date maximumTakenDate ) throws JinxException { JinxUtils . validateParams ( placeTypeId ) ; if ( JinxUtils . isNullOrEmpty ( placeId ) ) { JinxUtils . validateParams ( woeId ) ; } Map < String , String > params = new TreeMap < > ( ) ; params . put ( "method" , "flickr.places.placesForContacts" ) ; params . put ( "place_type_id" , placeTypeId . getTypeId ( ) . toString ( ) ) ; if ( JinxUtils . isNullOrEmpty ( placeId ) ) { params . put ( "woe_id" , woeId ) ; } else { params . put ( "place_id" , placeId ) ; } if ( threshold != null ) { params . put ( "threshold" , threshold . toString ( ) ) ; } if ( contacts != null ) { params . put ( "contacts" , contacts . toString ( ) ) ; } if ( minimumUploadDate != null ) { params . put ( "min_upload_date" , JinxUtils . formatDateAsUnixTimestamp ( minimumUploadDate ) ) ; } if ( maximumUploadDate != null ) { params . put ( "max_upload_date" , JinxUtils . formatDateAsUnixTimestamp ( maximumUploadDate ) ) ; } if ( minimumTakenDate != null ) { params . put ( "min_taken_date" , JinxUtils . formatDateAsMySqlTimestamp ( minimumTakenDate ) ) ; } if ( maximumTakenDate != null ) { params . put ( "max_taken_date" , JinxUtils . formatDateAsMySqlTimestamp ( maximumTakenDate ) ) ; } return jinx . flickrGet ( params , Places . class ) ; }
Return a list of the top 100 unique places clustered by a given placetype for a user's contacts.

Authentication

This method requires authentication with 'read' permission.

@param placeTypeId       ID for a specific place type to cluster photos by. Required.
@param placeId           a Flickr Places identifier to use to filter photo clusters.
You must pass a placesId or woeId.
@param woeId             a Where on Earth identifier to use to filter photo clusters.
You must pass a placesId or woeId.
@param threshold         the minimum number of photos that a place type must have to be included.
If the number of photos is lowered then the parent place type for that
place will be used. Optional.
@param contacts          which contacts to search. Default is all. Optional.
@param minimumUploadDate Minimum upload date. Photos with an upload date greater than or
equal to this value will be returned. Optional.
@param maximumUploadDate Maximum upload date. Photos with an upload date less than or equal
to this value will be returned. Optional.
@param minimumTakenDate  Minimum taken date. Photos with an taken date greater than or equal to
this value will be returned. Optional.
The date should be in the form of a mysql datetime.
@param maximumTakenDate  Maximum taken date. Photos with an taken date less than or equal to
this value will be returned. Optional.
The date should be in the form of a mysql datetime.
@return places for users contacts.
@throws JinxException if required parameters are missing, or if there are any errors.
@see <a href="https://www.flickr.com/services/api/flickr.places.placesForContacts.html">flickr.places.placesForContacts</a>